From: Jelmer Vernooij Date: Mon, 18 Aug 2003 17:53:56 +0000 (+0000) Subject: Update SWAT documentation X-Git-Tag: initial-v3-0-unstable~7450 X-Git-Url: http://git.samba.org/samba.git/?p=tprouty%2Fsamba.git;a=commitdiff_plain;h=7156877ec88acea6726f2b48c5fb5eff9ef37fdc Update SWAT documentation --- diff --git a/swat/README b/swat/README deleted file mode 100644 index 588ecef769..0000000000 --- a/swat/README +++ /dev/null @@ -1,77 +0,0 @@ -This is a brief description of how to install and use the Samba Web -Administration Tool on your machine. - -Installation ------------- - -After you compile SWAT you need to run "make install" to install the -swat binary and the various help files and images. A default install -would put these in: - -/usr/local/samba/bin/swat -/usr/local/samba/swat/images/* -/usr/local/samba/swat/help/* - -Running via inetd ------------------ - -You then need to edit your /etc/inetd.conf and /etc/services to enable -SWAT to be launched via inetd. - -In /etc/services you need to add a line like this: - -swat 901/tcp - -the choice of port number isn't really important except that it should -be less than 1024 and not currently used (using a number above 1024 -presents an obscure security hole depending on the implementation -details of your inetd daemon). - -In /etc/inetd.conf you should add a line like this: - -swat stream tcp nowait.400 root /usr/local/samba/bin/swat swat - -One you have edited /etc/services and /etc/inetd.conf you need to send -a HUP signal to inetd. On many systems "killall -1 inetd" will do this -on others you will need to use "kill -1 PID" where PID is the process -ID of the inetd daemon. - - - -Launching ---------- - -To launch SWAT just run your favourite web browser and point it at -http://localhost:901/ - -Note that you can attach to SWAT from any IP connected machine but -connecting from a remote machine leaves your connection open to -password sniffing as passwords will be sent in the clear over the -wire. - -You should be prompted for a username/password when you connect. You -will need to provide the username "root" and the correct root -password. - -Running -------- - -Just follow your nose! If you can't work out how to use it then maybe -you should use "vi smb.conf" instead. - - -WARNINGS --------- - -SWAT will rewrite your smb.conf file. It will rearrange the entries -and delete all comments, include= and copy= options. If you have a -carefully crafted smb.conf then back it up or don't use SWAT! - - -Development ------------ - -Please join the samba-technical mailing list if you want to discuss -the development of SWAT. Note that this list is for technical developer -discussions and is not a general help list. - diff --git a/swat/help/welcome.html b/swat/help/welcome.html index b3e9a81766..f230cf2842 100644 --- a/swat/help/welcome.html +++ b/swat/help/welcome.html @@ -22,9 +22,9 @@ Please choose a configuration action using one of the above buttons
  • smbcontrol - send control messages to Samba daemons
  • smbpasswd - managing SMB passwords
  • SWAT - web configuration tool -
  • make_smbcodepage - codepage creation -
  • make_unicodemap - unicode map file creation -
  • smbrun - internal smbd utility +
  • net - tool for administration of Samba and remote CIFS servers +
  • pdbedit - Samba user account management tool +
  • tdbbackup - Tool for backing up TDB databases
  • Client Tools
  • Diagnostic Utilities +
  • Misc. Utilities +
  • Books