blob: 36ef19b17652a054fdb19b0bbd0416147e4ef8e6 (
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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
|
SSSSWWWWAAAATTTT((((8888)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00003333 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 2222000000002222)))) SSSSWWWWAAAATTTT((((8888))))
NNNNAAAAMMMMEEEE
swat - Samba Web Administration Tool
SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
sssswwwwaaaatttt [ ----ssss <<<<ssssmmmmbbbb ccccoooonnnnffffiiiigggg ffffiiiilllleeee>>>> ] [ ----aaaa ]
DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
This tool is part of the Samba suite.
sssswwwwaaaatttt allows a Samba administrator to configure the complex
_s_m_b._c_o_n_f(_5) file via a Web browser. In addition, a sssswwwwaaaatttt
configuration page has help links to all the configurable
options in the _s_m_b._c_o_n_f file allowing an administrator to
easily look up the effects of any change.
sssswwwwaaaatttt is run from iiiinnnneeeettttdddd
OOOOPPPPTTTTIIIIOOOONNNNSSSS
----ssss ssssmmmmbbbb ccccoooonnnnffffiiiigggguuuurrrraaaattttiiiioooonnnn ffffiiiilllleeee
The default configuration file path is determined at
compile time. The file specified contains the
configuration details required by the ssssmmmmbbbbdddd server. This
is the file that sssswwwwaaaatttt will modify. The information in
this file includes server-specific information such as
what printcap file to use, as well as descriptions of
all the services that the server is to provide. See
_s_m_b._c_o_n_f for more information.
----aaaa This option disables authentication and puts sssswwwwaaaatttt in
demo mode. In that mode anyone will be able to modify
the _s_m_b._c_o_n_f file.
DDDDoooo NNNNOOOOTTTT eeeennnnaaaabbbblllleeee tttthhhhiiiissss ooooppppttttiiiioooonnnn oooonnnn aaaa pppprrrroooodddduuuuccccttttiiiioooonnnn sssseeeerrrrvvvveeeerrrr....
IIIINNNNSSSSTTTTAAAALLLLLLLLAAAATTTTIIIIOOOONNNN
After you compile SWAT you need to run mmmmaaaakkkkeeee iiiinnnnssssttttaaaallllllll to
install the sssswwwwaaaatttt binary and the various help files and
images. A default install would put these in:
o+ /usr/local/samba/bin/swat
o+ /usr/local/samba/swat/images/*
o+ /usr/local/samba/swat/help/*
IIIINNNNEEEETTTTDDDD IIIINNNNSSSSTTTTAAAALLLLLLLLAAAATTTTIIIIOOOONNNN
You need to edit your /_e_t_c/_i_n_e_t_d._c_o_n_f and /_e_t_c/_s_e_r_v_i_c_e_s to
enable SWAT to be launched via iiiinnnneeeettttdddd.
In /_e_t_c/_s_e_r_v_i_c_e_s you need to add a line like this:
sssswwwwaaaatttt 999900001111////ttttccccpppp
Page 1 (printed 1/7/103)
SSSSWWWWAAAATTTT((((8888)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00003333 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 2222000000002222)))) SSSSWWWWAAAATTTT((((8888))))
Note for NIS/YP users - you may need to rebuild the NIS
service maps rather than alter your local /_e_t_c/_s_e_r_v_i_c_e_s
file.
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 iiiinnnneeeettttdddd
daemon).
In /_e_t_c/_i_n_e_t_d._c_o_n_f you should add a line like this:
sssswwwwaaaatttt ssssttttrrrreeeeaaaammmm ttttccccpppp nnnnoooowwwwaaaaiiiitttt....444400000000 rrrrooooooootttt ////uuuussssrrrr////llllooooccccaaaallll////ssssaaaammmmbbbbaaaa////bbbbiiiinnnn////sssswwwwaaaatttt
sssswwwwaaaatttt
One you have edited /_e_t_c/_s_e_r_v_i_c_e_s and /_e_t_c/_i_n_e_t_d._c_o_n_f you
need to send a HUP signal to inetd. To do this use kkkkiiiillllllll ----1111
PPPPIIIIDDDD where PID is the process ID of the inetd daemon.
XXXXIIIINNNNEEEETTTTDDDD IIIINNNNSSSSTTTTAAAALLLLLLLLAAAATTTTIIIIOOOONNNN
Newer Linux systems ship with a more secure implementation
of the inetd meta-daemon. The xxxxiiiinnnneeeettttdddd daemon can read
configuration inf9ormation from a single file (i.e.
/_e_t_c/_x_i_n_e_t_d._c_o_n_f) or from a collection of service control
files in the _x_i_n_e_t_d._d/ directory. These directions assume
the latter configuration.
The following file should be created as /_e_t_c/_x_i_e_n_t_d._d/_s_w_a_t.
It is then be neccessary cause the meta-daemon to reload its
configuration files. Refer to the xinetd man page for
details on how to accomplish this.
## /etc/xinetd.d/swat
service swat
{
port = 901
socket_type = stream
wait = no
only_from = localhost
user = root
server = /usr/local/samba/bin/swat
log_on_failure += USERID
disable = No
}
LLLLAAAAUUUUNNNNCCCCHHHHIIIINNNNGGGG
To launch SWAT just run your favorite 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
Page 2 (printed 1/7/103)
SSSSWWWWAAAATTTT((((8888)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00003333 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 2222000000002222)))) SSSSWWWWAAAATTTT((((8888))))
connection open to password sniffing as passwords will be
sent in the clear over the wire.
TTTTRRRROOOOUUUUBBBBLLLLEEEESSSSHHHHOOOOOOOOTTTTIIIINNNNGGGG
One of the common causes of difficulty when installing Samba
and SWAT is the existsnece of some type of firewall or port
filtering software on the Samba server. Make sure that the
appropriate ports outlined in this man page are available on
the server and are not currently being blocked by some type
of security software such as iptables or "port sentry". For
more troubleshooting information, refer to the additional
documentation included in the Samba distribution.
FFFFIIIILLLLEEEESSSS
/_e_t_c/_i_n_e_t_d._c_o_n_f
This file must contain suitable startup information for
the meta-daemon.
/_e_t_c/_x_i_n_e_t_d._d/_s_w_a_t
This file must contain suitable startup information for
the xxxxiiiinnnneeeettttdddd meta-daemon.
/_e_t_c/_s_e_r_v_i_c_e_s
This file must contain a mapping of service name (e.g.,
swat) to service port (e.g., 901) and protocol type
(e.g., tcp).
/_u_s_r/_l_o_c_a_l/_s_a_m_b_a/_l_i_b/_s_m_b._c_o_n_f
This is the default location of the _s_m_b._c_o_n_f(_5) server
configuration file that swat edits. Other common places
that systems install this file are
/_u_s_r/_s_a_m_b_a/_l_i_b/_s_m_b._c_o_n_f and /_e_t_c/_s_m_b._c_o_n_f . This file
describes all the services the server is to make
available to clients.
WWWWAAAARRRRNNNNIIIINNNNGGGGSSSS
sssswwwwaaaatttt will rewrite your _s_m_b._c_o_n_f file. It will rearrange the
entries and delete all comments, _i_n_c_l_u_d_e= and _c_o_p_y="
options. If you have a carefully crafted _s_m_b._c_o_n_f then back
it up or don't use swat!
VVVVEEEERRRRSSSSIIIIOOOONNNN
This man page is correct for version 2.2 of the Samba suite.
SSSSEEEEEEEE AAAALLLLSSSSOOOO
iiiinnnneeeettttdddd((((5555)))), ssssmmmmbbbbdddd((((8888)))) smb.conf(5) xxxxiiiinnnneeeettttdddd((((8888))))
AAAAUUUUTTTTHHHHOOOORRRR
The original Samba software and related utilities were
created by Andrew Tridgell. Samba is now developed by the
Samba Team as an Open Source project similar to the way the
Linux kernel is developed.
Page 3 (printed 1/7/103)
SSSSWWWWAAAATTTT((((8888)))) UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV ((((00003333 SSSSeeeepppptttteeeemmmmbbbbeeeerrrr 2222000000002222)))) SSSSWWWWAAAATTTT((((8888))))
The original Samba man pages were written by Karl Auer. The
man page sources were converted to YODL format (another
excellent piece of Open Source software, available at
ftp://ftp.icce.rug.nl/pub/unix/
<URL:ftp://ftp.icce.rug.nl/pub/unix/>) and updated for the
Samba 2.0 release by Jeremy Allison. The conversion to
DocBook for Samba 2.2 was done by Gerald Carter
Page 4 (printed 1/7/103)
|