~lefteris-nikoltsios/+junk/samba-lp1016895

« back to all changes in this revision

Viewing changes to docs/htmldocs/Samba3-HOWTO/SWAT.html

  • Committer: Package Import Robot
  • Author(s): Chuck Short
  • Date: 2011-12-21 13:18:04 UTC
  • mfrom: (0.39.21 sid)
  • Revision ID: package-import@ubuntu.com-20111221131804-xtlr39wx6njehxxr
Tags: 2:3.6.1-3ubuntu1
* Merge from Debian testing.  Remaining changes:
  + debian/patches/VERSION.patch:
    - set SAMBA_VERSION_SUFFIX to Ubuntu.
  + debian/patches/error-trans.fix-276472:
    - Add the translation of Unix Error code -ENOTSUP to NT Error Code
    - NT_STATUS_NOT_SUPPORTED to prevent the Permission denied error.
  + debian/smb.conf:
    - add "(Samba, Ubuntu)" to server string.
    - comment out the default [homes] share, and add a comment about
      "valid users = %S" to show users how to restrict access to
      \\server\username to only username.
    - Set 'usershare allow guests', so that usershare admins are 
      allowed to create public shares in addition to authenticated
      ones.
    - add map to guest = Bad user, maps bad username to guest access.
  + debian/samba-common.config:
    - Do not change priority to high if dhclient3 is installed.
    - Use priority medium instead of high for the workgroup question.
  + debian/control:
    - Don't build against or suggest ctdb.
    - Add dependency on samba-common-bin to samba.
  + Add ufw integration:
    - Created debian/samba.ufw.profile
    - debian/rules, debian/samba.dirs, debian/samba.files: install
      profile
    - debian/control: have samba suggest ufw
  + Add apport hook:
    - Created debian/source_samba.py.
    - debian/rules, debian/samba.dirs, debian/samba-common-bin.files: install
  + Switch to upstart:
    - Add debian/samba.{nmbd,smbd}.upstart.
  + debian/samba.logrotate, debian/samba-common.dhcp, debian/samba.if-up:
    - Make them upstart compatible
  + debian/samba.postinst: 
    - Avoid scary pdbedit warnings on first import.
  + debian/samba-common.postinst: Add more informative error message for
    the case where smb.conf was manually deleted
  + debian/patches/fix-debuglevel-name-conflict.patch: don't use 'debug_level'
    as a global variable name in an NSS module 
  + Dropped:
    - debian/patches/error-trans.fix-276472
    - debian/patches/fix-debuglevel-name-conflict.patch

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter�37.�SWAT: The Samba Web Administration Tool</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="The Official Samba 3.5.x HOWTO and Reference Guide"><link rel="up" href="migration.html" title="Part�IV.�Migration and Updating"><link rel="prev" href="NT4Migration.html" title="Chapter�36.�Migration from NT4 PDC to Samba-3 PDC"><link rel="next" href="troubleshooting.html" title="Part�V.�Troubleshooting"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter�37.�SWAT: The Samba Web Administration Tool</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="NT4Migration.html">Prev</a>�</td><th width="60%" align="center">Part�IV.�Migration and Updating</th><td width="20%" align="right">�<a accesskey="n" href="troubleshooting.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter�37.�SWAT: The Samba Web Administration Tool"><div class="titlepage"><div><div><h2 class="title"><a name="SWAT"></a>Chapter�37.�SWAT: The Samba Web Administration Tool</h2></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>&gt;</code></p></div></div></div></div><div><p class="pubdate">April 21, 2003</p></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="SWAT.html#id443276">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="SWAT.html#id443388">Guidelines and Technical Tips</a></span></dt><dd><dl><dt><span class="sect2"><a href="SWAT.html#id443406">Validate SWAT Installation</a></span></dt><dt><span class="sect2"><a href="SWAT.html#xinetd">Enabling SWAT for Use</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id443979">Securing SWAT through SSL</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444125">Enabling SWAT Internationalization Support</a></span></dt></dl></dd><dt><span class="sect1"><a href="SWAT.html#id444311">Overview and Quick Tour</a></span></dt><dd><dl><dt><span class="sect2"><a href="SWAT.html#id444322">The SWAT Home Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444375">Global Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444471">Share Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444523">Printers Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444575">The SWAT Wizard</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444631">The Status Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444670">The View Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444687">The Password Change Page</a></span></dt></dl></dd></dl></div><p>
2
 
<a class="indexterm" name="id443244"></a>
3
 
<a class="indexterm" name="id443251"></a>
4
 
<a class="indexterm" name="id443258"></a>
 
1
<html><head><meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"><title>Chapter�37.�SWAT: The Samba Web Administration Tool</title><link rel="stylesheet" href="../samba.css" type="text/css"><meta name="generator" content="DocBook XSL Stylesheets V1.75.2"><link rel="home" href="index.html" title="The Official Samba 3.5.x HOWTO and Reference Guide"><link rel="up" href="migration.html" title="Part�IV.�Migration and Updating"><link rel="prev" href="NT4Migration.html" title="Chapter�36.�Migration from NT4 PDC to Samba-3 PDC"><link rel="next" href="troubleshooting.html" title="Part�V.�Troubleshooting"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center">Chapter�37.�SWAT: The Samba Web Administration Tool</th></tr><tr><td width="20%" align="left"><a accesskey="p" href="NT4Migration.html">Prev</a>�</td><th width="60%" align="center">Part�IV.�Migration and Updating</th><td width="20%" align="right">�<a accesskey="n" href="troubleshooting.html">Next</a></td></tr></table><hr></div><div class="chapter" title="Chapter�37.�SWAT: The Samba Web Administration Tool"><div class="titlepage"><div><div><h2 class="title"><a name="SWAT"></a>Chapter�37.�SWAT: The Samba Web Administration Tool</h2></div><div><div class="author"><h3 class="author"><span class="firstname">John</span> <span class="othername">H.</span> <span class="surname">Terpstra</span></h3><div class="affiliation"><span class="orgname">Samba Team<br></span><div class="address"><p><code class="email">&lt;<a class="email" href="mailto:jht@samba.org">jht@samba.org</a>&gt;</code></p></div></div></div></div><div><p class="pubdate">April 21, 2003</p></div></div></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="sect1"><a href="SWAT.html#id443273">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="SWAT.html#id443386">Guidelines and Technical Tips</a></span></dt><dd><dl><dt><span class="sect2"><a href="SWAT.html#id443404">Validate SWAT Installation</a></span></dt><dt><span class="sect2"><a href="SWAT.html#xinetd">Enabling SWAT for Use</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id443982">Securing SWAT through SSL</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444127">Enabling SWAT Internationalization Support</a></span></dt></dl></dd><dt><span class="sect1"><a href="SWAT.html#id444313">Overview and Quick Tour</a></span></dt><dd><dl><dt><span class="sect2"><a href="SWAT.html#id444324">The SWAT Home Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444377">Global Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444473">Share Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444525">Printers Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444577">The SWAT Wizard</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444633">The Status Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444672">The View Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id444690">The Password Change Page</a></span></dt></dl></dd></dl></div><p>
 
2
<a class="indexterm" name="id443242"></a>
 
3
<a class="indexterm" name="id443249"></a>
 
4
<a class="indexterm" name="id443255"></a>
5
5
There are many and varied opinions regarding the usefulness of SWAT.  No matter how hard one tries to produce
6
6
the perfect configuration tool, it remains an object of personal taste. SWAT is a tool that allows Web-based
7
7
configuration of Samba. It has a wizard that may help to get Samba configured quickly, it has
8
8
context-sensitive help on each <code class="filename">smb.conf</code> parameter, it provides for monitoring of current state of connection
9
9
information, and it allows networkwide MS Windows network password management.
10
 
</p><div class="sect1" title="Features and Benefits"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id443276"></a>Features and Benefits</h2></div></div></div><p>
11
 
<a class="indexterm" name="id443283"></a>
 
10
</p><div class="sect1" title="Features and Benefits"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id443273"></a>Features and Benefits</h2></div></div></div><p>
 
11
<a class="indexterm" name="id443281"></a>
12
12
SWAT is a facility that is part of the Samba suite. The main executable is called
13
13
<code class="literal">swat</code> and is invoked by the internetworking super daemon.
14
14
See <a class="link" href="SWAT.html#xinetd" title="Enabling SWAT for Use">appropriate section</a> for details.
15
15
</p><p>
16
 
<a class="indexterm" name="id443309"></a>
 
16
<a class="indexterm" name="id443307"></a>
17
17
SWAT uses integral Samba components to locate parameters supported by the particular
18
18
version of Samba. Unlike tools and utilities that are external to Samba, SWAT is always
19
19
up to date as known Samba parameters change. SWAT provides context-sensitive help for each
20
20
configuration parameter, directly from <code class="literal">man</code> page entries.
21
21
</p><p>
22
 
<a class="indexterm" name="id443328"></a>
23
 
<a class="indexterm" name="id443334"></a>
24
 
<a class="indexterm" name="id443341"></a>
 
22
<a class="indexterm" name="id443325"></a>
 
23
<a class="indexterm" name="id443332"></a>
 
24
<a class="indexterm" name="id443339"></a>
25
25
Some network administrators believe that it is a good idea to write systems
26
26
documentation inside configuration files, and for them SWAT will always be a nasty tool. SWAT
27
27
does not store the configuration file in any intermediate form; rather, it stores only the
30
30
as well as parameters that are no longer supported, will be lost from the <code class="filename">smb.conf</code> file.
31
31
Additionally, the parameters will be written back in internal ordering.
32
32
</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
33
 
<a class="indexterm" name="id443369"></a>
 
33
<a class="indexterm" name="id443367"></a>
34
34
Before using SWAT, please be warned  SWAT will completely replace your <code class="filename">smb.conf</code> with
35
35
a fully optimized file that has been stripped of all comments you might have placed there
36
36
and only nondefault settings will be written to the file.
37
 
</p></div></div><div class="sect1" title="Guidelines and Technical Tips"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id443388"></a>Guidelines and Technical Tips</h2></div></div></div><p>
38
 
<a class="indexterm" name="id443396"></a>
 
37
</p></div></div><div class="sect1" title="Guidelines and Technical Tips"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id443386"></a>Guidelines and Technical Tips</h2></div></div></div><p>
 
38
<a class="indexterm" name="id443394"></a>
39
39
This section aims to unlock the dark secrets behind how SWAT may be made to work,
40
40
how it can be made more secure, and how to solve internationalization support problems.
41
 
</p><div class="sect2" title="Validate SWAT Installation"><div class="titlepage"><div><div><h3 class="title"><a name="id443406"></a>Validate SWAT Installation</h3></div></div></div><p>
42
 
<a class="indexterm" name="id443414"></a>
 
41
</p><div class="sect2" title="Validate SWAT Installation"><div class="titlepage"><div><div><h3 class="title"><a name="id443404"></a>Validate SWAT Installation</h3></div></div></div><p>
 
42
<a class="indexterm" name="id443411"></a>
43
43
The very first step that should be taken before attempting to configure a host
44
44
system for SWAT operation is to check that it is installed. This may seem a trivial
45
45
point to some, but several Linux distributions do not install SWAT by default,
46
46
even though they do ship an installable binary support package containing SWAT
47
47
on the distribution media.
48
48
</p><p>
49
 
<a class="indexterm" name="id443427"></a>
 
49
<a class="indexterm" name="id443424"></a>
50
50
When you have confirmed that SWAT is installed, it is necessary to validate
51
51
that the installation includes the binary <code class="literal">swat</code> file as well
52
52
as all the supporting text and Web files. A number of operating system distributions
53
53
in the past have failed to include the necessary support files, even though the
54
54
<code class="literal">swat</code> binary executable file was installed. 
55
55
</p><p>
56
 
<a class="indexterm" name="id443451"></a>
57
 
<a class="indexterm" name="id443458"></a>
 
56
<a class="indexterm" name="id443449"></a>
 
57
<a class="indexterm" name="id443456"></a>
58
58
Finally, when you are sure that SWAT has been fully installed, please check that SWAT
59
59
is enabled in the control file for the internetworking super-daemon (inetd or xinetd)
60
60
that is used on your operating system platform. 
61
 
</p><div class="sect3" title="Locating the SWAT File"><div class="titlepage"><div><div><h4 class="title"><a name="id443468"></a>Locating the <code class="literal">SWAT</code> File</h4></div></div></div><p>
62
 
<a class="indexterm" name="id443482"></a>
63
 
<a class="indexterm" name="id443488"></a>
64
 
<a class="indexterm" name="id443495"></a>
 
61
</p><div class="sect3" title="Locating the SWAT File"><div class="titlepage"><div><div><h4 class="title"><a name="id443466"></a>Locating the <code class="literal">SWAT</code> File</h4></div></div></div><p>
 
62
<a class="indexterm" name="id443480"></a>
 
63
<a class="indexterm" name="id443486"></a>
 
64
<a class="indexterm" name="id443493"></a>
65
65
To validate that SWAT is installed, first locate the <code class="literal">swat</code> binary
66
66
file on the system. It may be found under the following directories:</p><table border="0" summary="Simple list" class="simplelist"><tr><td><code class="filename">/usr/local/samba/bin</code>  the default Samba location</td></tr><tr><td><code class="filename">/usr/sbin</code>  the default location on most Linux systems</td></tr><tr><td><code class="filename">/opt/samba/bin</code></td></tr></table><p>
67
67
</p><p>
71
71
There are a number of methods that may be used to locate the <code class="literal">swat</code> binary file.
72
72
The following methods may be helpful.
73
73
</p><p>
74
 
<a class="indexterm" name="id443563"></a>
75
 
<a class="indexterm" name="id443570"></a>
76
 
<a class="indexterm" name="id443577"></a>
 
74
<a class="indexterm" name="id443561"></a>
 
75
<a class="indexterm" name="id443568"></a>
 
76
<a class="indexterm" name="id443575"></a>
77
77
If <code class="literal">swat</code> is in your current operating system search path, it will be easy to 
78
78
find it. You can ask what are the command-line options for <code class="literal">swat</code> as shown here:
79
79
</p><pre class="screen">
91
91
  -l, --log-basename=LOGFILEBASE       Basename for log/debug files
92
92
  -V, --version                        Print version
93
93
</pre><p>
94
 
</p></div><div class="sect3" title="Locating the SWAT Support Files"><div class="titlepage"><div><div><h4 class="title"><a name="id443609"></a>Locating the SWAT Support Files</h4></div></div></div><p>
 
94
</p></div><div class="sect3" title="Locating the SWAT Support Files"><div class="titlepage"><div><div><h4 class="title"><a name="id443611"></a>Locating the SWAT Support Files</h4></div></div></div><p>
95
95
Now that you have found that <code class="literal">swat</code> is in the search path, it is easy
96
96
to identify where the file is located. Here is another simple way this may be done:
97
97
</p><pre class="screen">
173
173
or in a similar location.
174
174
</p><p>
175
175
The control entry for the older style file might be:
176
 
<a class="indexterm" name="id443771"></a>
 
176
<a class="indexterm" name="id443773"></a>
177
177
</p><pre class="programlisting">
178
178
        # swat is the Samba Web Administration Tool
179
179
        swat stream tcp nowait.400 root /usr/sbin/swat swat
201
201
This means that SWAT is disabled. To enable use of SWAT, set this parameter to <code class="constant">no</code>
202
202
as shown.
203
203
</p><p>
204
 
<a class="indexterm" name="id443820"></a>
205
 
<a class="indexterm" name="id443827"></a>
206
 
<a class="indexterm" name="id443834"></a>
207
 
<a class="indexterm" name="id443841"></a>
 
204
<a class="indexterm" name="id443823"></a>
 
205
<a class="indexterm" name="id443830"></a>
 
206
<a class="indexterm" name="id443836"></a>
 
207
<a class="indexterm" name="id443843"></a>
208
208
Both of the previous examples assume that the <code class="literal">swat</code> binary has been
209
209
located in the <code class="filename">/usr/sbin</code> directory. In addition to the above,
210
210
SWAT will use a directory access point from which it will load its Help files
212
212
systems is in the directory <code class="filename">/usr/share/samba/swat</code>. The default
213
213
location using Samba defaults will be <code class="filename">/usr/local/samba/swat</code>.
214
214
</p><p>
215
 
<a class="indexterm" name="id443877"></a>
216
 
<a class="indexterm" name="id443884"></a>
 
215
<a class="indexterm" name="id443880"></a>
 
216
<a class="indexterm" name="id443886"></a>
217
217
Access to SWAT will prompt for a logon. If you log onto SWAT as any non-root user,
218
218
the only permission allowed is to view certain aspects of configuration as well as
219
219
access to the password change facility. The buttons that will be exposed to the non-root
225
225
full change and commit ability. The buttons that will be exposed include
226
226
<span class="guibutton">HOME</span>, <span class="guibutton">GLOBALS</span>, <span class="guibutton">SHARES</span>, <span class="guibutton">PRINTERS</span>, 
227
227
<span class="guibutton">WIZARD</span>, <span class="guibutton">STATUS</span>, <span class="guibutton">VIEW</span>, and <span class="guibutton">PASSWORD</span>.
228
 
</p></div><div class="sect2" title="Securing SWAT through SSL"><div class="titlepage"><div><div><h3 class="title"><a name="id443979"></a>Securing SWAT through SSL</h3></div></div></div><p>
229
 
<a class="indexterm" name="id443987"></a>
230
 
<a class="indexterm" name="id443994"></a>
 
228
</p></div><div class="sect2" title="Securing SWAT through SSL"><div class="titlepage"><div><div><h3 class="title"><a name="id443982"></a>Securing SWAT through SSL</h3></div></div></div><p>
 
229
<a class="indexterm" name="id443990"></a>
 
230
<a class="indexterm" name="id443996"></a>
231
231
Many people have asked about how to set up SWAT with SSL to allow for secure remote
232
232
administration of Samba. Here is a method that works, courtesy of Markus Krieger.
233
233
</p><p>
234
234
Modifications to the SWAT setup are as follows: 
235
235
</p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p>
236
 
<a class="indexterm" name="id444017"></a>
 
236
<a class="indexterm" name="id444020"></a>
237
237
        Install OpenSSL.
238
238
        </p></li><li class="step" title="Step 2"><p>
239
 
<a class="indexterm" name="id444031"></a>
240
 
<a class="indexterm" name="id444038"></a>
 
239
<a class="indexterm" name="id444033"></a>
 
240
<a class="indexterm" name="id444040"></a>
241
241
        Generate certificate and private key.
242
 
<a class="indexterm" name="id444045"></a>
 
242
<a class="indexterm" name="id444047"></a>
243
243
</p><pre class="screen">
244
244
<code class="prompt">root# </code><strong class="userinput"><code>/usr/bin/openssl req -new -x509 -days 365 -nodes -config \
245
245
        /usr/share/doc/packages/stunnel/stunnel.cnf \
247
247
</pre></li><li class="step" title="Step 3"><p>
248
248
        Remove SWAT entry from [x]inetd.
249
249
        </p></li><li class="step" title="Step 4"><p>
250
 
<a class="indexterm" name="id444081"></a>
 
250
<a class="indexterm" name="id444084"></a>
251
251
        Start <code class="literal">stunnel</code>.
252
252
 
253
253
</p><pre class="screen">
255
255
         -l /usr/local/samba/bin/swat swat </code></strong>
256
256
</pre></li></ol></div><p>
257
257
Afterward, simply connect to SWAT by using the URL <a class="ulink" href="https://myhost:901" target="_top">https://myhost:901</a>, accept the certificate, and the SSL connection is up.
258
 
</p></div><div class="sect2" title="Enabling SWAT Internationalization Support"><div class="titlepage"><div><div><h3 class="title"><a name="id444125"></a>Enabling SWAT Internationalization Support</h3></div></div></div><p>
 
258
</p></div><div class="sect2" title="Enabling SWAT Internationalization Support"><div class="titlepage"><div><div><h3 class="title"><a name="id444127"></a>Enabling SWAT Internationalization Support</h3></div></div></div><p>
259
259
SWAT can be configured to display its messages to match the settings of
260
260
the language configurations of your Web browser. It will be passed to SWAT 
261
261
in the Accept-Language header of the HTTP request.
267
267
        </p></li><li class="listitem"><p>
268
268
        Set your browsers language setting.
269
269
        </p></li></ul></div><p>
270
 
<a class="indexterm" name="id444166"></a>
271
 
<a class="indexterm" name="id444172"></a>
272
 
<a class="indexterm" name="id444179"></a>
273
 
<a class="indexterm" name="id444186"></a>
 
270
<a class="indexterm" name="id444168"></a>
 
271
<a class="indexterm" name="id444175"></a>
 
272
<a class="indexterm" name="id444182"></a>
 
273
<a class="indexterm" name="id444188"></a>
274
274
The name of the <code class="literal">msg</code> file is the same as the language ID sent by the browser. For
275
275
example, <span class="emphasis"><em>en</em></span> means English, <span class="emphasis"><em>ja</em></span> means Japanese, <span class="emphasis"><em>fr</em></span> means French.
276
276
</p><p>
277
 
<a class="indexterm" name="id444214"></a>
 
277
<a class="indexterm" name="id444216"></a>
278
278
If you do not like some of messages, or there are no <code class="literal">msg</code> files for
279
279
your locale, you can create them simply by copying the <code class="literal">en.msg</code> files
280
280
to the directory for <span class="quote">&#8220;<span class="quote">your language ID.msg</span>&#8221;</span> and filling in proper strings
284
284
msgid "Set Default"
285
285
msgstr "Imposta Default"
286
286
</pre><p>
287
 
<a class="indexterm" name="id444259"></a>
 
287
<a class="indexterm" name="id444261"></a>
288
288
and so on. If you find a mistake or create a new <code class="literal">msg</code> file, please email it
289
289
to us so we will consider it in the next release of Samba. The <code class="literal">msg</code> file should be encoded in UTF-8.
290
290
</p><p>
291
 
<a class="indexterm" name="id444281"></a>
 
291
<a class="indexterm" name="id444284"></a>
292
292
Note that if you enable this feature and the <a class="link" href="smb.conf.5.html#DISPLAYCHARSET" target="_top">display charset</a> is not
293
293
matched to your browser's setting, the SWAT display may be corrupted.  In a future version of
294
294
Samba, SWAT will always display messages with UTF-8 encoding. You will then not need to set
295
295
this <code class="filename">smb.conf</code> file parameter.
296
 
</p></div></div><div class="sect1" title="Overview and Quick Tour"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id444311"></a>Overview and Quick Tour</h2></div></div></div><p>
 
296
</p></div></div><div class="sect1" title="Overview and Quick Tour"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id444313"></a>Overview and Quick Tour</h2></div></div></div><p>
297
297
SWAT is a tool that may be used to configure Samba or just to obtain useful links
298
298
to important reference materials such as the contents of this book as well as other
299
299
documents that have been found useful for solving Windows networking problems.
300
 
</p><div class="sect2" title="The SWAT Home Page"><div class="titlepage"><div><div><h3 class="title"><a name="id444322"></a>The SWAT Home Page</h3></div></div></div><p>
 
300
</p><div class="sect2" title="The SWAT Home Page"><div class="titlepage"><div><div><h3 class="title"><a name="id444324"></a>The SWAT Home Page</h3></div></div></div><p>
301
301
The SWAT title page provides access to the latest Samba documentation. The manual page for
302
302
each Samba component is accessible from this page, as are the Samba3-HOWTO (this 
303
303
document) as well as the O'Reilly book <span class="quote">&#8220;<span class="quote">Using Samba.</span>&#8221;</span>
312
312
changes to <code class="filename">smb.conf</code> as well as general operation with root privileges. The option that
313
313
creates this ability is the <code class="option">-a</code> flag to SWAT. <span class="emphasis"><em>Do not use this in a
314
314
production environment.</em></span>
315
 
</p></div></div><div class="sect2" title="Global Settings"><div class="titlepage"><div><div><h3 class="title"><a name="id444375"></a>Global Settings</h3></div></div></div><p>
 
315
</p></div></div><div class="sect2" title="Global Settings"><div class="titlepage"><div><div><h3 class="title"><a name="id444377"></a>Global Settings</h3></div></div></div><p>
316
316
The <span class="guibutton">GLOBALS</span> button exposes a page that allows configuration of the global parameters
317
317
in <code class="filename">smb.conf</code>. There are two levels of exposure of the parameters:
318
318
</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
332
332
SWAT has context-sensitive help. To find out what each parameter is
333
333
for, simply click on the
334
334
<span class="guibutton">Help</span> link to the left of the configuration parameter.
335
 
</p></div></div><div class="sect2" title="Share Settings"><div class="titlepage"><div><div><h3 class="title"><a name="id444471"></a>Share Settings</h3></div></div></div><p>
 
335
</p></div></div><div class="sect2" title="Share Settings"><div class="titlepage"><div><div><h3 class="title"><a name="id444473"></a>Share Settings</h3></div></div></div><p>
336
336
To affect a currently configured share, simply click on the pull-down button between the
337
337
<span class="guibutton">Choose Share</span> and the <span class="guibutton">Delete Share</span> buttons and
338
338
select the share you wish to operate on. To edit the settings,
343
343
To create a new share, next to the button labeled <span class="guibutton">Create Share</span>, enter
344
344
into the text field the name of the share to be created, then click on the 
345
345
<span class="guibutton">Create Share</span> button.
346
 
</p></div><div class="sect2" title="Printers Settings"><div class="titlepage"><div><div><h3 class="title"><a name="id444523"></a>Printers Settings</h3></div></div></div><p>
 
346
</p></div><div class="sect2" title="Printers Settings"><div class="titlepage"><div><div><h3 class="title"><a name="id444525"></a>Printers Settings</h3></div></div></div><p>
347
347
To affect a currently configured printer, simply click on the pull-down button between the
348
348
<span class="guibutton">Choose Printer</span> and the <span class="guibutton">Delete Printer</span> buttons and
349
349
select the printer you wish to operate on. To edit the settings,
354
354
To create a new printer, next to the button labeled <span class="guibutton">Create Printer</span>, enter
355
355
into the text field the name of the share to be created, then click on the 
356
356
<span class="guibutton">Create Printer</span> button.
357
 
</p></div><div class="sect2" title="The SWAT Wizard"><div class="titlepage"><div><div><h3 class="title"><a name="id444575"></a>The SWAT Wizard</h3></div></div></div><p>
 
357
</p></div><div class="sect2" title="The SWAT Wizard"><div class="titlepage"><div><div><h3 class="title"><a name="id444577"></a>The SWAT Wizard</h3></div></div></div><p>
358
358
The purpose of the SWAT Wizard is to help the Microsoft-knowledgeable network administrator
359
359
to configure Samba with a minimum of effort.
360
360
</p><p>
370
370
will be configured for, whether it will be a WINS server, participate as a WINS client, or
371
371
operate with no WINS support. By clicking one button, you can elect to expose (or not) user
372
372
home directories.
373
 
</p></div><div class="sect2" title="The Status Page"><div class="titlepage"><div><div><h3 class="title"><a name="id444631"></a>The Status Page</h3></div></div></div><p>
 
373
</p></div><div class="sect2" title="The Status Page"><div class="titlepage"><div><div><h3 class="title"><a name="id444633"></a>The Status Page</h3></div></div></div><p>
374
374
The status page serves a limited purpose. First, it allows control of the Samba daemons.
375
375
The key daemons that create the Samba server environment are <span class="application">smbd</span>, <span class="application">nmbd</span>, and <span class="application">winbindd</span>.
376
376
</p><p>
381
381
</p><p>
382
382
Finally, the status page may be used to terminate specific smbd client connections in order to
383
383
free files that may be locked.
384
 
</p></div><div class="sect2" title="The View Page"><div class="titlepage"><div><div><h3 class="title"><a name="id444670"></a>The View Page</h3></div></div></div><p>
 
384
</p></div><div class="sect2" title="The View Page"><div class="titlepage"><div><div><h3 class="title"><a name="id444672"></a>The View Page</h3></div></div></div><p>
385
385
The view page allows you to view the optimized <code class="filename">smb.conf</code> file and, if you are
386
386
particularly masochistic, permits you also to see all possible global configuration
387
387
parameters and their settings.
388
 
</p></div><div class="sect2" title="The Password Change Page"><div class="titlepage"><div><div><h3 class="title"><a name="id444687"></a>The Password Change Page</h3></div></div></div><p>
 
388
</p></div><div class="sect2" title="The Password Change Page"><div class="titlepage"><div><div><h3 class="title"><a name="id444690"></a>The Password Change Page</h3></div></div></div><p>
389
389
The password change page is a popular tool that allows the creation, deletion, deactivation,
390
390
and reactivation of MS Windows networking users on the local machine. You can also use
391
391
this tool to change a local password for a user account.