blob: 657a5937d71d1d9d9bf18dac27c107dc74ca818a (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
|
This is a brief description of how to install and use the Samba Web
Administration Tool on your machine.
Installation
------------
After compiling Samba (via a "make"), running "make install" will
install the swat binary and the various help files and images for
you. 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!
There is also a short HOWTO for configuring secure, remote access
to SWAT (swat does not natively support HTTPS) at your favorite
samba.org mirror (see http://samba.org for a list) at
/samba/docs/swat_ssl.html
Development
-----------
Please join the samba-technical@samba.org (http://lists.samba.org/listinfo/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.
|
