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 |
|
---|
15 | <sect1 id="samba3" xreflabel="Samba-&samba3-version;">
|
---|
16 | <?dbhtml filename="samba3.html"?>
|
---|
17 | <title>Samba-&samba3-version;</title>
|
---|
18 |
|
---|
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:
|
---|
38 | <ulink url="&patch-root;/samba-3.0.4-maintainer-1.patch"/></para></listitem>
|
---|
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 |
|
---|
68 | <screen><userinput><command>patch -Np1 -i samba-3.0.4-maintainer-1.patch &&
|
---|
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>
|
---|
287 |
|
---|
288 | </sect1>
|
---|
289 |
|
---|