[0931098] | 1 | <?xml version="1.0" encoding="ISO-8859-1"?>
|
---|
| 2 | <!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
|
---|
| 3 | "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
|
---|
| 4 | <!ENTITY % general-entities SYSTEM "../../general.ent">
|
---|
| 5 | %general-entities;
|
---|
| 6 |
|
---|
| 7 | <!ENTITY samba3-download-http "http://us1.samba.org/samba/ftp/samba-&samba3-version;.tar.gz">
|
---|
| 8 | <!ENTITY samba3-download-ftp "ftp://ftp.samba.org/pub/samba/samba-&samba3-version;.tar.gz">
|
---|
| 9 | <!ENTITY samba3-size "14.4 MB">
|
---|
| 10 | <!ENTITY samba3-buildsize "123 MB">
|
---|
| 11 | <!ENTITY samba3-time "10.5 SBU">
|
---|
| 12 |
|
---|
| 13 | ]>
|
---|
| 14 |
|
---|
[736ede9] | 15 | <sect1 id="samba3" xreflabel="Samba-&samba3-version;">
|
---|
| 16 | <?dbhtml filename="samba3.html"?>
|
---|
| 17 | <title>Samba-&samba3-version;</title>
|
---|
| 18 |
|
---|
[0931098] | 19 | <sect2>
|
---|
| 20 | <title>Introduction to <application>Samba</application></title>
|
---|
| 21 |
|
---|
| 22 | <para>The <application>Samba</application> package provides file and print
|
---|
| 23 | services to <acronym>SMB</acronym>/<acronym>CIFS</acronym> clients and
|
---|
| 24 | Windows networking to Linux clients.</para>
|
---|
| 25 |
|
---|
| 26 | <sect3><title>Package information</title>
|
---|
| 27 | <itemizedlist spacing='compact'>
|
---|
| 28 | <listitem><para>Download (HTTP): <ulink url="&samba3-download-http;"/></para></listitem>
|
---|
| 29 | <listitem><para>Download (FTP): <ulink url="&samba3-download-ftp;"/></para></listitem>
|
---|
| 30 | <listitem><para>Download size: &samba3-size;</para></listitem>
|
---|
| 31 | <listitem><para>Estimated Disk space required: &samba3-buildsize;</para></listitem>
|
---|
| 32 | <listitem><para>Estimated build time: &samba3-time;</para></listitem></itemizedlist>
|
---|
| 33 | </sect3>
|
---|
| 34 |
|
---|
| 35 | <sect3><title>Additional downloads</title>
|
---|
| 36 | <itemizedlist spacing='compact'>
|
---|
| 37 | <listitem><para>Maintainer Recommended patch:
|
---|
[4f6275fd] | 38 | <ulink url="&patch-root;/samba-&samba3-version;-maintainer-1.patch"/></para></listitem>
|
---|
[0931098] | 39 | </itemizedlist>
|
---|
| 40 | </sect3>
|
---|
| 41 |
|
---|
| 42 | <sect3>
|
---|
| 43 | <title><application>Samba</application> dependencies</title>
|
---|
| 44 | <sect4>
|
---|
| 45 | <title>Optional</title>
|
---|
| 46 | <para>
|
---|
| 47 | <xref linkend="Linux_PAM"/>,
|
---|
| 48 | <xref linkend="readline"/>,
|
---|
| 49 | <xref linkend="openldap"/>,
|
---|
| 50 | <xref linkend="cups"/>,
|
---|
| 51 | <xref linkend="heimdal"/> or <xref linkend="mitkrb"/>,
|
---|
| 52 | <xref linkend="libxml2"/>,
|
---|
| 53 | <xref linkend="mysql"/> or <xref linkend="postgresql"/>,
|
---|
| 54 | <xref linkend="Python"/>, and
|
---|
| 55 | <ulink url="http://valgrind.kde.org/">Valgrind</ulink>
|
---|
| 56 | </para>
|
---|
| 57 | </sect4>
|
---|
| 58 | </sect3>
|
---|
| 59 |
|
---|
| 60 | </sect2>
|
---|
| 61 |
|
---|
| 62 | <sect2>
|
---|
| 63 | <title>Installation of <application>Samba</application></title>
|
---|
| 64 |
|
---|
| 65 | <para>Install <application>Samba</application> by running the following
|
---|
| 66 | commands:</para>
|
---|
| 67 |
|
---|
[4f6275fd] | 68 | <screen><userinput><command>patch -Np1 -i ../samba-&samba3-version;-maintainer-1.patch &&
|
---|
[0931098] | 69 | cd source &&
|
---|
| 70 | install -d /var/cache/samba &&
|
---|
| 71 | ./configure \
|
---|
| 72 | --prefix=/usr \
|
---|
| 73 | --sysconfdir=/etc \
|
---|
| 74 | --localstatedir=/var \
|
---|
| 75 | --with-piddir=/var/run \
|
---|
| 76 | --with-fhs \
|
---|
| 77 | --with-smbmount &&
|
---|
| 78 | make &&
|
---|
| 79 | make install &&
|
---|
| 80 | install -m755 nsswitch/libnss_win{s,bind}.so /lib &&
|
---|
| 81 | ln -sf libnss_winbind.so /lib/libnss_winbind.so.2 &&
|
---|
| 82 | ln -sf libnss_wins.so /lib/libnss_wins.so.2 &&
|
---|
| 83 | cp ../examples/smb.conf.default /etc/samba</command></userinput></screen>
|
---|
| 84 |
|
---|
| 85 | <note><para>You may want to run <command>configure</command> with the
|
---|
| 86 | <parameter>--help</parameter> parameter. There may be other parameters
|
---|
| 87 | needed to take advantage of the optional dependencies.</para></note>
|
---|
| 88 |
|
---|
| 89 | </sect2>
|
---|
| 90 |
|
---|
| 91 | <sect2>
|
---|
| 92 | <title>Installation command explanations</title>
|
---|
| 93 |
|
---|
| 94 | <para><command>install -d /var/cache/samba</command>: This directory is
|
---|
| 95 | needed for proper operation of the <command>smbd</command> and
|
---|
| 96 | <command>nmbd</command> daemons.</para>
|
---|
| 97 |
|
---|
| 98 | <para><parameter>--sysconfdir=/etc</parameter>: Sets the configuration
|
---|
| 99 | file directory to avoid the default of <filename class="directory">/usr/etc</filename>.</para>
|
---|
| 100 |
|
---|
| 101 | <para><parameter>--localstatedir=/var</parameter>: Sets the variable
|
---|
| 102 | data directory to avoid the default of <filename class="directory">/usr/var</filename>.</para>
|
---|
| 103 |
|
---|
| 104 | <para><option>--with-fhs</option>: Assigns all other file paths in a manner
|
---|
| 105 | compliant with the Filesystem Hierarchy Standard
|
---|
| 106 | (<acronym>FHS</acronym>).</para>
|
---|
| 107 |
|
---|
| 108 | <para><option>--with-smbmount</option>: Orders the creation of an extra
|
---|
| 109 | binary for use by the <command>mount</command> command so that mounting remote
|
---|
| 110 | <acronym>SMB</acronym> (Windows) shares becomes no more complex than mounting
|
---|
| 111 | remote <acronym>NFS</acronym> shares.</para>
|
---|
| 112 |
|
---|
| 113 | <para><command>install -m755 nsswitch/libnss_win{s,bind}.so /lib</command>:
|
---|
| 114 | The nss libraries are not installed by default. If you intend to use
|
---|
| 115 | winbindd for domain auth, and/or <acronym>WINS</acronym> name resolution,
|
---|
| 116 | you need these libraries.</para>
|
---|
| 117 |
|
---|
| 118 | <para><command>ln -sf libnss_winbind.so /lib/libnss_winbind.so.2</command>
|
---|
| 119 | and <command>ln -sf libnss_wins.so /lib/libnss_wins.so.2</command>:
|
---|
| 120 | These symlinks are required by glibc to use the nss libraries.</para>
|
---|
| 121 |
|
---|
| 122 | <para><command>cp ../examples/smb.conf.default /etc/samba</command>:
|
---|
| 123 | This copies a default <filename>smb.conf </filename>into
|
---|
| 124 | <filename>/etc/samba</filename>. This sample configuration will not
|
---|
| 125 | work unless edited for your site, and renamed
|
---|
| 126 | <filename>smb.conf</filename>.</para>
|
---|
| 127 |
|
---|
| 128 | </sect2>
|
---|
| 129 |
|
---|
| 130 | <sect2>
|
---|
| 131 | <title>Configuring <application>Samba</application></title>
|
---|
| 132 |
|
---|
| 133 | <para>Because of the various uses for <application>Samba</application>,
|
---|
| 134 | complete configuration is well beyond the scope of the BLFS book.
|
---|
| 135 | In fact, many complete books have been written on this topic alone.
|
---|
| 136 | The included documentation, a popular book published by O'Reilly,
|
---|
| 137 | can be viewed by pointing your web browser to
|
---|
| 138 | <ulink url="file:///usr/share/samba/swat/using_samba/toc.html" />.
|
---|
| 139 | </para>
|
---|
| 140 |
|
---|
| 141 | <para>The built in <acronym>SWAT</acronym> (Samba Web Administration Tool)
|
---|
| 142 | utility can be used for basic configuration, however, before
|
---|
| 143 | using <acronym>SWAT</acronym> you must add an entry to
|
---|
| 144 | <filename>/etc/services</filename> and make changes to your
|
---|
| 145 | <command>inetd</command>/<command>xinetd</command>
|
---|
| 146 | configuration.</para>
|
---|
| 147 |
|
---|
| 148 | <para>Add the swat entry to <filename>/etc/services</filename> with the
|
---|
| 149 | following command: </para>
|
---|
| 150 |
|
---|
| 151 | <screen><userinput><command>echo "swat 901/tcp" >> /etc/services</command></userinput></screen>
|
---|
| 152 |
|
---|
| 153 | <para>If <command>inetd</command> is used, the following command will add the
|
---|
| 154 | swat entry to <filename>/etc/inetd.conf</filename>: </para>
|
---|
| 155 |
|
---|
| 156 | <screen><userinput><command>echo "swat stream tcp nowait.400 root /usr/sbin/swat swat" \
|
---|
| 157 | >> /etc/inetd.conf</command></userinput></screen>
|
---|
| 158 | <para>Issue a <command>killall -HUP inetd</command> to reread the
|
---|
| 159 | changed <filename>inetd.conf</filename> file.</para>
|
---|
| 160 |
|
---|
| 161 | <para>If <command>xinetd</command> is used, the following command will
|
---|
| 162 | add the swat entry to <filename>/etc/xinetd.conf</filename>: </para>
|
---|
| 163 |
|
---|
| 164 | <screen><userinput><command>cat >> /etc/xinetd.conf << "EOF"</command>
|
---|
| 165 | service swat
|
---|
| 166 | {
|
---|
| 167 | port = 901
|
---|
| 168 | socket_type = stream
|
---|
| 169 | wait = no
|
---|
| 170 | only_from = 127.0.0.1
|
---|
| 171 | user = root
|
---|
| 172 | server = /usr/sbin/swat
|
---|
| 173 | log_on_failure += USERID
|
---|
| 174 | }
|
---|
| 175 | <command>EOF</command></userinput></screen>
|
---|
| 176 |
|
---|
| 177 | <para>Issue a <command>killall -HUP xinetd</command> to reread the
|
---|
| 178 | changed <filename>xinetd.conf</filename> file.</para>
|
---|
| 179 |
|
---|
| 180 | <para><acronym>SWAT</acronym> can be launched by pointing your web
|
---|
| 181 | browser to <ulink url="http://localhost:901"/>.</para>
|
---|
| 182 |
|
---|
| 183 | <para>For your convenience, boot scripts have been provided for
|
---|
| 184 | <application>Samba</application>. There are two included in the
|
---|
| 185 | <xref linkend="intro-important-bootscripts"/> package. The first,
|
---|
| 186 | <filename>samba</filename>, will start the <command>smbd</command> and
|
---|
| 187 | <command>nmbd</command> daemons needed to provide
|
---|
| 188 | <acronym>SMB</acronym>/<acronym>CIFS</acronym> services. The second
|
---|
| 189 | script, <filename>winbind</filename>, starts the <command>winbindd</command>
|
---|
| 190 | daemon, used for providing Windows domain services to Linux clients.</para>
|
---|
| 191 |
|
---|
| 192 | <para>Install the <filename>samba</filename> script with the following
|
---|
| 193 | command:</para>
|
---|
| 194 |
|
---|
| 195 | <screen><userinput><command>make install-samba</command></userinput></screen>
|
---|
| 196 |
|
---|
| 197 | <para>If you also need the <filename>winbind</filename> script:</para>
|
---|
| 198 |
|
---|
| 199 | <screen><userinput><command>make install-winbind</command></userinput></screen>
|
---|
| 200 |
|
---|
| 201 | </sect2>
|
---|
| 202 |
|
---|
| 203 | <sect2>
|
---|
| 204 | <title>Contents</title>
|
---|
| 205 |
|
---|
| 206 | <para>The <application>Samba</application> package contains
|
---|
| 207 | <command>make_smbcodepage</command>,
|
---|
| 208 | <command>make_unicodemap</command>,
|
---|
| 209 | <command>mount.smbfs</command>,
|
---|
| 210 | <command>net</command>,
|
---|
| 211 | <command>nmbd</command>,
|
---|
| 212 | <command>nmblookup</command>,
|
---|
| 213 | <command>rpcclient</command>,
|
---|
| 214 | <command>smbcacls</command>,
|
---|
| 215 | <command>smbclient</command>,
|
---|
| 216 | <command>smbcontrol</command>,
|
---|
| 217 | <command>smbd</command>,
|
---|
| 218 | <command>smbpasswd</command>,
|
---|
| 219 | <command>smbspool</command>,
|
---|
| 220 | <command>smbstatus</command>,
|
---|
| 221 | <command>swat</command>,
|
---|
| 222 | <command>testparm</command>,
|
---|
| 223 | <command>testprns</command>,
|
---|
| 224 | <command>wbinfo</command> and
|
---|
| 225 | <command>winbindd.</command></para></sect2>
|
---|
| 226 |
|
---|
| 227 | <sect2>
|
---|
| 228 | <title>Description</title>
|
---|
| 229 | <sect3><title>make_smbcodepage</title>
|
---|
| 230 | <para><command>make_smbcodepage</command> converts text descriptions of code
|
---|
| 231 | pages to binary code page files and vice versa.</para></sect3>
|
---|
| 232 | <sect3><title>make_unicodemap</title>
|
---|
| 233 | <para><command>make_unicodemap</command> converts text Unicode map files to
|
---|
| 234 | binary, for use in mapping characters to 16 bit Unicode.</para></sect3>
|
---|
| 235 | <sect3><title>mount.smbfs</title>
|
---|
| 236 | <para><command>mount.smbfs</command> provides <command>/bin/mount</command>
|
---|
| 237 | with a way to mount remote Windows (or Samba) fileshares.</para></sect3>
|
---|
| 238 | <sect3><title>net</title>
|
---|
| 239 | <para><command>net</command> is a tool for administration of Samba and remote
|
---|
| 240 | CIFS servers, similar to the net utility for DOS/Windows.</para></sect3>
|
---|
| 241 | <sect3><title>nmbd</title>
|
---|
| 242 | <para><command>nmbd</command> is the Samba Net<acronym>BIOS</acronym> name
|
---|
| 243 | server.</para></sect3>
|
---|
| 244 | <sect3><title>nmblookup</title>
|
---|
| 245 | <para><command>nmblookup</command> is used to query
|
---|
| 246 | Net<acronym>BIOS</acronym> names and map them to <acronym>IP</acronym>
|
---|
| 247 | addresses.</para></sect3>
|
---|
| 248 | <sect3><title>rpcclient</title>
|
---|
| 249 | <para><command>rpcclient</command> is used to execute
|
---|
| 250 | MS-<acronym>RPC</acronym> client side functions.</para></sect3>
|
---|
| 251 | <sect3><title>smbcacls</title>
|
---|
| 252 | <para><command>smbcacls</command> is used to manipulate NT access control
|
---|
| 253 | lists.</para></sect3>
|
---|
| 254 | <sect3><title>smbclient</title>
|
---|
| 255 | <para><command>smbclient</command> is a <acronym>SMB</acronym>/<acronym>CIFS
|
---|
| 256 | </acronym> access utility, similar to <acronym>FTP</acronym>.</para></sect3>
|
---|
| 257 | <sect3><title>smbcontrol</title>
|
---|
| 258 | <para><command>smbcontrol</command> is used to control running <command>smbd</command>,
|
---|
| 259 | <command>nmbd</command> and <command>winbindd</command>
|
---|
| 260 | daemons.</para></sect3>
|
---|
| 261 | <sect3><title>smbd</title>
|
---|
| 262 | <para><command>smbd</command> is the main
|
---|
| 263 | <application>Samba</application> daemon.</para></sect3>
|
---|
| 264 | <sect3><title>smbpasswd</title>
|
---|
| 265 | <para><command>smbpasswd</command> changes a user's <application>Samba
|
---|
| 266 | </application> password.</para></sect3>
|
---|
| 267 | <sect3><title>smbspool</title>
|
---|
| 268 | <para><command>smbspool</command> sends a print job to an <acronym>SMB
|
---|
| 269 | </acronym> printer.</para></sect3>
|
---|
| 270 | <sect3><title>smbstatus</title>
|
---|
| 271 | <para><command>smbstatus</command> reports current
|
---|
| 272 | <application>Samba</application> connections.</para></sect3>
|
---|
| 273 | <sect3><title>swat</title>
|
---|
| 274 | <para><command>swat</command> is the Samba Web Administration Tool.</para>
|
---|
| 275 | </sect3>
|
---|
| 276 | <sect3><title>testparm</title>
|
---|
| 277 | <para><command>testparm</command> checks an <filename>smb.conf</filename> file
|
---|
| 278 | for proper syntax.</para></sect3>
|
---|
| 279 | <sect3><title>testprns</title>
|
---|
| 280 | <para><command>testprns</command> tests printer names.</para></sect3>
|
---|
| 281 | <sect3><title>wbinfo</title>
|
---|
| 282 | <para><command>wbinfo</command> queries a running <command>winbindd</command>
|
---|
| 283 | daemon.</para></sect3>
|
---|
| 284 | <sect3><title>winbindd</title>
|
---|
| 285 | <para><command>winbindd</command> resolves names from NT servers.</para></sect3>
|
---|
| 286 | </sect2>
|
---|
[736ede9] | 287 |
|
---|
| 288 | </sect1>
|
---|
| 289 |
|
---|