= How to enable SWAT as a Apache CGI =

This page provides a quick cookbook to setup SWAT as a CGI for Apache on eComstation & OS/2.

== Prerequsites: ==

 1. Make sure you have downloaded Apache2 and unziped.

 2. We assume Apache2 was unzipped to x:\apache2 and samba was installed to x:\samba.

 3. Copy x:\apache2\conf\httpd.conf.sample to x:\apache2\conf\httpd.conf

 4. Edit x:\apache2\conf\httpd.conf

    {{{ServerRoot "x:/apache2"}}} [[BR]]
    # remove the # infront of the below modules[[BR]]
    {{{Loadmodule authn_file_module modules/authn_fi.dll}}}[[BR]]
    {{{LoadModule auth_basic_module modules/auth_bas.dll}}}[[BR]]
    {{{DocumentRoot "x:/apache2/htdocs"}}}

    # This should be changed to whatever you set {{{DocumentRoot}}} to.[[BR]]
    {{{<Directory "x:/apache2/htdocs">}}}
    
    {{{Alias /swat/ "x:/samba/swat/"}}}[[BR]]
    {{{ScriptAlias /cgi-bin/samba/ "x:/samba/"}}}[[BR]]
    {{{ScriptAlias /cgi-bin/ "x:/apache2/cgi-bin/"}}}    

    {{{PassEnv UNIXROOT}}}[[BR]]
    {{{PassEnv ETC}}}[[BR]]
    {{{PassEnv PATH}}}[[BR]]
    {{{PassEnv TMPDIR}}}

    {{{<Directory "x:/samba">}}}[[BR]]
    {{{AllowOverride All}}}[[BR]]
    {{{Options None}}}[[BR]]
    {{{Order allow,deny}}}[[BR]]
    {{{Allow from all}}}[[BR]]
    {{{AuthName "Samba Web Admin Tool"}}}[[BR]]
    {{{AuthType Basic}}}[[BR]]
    {{{AuthUserFile x:/apache2/conf/users}}}[[BR]]
    {{{require valid-user}}}[[BR]]
    {{{</Directory>}}}[[BR]]

 5. Adjust startup.cmd in x:\apache2 with set beginlibpath=x:\apache2\bin;x:\apache2\modules 

 6. create user with: x:/apache2/bin/htpasswd -c x:/apache2/conf/users my_user_name

 7. Start startup.cmd (if all went well Apache starts)

== Using SWAT: ==

 1. To use SWAT also to start/stop Samba Server, Samba Server should have been installed with the WPI. Otherwise swathelp.cmd and smb.cmd are missing

 2. Open the Browser and point it to 127.0.0.1/cgi-bin/samba/swat.exe

 3. Now you should see the SWAT interface to configure Samba server