Ignore:
Timestamp:
Jan 15, 2010, 8:21:06 AM (16 years ago)
Author:
Herwig Bauernfeind
Message:

Update Samba 3.3 to 3.3.10 (docs)

File:
1 edited

Legend:

Unmodified
Added
Removed
  • branches/samba-3.3.x/docs/htmldocs/Samba3-HOWTO/SWAT.html

    r342 r368  
    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.74.0"><link rel="home" href="index.html" title="The Official Samba 3.3.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" lang="en"><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="orgname">Samba Team</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#id2681115">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="SWAT.html#id2681245">Guidelines and Technical Tips</a></span></dt><dd><dl><dt><span class="sect2"><a href="SWAT.html#id2681264">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#id2681902">Securing SWAT through SSL</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2682054">Enabling SWAT Internationalization Support</a></span></dt></dl></dd><dt><span class="sect1"><a href="SWAT.html#id2682252">Overview and Quick Tour</a></span></dt><dd><dl><dt><span class="sect2"><a href="SWAT.html#id2682265">The SWAT Home Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2682326">Global Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2682428">Share Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2682483">Printers Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2682540">The SWAT Wizard</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2682603">The Status Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2682647">The View Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2682666">The Password Change Page</a></span></dt></dl></dd></dl></div><p>
    2 <a class="indexterm" name="id2681079"></a>
    3 <a class="indexterm" name="id2681086"></a>
    4 <a class="indexterm" name="id2681093"></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.3.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#id2687177">Features and Benefits</a></span></dt><dt><span class="sect1"><a href="SWAT.html#id2687302">Guidelines and Technical Tips</a></span></dt><dd><dl><dt><span class="sect2"><a href="SWAT.html#id2687321">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#id2687958">Securing SWAT through SSL</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2688110">Enabling SWAT Internationalization Support</a></span></dt></dl></dd><dt><span class="sect1"><a href="SWAT.html#id2688308">Overview and Quick Tour</a></span></dt><dd><dl><dt><span class="sect2"><a href="SWAT.html#id2688322">The SWAT Home Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2688382">Global Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2688484">Share Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2688540">Printers Settings</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2688596">The SWAT Wizard</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2688659">The Status Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2688703">The View Page</a></span></dt><dt><span class="sect2"><a href="SWAT.html#id2688722">The Password Change Page</a></span></dt></dl></dd></dl></div><p>
     2<a class="indexterm" name="id2687141"></a>
     3<a class="indexterm" name="id2687148"></a>
     4<a class="indexterm" name="id2687154"></a>
    55There are many and varied opinions regarding the usefulness of SWAT.  No matter how hard one tries to produce
    66the perfect configuration tool, it remains an object of personal taste. SWAT is a tool that allows Web-based
     
    88context-sensitive help on each <code class="filename">smb.conf</code> parameter, it provides for monitoring of current state of connection
    99information, and it allows networkwide MS Windows network password management.
    10 </p><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2681115"></a>Features and Benefits</h2></div></div></div><p>
    11 <a class="indexterm" name="id2681123"></a>
     10</p><div class="sect1" title="Features and Benefits"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2687177"></a>Features and Benefits</h2></div></div></div><p>
     11<a class="indexterm" name="id2687185"></a>
    1212SWAT is a facility that is part of the Samba suite. The main executable is called
    1313<code class="literal">swat</code> and is invoked by the internetworking super daemon.
    1414See <a class="link" href="SWAT.html#xinetd" title="Enabling SWAT for Use">appropriate section</a> for details.
    1515</p><p>
    16 <a class="indexterm" name="id2681151"></a>
     16<a class="indexterm" name="id2687212"></a>
    1717SWAT uses integral Samba components to locate parameters supported by the particular
    1818version of Samba. Unlike tools and utilities that are external to Samba, SWAT is always
     
    2020configuration parameter, directly from <code class="literal">man</code> page entries.
    2121</p><p>
    22 <a class="indexterm" name="id2681172"></a>
    23 <a class="indexterm" name="id2681178"></a>
    24 <a class="indexterm" name="id2681185"></a>
     22<a class="indexterm" name="id2687233"></a>
     23<a class="indexterm" name="id2687240"></a>
     24<a class="indexterm" name="id2687247"></a>
    2525Some network administrators believe that it is a good idea to write systems
    2626documentation inside configuration files, and for them SWAT will always be a nasty tool. SWAT
     
    3030as well as parameters that are no longer supported, will be lost from the <code class="filename">smb.conf</code> file.
    3131Additionally, the parameters will be written back in internal ordering.
    32 </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    33 <a class="indexterm" name="id2681223"></a>
     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="id2687280"></a>
    3434Before using SWAT, please be warned  SWAT will completely replace your <code class="filename">smb.conf</code> with
    3535a fully optimized file that has been stripped of all comments you might have placed there
    3636and only nondefault settings will be written to the file.
    37 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2681245"></a>Guidelines and Technical Tips</h2></div></div></div><p>
    38 <a class="indexterm" name="id2681253"></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="id2687302"></a>Guidelines and Technical Tips</h2></div></div></div><p>
     38<a class="indexterm" name="id2687310"></a>
    3939This section aims to unlock the dark secrets behind how SWAT may be made to work,
    4040how it can be made more secure, and how to solve internationalization support problems.
    41 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2681264"></a>Validate SWAT Installation</h3></div></div></div><p>
    42 <a class="indexterm" name="id2681272"></a>
     41</p><div class="sect2" title="Validate SWAT Installation"><div class="titlepage"><div><div><h3 class="title"><a name="id2687321"></a>Validate SWAT Installation</h3></div></div></div><p>
     42<a class="indexterm" name="id2687329"></a>
    4343The very first step that should be taken before attempting to configure a host
    4444system for SWAT operation is to check that it is installed. This may seem a trivial
     
    4747on the distribution media.
    4848</p><p>
    49 <a class="indexterm" name="id2681288"></a>
     49<a class="indexterm" name="id2687345"></a>
    5050When you have confirmed that SWAT is installed, it is necessary to validate
    5151that the installation includes the binary <code class="literal">swat</code> file as well
     
    5454<code class="literal">swat</code> binary executable file was installed.
    5555</p><p>
    56 <a class="indexterm" name="id2681316"></a>
    57 <a class="indexterm" name="id2681323"></a>
     56<a class="indexterm" name="id2687372"></a>
     57<a class="indexterm" name="id2687379"></a>
    5858Finally, when you are sure that SWAT has been fully installed, please check that SWAT
    5959is enabled in the control file for the internetworking super-daemon (inetd or xinetd)
    6060that is used on your operating system platform.
    61 </p><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2681334"></a>Locating the <code class="literal">SWAT</code> File</h4></div></div></div><p>
    62 <a class="indexterm" name="id2681348"></a>
    63 <a class="indexterm" name="id2681355"></a>
    64 <a class="indexterm" name="id2681362"></a>
     61</p><div class="sect3" title="Locating the SWAT File"><div class="titlepage"><div><div><h4 class="title"><a name="id2687391"></a>Locating the <code class="literal">SWAT</code> File</h4></div></div></div><p>
     62<a class="indexterm" name="id2687405"></a>
     63<a class="indexterm" name="id2687412"></a>
     64<a class="indexterm" name="id2687419"></a>
    6565To validate that SWAT is installed, first locate the <code class="literal">swat</code> binary
    66 file on the system. It may be found under the following directories:</p><table class="simplelist" border="0" summary="Simple list"><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>
     66file 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>
    6767</p><p>
    6868The actual location is much dependent on the choice of the operating system vendor or as determined
     
    7272The following methods may be helpful.
    7373</p><p>
    74 <a class="indexterm" name="id2681434"></a>
    75 <a class="indexterm" name="id2681441"></a>
    76 <a class="indexterm" name="id2681448"></a>
     74<a class="indexterm" name="id2687491"></a>
     75<a class="indexterm" name="id2687498"></a>
     76<a class="indexterm" name="id2687505"></a>
    7777If <code class="literal">swat</code> is in your current operating system search path, it will be easy to
    7878find it. You can ask what are the command-line options for <code class="literal">swat</code> as shown here:
     
    9292  -V, --version                        Print version
    9393</pre><p>
    94 </p></div><div class="sect3" lang="en"><div class="titlepage"><div><div><h4 class="title"><a name="id2681487"></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="id2687543"></a>Locating the SWAT Support Files</h4></div></div></div><p>
    9595Now that you have found that <code class="literal">swat</code> is in the search path, it is easy
    9696to identify where the file is located. Here is another simple way this may be done:
     
    163163If the files needed are not available, it is necessary to obtain and install them
    164164before SWAT can be used.
    165 </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="xinetd"></a>Enabling SWAT for Use</h3></div></div></div><p>
     165</p></div></div><div class="sect2" title="Enabling SWAT for Use"><div class="titlepage"><div><div><h3 class="title"><a name="xinetd"></a>Enabling SWAT for Use</h3></div></div></div><p>
    166166SWAT should be installed to run via the network super-daemon. Depending on which system
    167167your UNIX/Linux system has, you will have either an <code class="literal">inetd</code>- or
     
    174174</p><p>
    175175The control entry for the older style file might be:
    176 <a class="indexterm" name="id2681679"></a>
     176<a class="indexterm" name="id2687736"></a>
    177177</p><pre class="programlisting">
    178178        # swat is the Samba Web Administration Tool
     
    202202as shown.
    203203</p><p>
    204 <a class="indexterm" name="id2681735"></a>
    205 <a class="indexterm" name="id2681741"></a>
    206 <a class="indexterm" name="id2681748"></a>
    207 <a class="indexterm" name="id2681755"></a>
     204<a class="indexterm" name="id2687791"></a>
     205<a class="indexterm" name="id2687798"></a>
     206<a class="indexterm" name="id2687805"></a>
     207<a class="indexterm" name="id2687812"></a>
    208208Both of the previous examples assume that the <code class="literal">swat</code> binary has been
    209209located in the <code class="filename">/usr/sbin</code> directory. In addition to the above,
     
    213213location using Samba defaults will be <code class="filename">/usr/local/samba/swat</code>.
    214214</p><p>
    215 <a class="indexterm" name="id2681796"></a>
    216 <a class="indexterm" name="id2681803"></a>
     215<a class="indexterm" name="id2687852"></a>
     216<a class="indexterm" name="id2687859"></a>
    217217Access to SWAT will prompt for a logon. If you log onto SWAT as any non-root user,
    218218the only permission allowed is to view certain aspects of configuration as well as
     
    226226<span class="guibutton">HOME</span>, <span class="guibutton">GLOBALS</span>, <span class="guibutton">SHARES</span>, <span class="guibutton">PRINTERS</span>,
    227227<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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2681902"></a>Securing SWAT through SSL</h3></div></div></div><p>
    229 <a class="indexterm" name="id2681910"></a>
    230 <a class="indexterm" name="id2681917"></a>
     228</p></div><div class="sect2" title="Securing SWAT through SSL"><div class="titlepage"><div><div><h3 class="title"><a name="id2687958"></a>Securing SWAT through SSL</h3></div></div></div><p>
     229<a class="indexterm" name="id2687966"></a>
     230<a class="indexterm" name="id2687973"></a>
    231231Many people have asked about how to set up SWAT with SSL to allow for secure remote
    232232administration of Samba. Here is a method that works, courtesy of Markus Krieger.
    233233</p><p>
    234234Modifications to the SWAT setup are as follows:
    235 </p><div class="procedure"><ol type="1"><li><p>
    236 <a class="indexterm" name="id2681942"></a>
     235</p><div class="procedure"><ol class="procedure" type="1"><li class="step" title="Step 1"><p>
     236<a class="indexterm" name="id2687998"></a>
    237237        Install OpenSSL.
    238         </p></li><li><p>
    239 <a class="indexterm" name="id2681956"></a>
    240 <a class="indexterm" name="id2681962"></a>
     238        </p></li><li class="step" title="Step 2"><p>
     239<a class="indexterm" name="id2688012"></a>
     240<a class="indexterm" name="id2688019"></a>
    241241        Generate certificate and private key.
    242 <a class="indexterm" name="id2681970"></a>
     242<a class="indexterm" name="id2688027"></a>
    243243</p><pre class="screen">
    244244<code class="prompt">root# </code><strong class="userinput"><code>/usr/bin/openssl req -new -x509 -days 365 -nodes -config \
    245245        /usr/share/doc/packages/stunnel/stunnel.cnf \
    246246        -out /etc/stunnel/stunnel.pem -keyout /etc/stunnel/stunnel.pem</code></strong>
    247 </pre></li><li><p>
     247</pre></li><li class="step" title="Step 3"><p>
    248248        Remove SWAT entry from [x]inetd.
    249         </p></li><li><p>
    250 <a class="indexterm" name="id2682008"></a>
     249        </p></li><li class="step" title="Step 4"><p>
     250<a class="indexterm" name="id2688065"></a>
    251251        Start <code class="literal">stunnel</code>.
    252252
     
    256256</pre></li></ol></div><p>
    257257Afterward, 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" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2682054"></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="id2688110"></a>Enabling SWAT Internationalization Support</h3></div></div></div><p>
    259259SWAT can be configured to display its messages to match the settings of
    260260the language configurations of your Web browser. It will be passed to SWAT
     
    262262</p><p>
    263263To enable this feature:
    264 </p><div class="itemizedlist"><ul type="disc"><li><p>
     264</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    265265        Install  the proper <code class="literal">msg</code> files from the Samba
    266266        <code class="filename">source/po</code> directory into $LIBDIR.
    267         </p></li><li><p>
     267        </p></li><li class="listitem"><p>
    268268        Set your browsers language setting.
    269269        </p></li></ul></div><p>
    270 <a class="indexterm" name="id2682098"></a>
    271 <a class="indexterm" name="id2682105"></a>
    272 <a class="indexterm" name="id2682111"></a>
    273 <a class="indexterm" name="id2682118"></a>
     270<a class="indexterm" name="id2688154"></a>
     271<a class="indexterm" name="id2688161"></a>
     272<a class="indexterm" name="id2688168"></a>
     273<a class="indexterm" name="id2688175"></a>
    274274The name of the <code class="literal">msg</code> file is the same as the language ID sent by the browser. For
    275275example, <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.
    276276</p><p>
    277 <a class="indexterm" name="id2682147"></a>
     277<a class="indexterm" name="id2688204"></a>
    278278If you do not like some of messages, or there are no <code class="literal">msg</code> files for
    279279your locale, you can create them simply by copying the <code class="literal">en.msg</code> files
    280 to the directory for &#8220;<span class="quote">your language ID.msg</span>&#8221; and filling in proper strings
    281 to each &#8220;<span class="quote">msgstr</span>&#8221;. For example, in <code class="filename">it.msg</code>, the
     280to the directory for <span class="quote">&#8220;<span class="quote">your language ID.msg</span>&#8221;</span> and filling in proper strings
     281to each <span class="quote">&#8220;<span class="quote">msgstr</span>&#8221;</span>. For example, in <code class="filename">it.msg</code>, the
    282282<code class="literal">msg</code> file for the Italian locale, just set:
    283283</p><pre class="screen">
     
    285285msgstr "Imposta Default"
    286286</pre><p>
    287 <a class="indexterm" name="id2682195"></a>
     287<a class="indexterm" name="id2688252"></a>
    288288and so on. If you find a mistake or create a new <code class="literal">msg</code> file, please email it
    289289to 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.
    290290</p><p>
    291 <a class="indexterm" name="id2682219"></a>
     291<a class="indexterm" name="id2688276"></a>
    292292Note that if you enable this feature and the <a class="link" href="smb.conf.5.html#DISPLAYCHARSET" target="_top">display charset</a> is not
    293293matched to your browser's setting, the SWAT display may be corrupted.  In a future version of
    294294Samba, SWAT will always display messages with UTF-8 encoding. You will then not need to set
    295295this <code class="filename">smb.conf</code> file parameter.
    296 </p></div></div><div class="sect1" lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="id2682252"></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="id2688308"></a>Overview and Quick Tour</h2></div></div></div><p>
    297297SWAT is a tool that may be used to configure Samba or just to obtain useful links
    298298to important reference materials such as the contents of this book as well as other
    299299documents that have been found useful for solving Windows networking problems.
    300 </p><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2682265"></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="id2688322"></a>The SWAT Home Page</h3></div></div></div><p>
    301301The SWAT title page provides access to the latest Samba documentation. The manual page for
    302302each Samba component is accessible from this page, as are the Samba3-HOWTO (this
    303 document) as well as the O'Reilly book &#8220;<span class="quote">Using Samba.</span>&#8221;
     303document) as well as the O'Reilly book <span class="quote">&#8220;<span class="quote">Using Samba.</span>&#8221;</span>
    304304</p><p>
    305305Administrators who wish to validate their Samba configuration may obtain useful information
     
    307307also. One diagnostic tool that is not mentioned on this page but that is particularly
    308308useful is <a class="ulink" href="http://www.ethereal.com/" target="_top"><code class="literal">ethereal</code></a>.
    309 </p><div class="warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
     309</p><div class="warning" title="Warning" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Warning</h3><p>
    310310SWAT can be configured to run in <span class="emphasis"><em>demo</em></span> mode. This is not recommended
    311311because it runs SWAT without authentication and with full administrative ability. It allows
     
    313313creates this ability is the <code class="option">-a</code> flag to SWAT. <span class="emphasis"><em>Do not use this in a
    314314production environment.</em></span>
    315 </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2682326"></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="id2688382"></a>Global Settings</h3></div></div></div><p>
    316316The <span class="guibutton">GLOBALS</span> button exposes a page that allows configuration of the global parameters
    317317in <code class="filename">smb.conf</code>. There are two levels of exposure of the parameters:
    318 </p><div class="itemizedlist"><ul type="disc"><li><p>
     318</p><div class="itemizedlist"><ul class="itemizedlist" type="disc"><li class="listitem"><p>
    319319        <span class="guibutton">Basic</span>  exposes common configuration options.
    320         </p></li><li><p>
     320        </p></li><li class="listitem"><p>
    321321        <span class="guibutton">Advanced</span>  exposes configuration options needed in more
    322322        complex environments.
     
    329329<span class="guibutton">Commit Changes</span> button before moving to another area; otherwise,
    330330your changes will be lost.
    331 </p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
     331</p><div class="note" title="Note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>
    332332SWAT has context-sensitive help. To find out what each parameter is
    333333for, simply click on the
    334334<span class="guibutton">Help</span> link to the left of the configuration parameter.
    335 </p></div></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2682428"></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="id2688484"></a>Share Settings</h3></div></div></div><p>
    336336To affect a currently configured share, simply click on the pull-down button between the
    337337<span class="guibutton">Choose Share</span> and the <span class="guibutton">Delete Share</span> buttons and
     
    344344into the text field the name of the share to be created, then click on the
    345345<span class="guibutton">Create Share</span> button.
    346 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2682483"></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="id2688540"></a>Printers Settings</h3></div></div></div><p>
    347347To affect a currently configured printer, simply click on the pull-down button between the
    348348<span class="guibutton">Choose Printer</span> and the <span class="guibutton">Delete Printer</span> buttons and
     
    355355into the text field the name of the share to be created, then click on the
    356356<span class="guibutton">Create Printer</span> button.
    357 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2682540"></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="id2688596"></a>The SWAT Wizard</h3></div></div></div><p>
    358358The purpose of the SWAT Wizard is to help the Microsoft-knowledgeable network administrator
    359359to configure Samba with a minimum of effort.
     
    371371operate with no WINS support. By clicking one button, you can elect to expose (or not) user
    372372home directories.
    373 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2682603"></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="id2688659"></a>The Status Page</h3></div></div></div><p>
    374374The status page serves a limited purpose. First, it allows control of the Samba daemons.
    375375The 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>.
     
    382382Finally, the status page may be used to terminate specific smbd client connections in order to
    383383free files that may be locked.
    384 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2682647"></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="id2688703"></a>The View Page</h3></div></div></div><p>
    385385The view page allows you to view the optimized <code class="filename">smb.conf</code> file and, if you are
    386386particularly masochistic, permits you also to see all possible global configuration
    387387parameters and their settings.
    388 </p></div><div class="sect2" lang="en"><div class="titlepage"><div><div><h3 class="title"><a name="id2682666"></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="id2688722"></a>The Password Change Page</h3></div></div></div><p>
    389389The password change page is a popular tool that allows the creation, deletion, deactivation,
    390390and reactivation of MS Windows networking users on the local machine. You can also use
Note: See TracChangeset for help on using the changeset viewer.