source: server/major/nfs-utils.xml@ b86cfc2

10.0 10.1 11.0 11.1 11.2 11.3 12.0 12.1 6.1 6.2 6.2.0 6.2.0-rc1 6.2.0-rc2 6.3 6.3-rc1 6.3-rc2 6.3-rc3 7.10 7.4 7.5 7.6 7.6-blfs 7.6-systemd 7.7 7.8 7.9 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind gnome kde5-13430 kde5-14269 kde5-14686 kea ken/TL2024 ken/inkscape-core-mods ken/tuningfonts krejzi/svn lazarus lxqt nosym perl-modules plabs/newcss plabs/python-mods python3.11 qt5new rahul/power-profiles-daemon renodr/vulkan-addition systemd-11177 systemd-13485 trunk upgradedb xry111/intltool xry111/llvm18 xry111/soup3 xry111/test-20220226 xry111/xf86-video-removal
Last change on this file since b86cfc2 was b86cfc2, checked in by Manuel Canales Esparcia <manuel@…>, 19 years ago

Tagged nfs-utils.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4346 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 14.5 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
3 "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY nfs-utils-download-http "http://ftp.kernel.org/pub/linux/utils/nfs/nfs-utils-&nfs-utils-version;.tar.gz">
8 <!ENTITY nfs-utils-download-ftp "ftp://ftp.kernel.org/pub/linux/utils/nfs/nfs-utils-&nfs-utils-version;.tar.gz">
9 <!ENTITY nfs-utils-md5sum "8f863120261cd572ad320a9152581e11">
10 <!ENTITY nfs-utils-size "396 KB">
11 <!ENTITY nfs-utils-buildsize "5.8 MB">
12 <!ENTITY nfs-utils-time "0.2 SBU">
13]>
14
15<sect1 id="nfs-utils" xreflabel="NFS Utilities-&nfs-utils-version;">
16 <?dbhtml filename="nfs-utils.html"?>
17
18 <sect1info>
19 <othername>$LastChangedBy$</othername>
20 <date>$Date$</date>
21 </sect1info>
22
23 <title>NFS Utilities-&nfs-utils-version;</title>
24
25 <indexterm zone="nfs-utils">
26 <primary sortas="a-Nfs-utils">NFS Utilities</primary>
27 </indexterm>
28
29 <sect2 role="package">
30 <title>Introduction to NFS Utilities</title>
31
32 <para>The <application>NFS Utilities</application> package contains the
33 userspace server and client tools necessary to use the kernel's nfs
34 abilities. NFS is a protocol that allows sharing file systems over the
35 network.</para>
36
37 <bridgehead renderas="sect3">Package information</bridgehead>
38 <itemizedlist spacing='compact'>
39 <listitem>
40 <para>Download (HTTP): <ulink url="&nfs-utils-download-http;"/></para>
41 </listitem>
42 <listitem>
43 <para>Download (FTP): <ulink url="&nfs-utils-download-ftp;"/></para>
44 </listitem>
45 <listitem>
46 <para>Download MD5 sum: &nfs-utils-md5sum;</para>
47 </listitem>
48 <listitem>
49 <para>Download size: &nfs-utils-size;</para>
50 </listitem>
51 <listitem>
52 <para>Estimated disk space required: &nfs-utils-buildsize;</para>
53 </listitem>
54 <listitem>
55 <para>Estimated build time: &nfs-utils-time;</para>
56 </listitem>
57 </itemizedlist>
58
59 <bridgehead renderas="sect3">NFS Utilities Dependencies</bridgehead>
60
61 <bridgehead renderas="sect4">Required</bridgehead>
62 <para><xref linkend="portmap"/></para>
63
64 <bridgehead renderas="sect4">Optional</bridgehead>
65 <para><ulink url="http://www.monkey.org/~provos/libevent/">libevent</ulink>
66 and <ulink
67 url="http://www.citi.umich.edu/projects/nfsv4/linux/libnfsidmap/">libnsfidmap</ulink>
68 for nfsv4 support, and <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>
69 for gss (RPC Security) support.</para>
70
71 </sect2>
72
73 <sect2 role="kernel" id='nfs-utils-kernel'>
74 <title>Kernel Configuration</title>
75
76 <para>Enable the following options in the kernel configuration
77 and recompile the kernel if neccessary:</para>
78
79<screen><literal>File systems:
80 Network File Systems:
81 NFS File System Support: M or Y
82 NFS Server Support: M or Y</literal></screen>
83
84 <para>Select the appropriate sub-options that appear when the above options
85 are selected.</para>
86
87 <indexterm zone="nfs-utils nfs-utils-kernel">
88 <primary sortas="d-nfs-utils">NFS Utilities</primary>
89 </indexterm>
90
91 </sect2>
92
93 <sect2 role="installation">
94 <title>Installation of NFS Utilities</title>
95
96 <para>Before you compile the program, you need to be sure the
97 <systemitem class="username">nobody</systemitem> user and
98 <systemitem class="groupname">nogroup</systemitem> group are available.
99 You can add these by running the following commands as the
100 <systemitem class="username">root</systemitem> user:</para>
101
102<screen role="root"><userinput>groupadd -g 99 nogroup &amp;&amp;
103useradd -c nobody -d /home -g nogroup -s /bin/bash -u 99 nobody</userinput></screen>
104
105 <note>
106 <para>The classic uid and gid values are 65534 which is also -2 when
107 interpreted as a signed 16-bit number. These values impact other files on
108 some filesystems that do not have support for sparse files. The
109 <systemitem class="username">nobody</systemitem> and <systemitem
110 class="groupname">nogroup</systemitem> values have small impact.
111 The impact on a server is nil if the exports file is configured correctly.
112 If it is misconfigured, the impact is that a <command>ls -l</command> or
113 <command>ps</command> listing will show a uid or gid number of 65534
114 instead of a name. The client uses <systemitem
115 class="username">nobody</systemitem> only as the user running
116 <command>rpc.statd</command>.</para>
117 </note>
118
119 <para>Install <application>NFS Utilities</application> by running
120 the following commands:</para>
121
122<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \
123 --disable-nfsv4 --disable-gss &amp;&amp;
124make</userinput></screen>
125
126 <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
127
128<screen role='root'><userinput>make install</userinput></screen>
129
130 <note>
131 <para>If your <filename class="directory">/usr</filename> directory
132 is NFS mounted, you should install the executables in
133 <filename class="directory">/sbin</filename> by passing
134 an additional parameter <option>--sbindir=/sbin</option> to the
135 above <command>./configure</command> command.</para>
136 </note>
137
138 </sect2>
139
140 <sect2 role="commands">
141 <title>Command Explanations</title>
142
143 <para><parameter>--disable-nfsv4</parameter>: Disables support
144 for NFS Version 4.</para>
145
146 <para><parameter>--disable-gss</parameter>: Disables support for
147 RPCSEC GSS (RPC Security).</para>
148
149 </sect2>
150
151 <sect2 role="configuration">
152 <title>Configuring NFS Utilities</title>
153
154 <sect3 id='nfs-utils-server-config'>
155 <title>Server Configutation</title>
156
157 <para><filename>/etc/exports</filename> contains the exported directories
158 on NFS servers. Refer to the exports manual page for the syntax of this
159 file. Also refer to the "NFS HowTo" available at <ulink
160 url="http://nfs.sourceforge.net/nfs-howto/"/> on how to configure the
161 servers and clients in a secure manner. For example, for sharing the
162 <filename class="directory">/home</filename> directory over the local
163 network, the following line may be added:</para>
164
165<screen role="root"><userinput>/home 192.168.0.0/255.255.255.0(rw,anonuid=99,anongid=99)</userinput></screen>
166
167 <indexterm zone="nfs-utils nfs-utils-server-config">
168 <primary sortas="e-etc-exportfs">/etc/exportfs</primary>
169 </indexterm>
170
171 <sect4 id="nfs-utils-server-init">
172 <title>Boot Script</title>
173
174 <para>Install the <filename>/etc/rc.d/init.d/nfs-server</filename>
175 init script included in the <xref
176 linkend="intro-important-bootscripts"/> package to start the server
177 at boot.</para>
178
179<screen role="root"><userinput>make install-nfs-server</userinput></screen>
180
181 <indexterm zone="nfs-utils nfs-utils-server-init">
182 <primary sortas="f-nfs-server">nfs-server</primary>
183 </indexterm>
184
185 <para>Now create the <filename>/etc/sysconfig/nfs-server</filename>
186 configuration file:</para>
187
188<screen role="root"><userinput>cat &gt; /etc/sysconfig/nfs-server &lt;&lt; "EOF"
189<literal>PORT="2049"
190PROCESSES="8"
191QUOTAS="no"
192KILLDELAY="10"</literal>
193EOF</userinput></screen>
194
195 <indexterm zone="nfs-utils nfs-utils-server-init">
196 <primary
197 sortas="e-etc-sysconfig-nfs-server">/etc/sysconfig/nfs-server</primary>
198 </indexterm>
199
200 </sect4>
201
202 </sect3>
203
204 <sect3 id='nfs-utils-client-config'>
205 <title>Client Configutation</title>
206
207 <para><filename>/etc/fstab</filename> contains the directories that
208 are to be mounted on the client. Alternately the partitions can be
209 mounted by using the <command>mount</command> command with the proper
210 options. To mount the <filename class="directory">/home</filename>
211 and <filename class="directory">/usr</filename> partitions, add the
212 following to the <filename>/etc/fstab</filename>:</para>
213
214<screen role="root"><userinput>&lt;server-name&gt;:/home /home nfs rw,_netdev,rsize=8192,wsize=8192 0 0
215&lt;server-name&gt;:/usr /usr nfs ro,_netdev,rsize=8192 0 0</userinput></screen>
216
217 <indexterm zone="nfs-utils nfs-utils-client-config">
218 <primary sortas="e-etc-fstab">/etc/fstab</primary>
219 </indexterm>
220
221 <sect4 id="nfs-utils-client-init">
222 <title>Boot Script</title>
223
224
225 <para>Install the <filename>/etc/rc.d/init.d/nfs-client</filename>
226 init script included in the
227 <xref linkend="intro-important-bootscripts"/> package to
228 start the client services at boot.</para>
229
230<screen role="root"><userinput>make install-nfs-client</userinput></screen>
231
232 <indexterm zone="nfs-utils nfs-utils-client-config">
233 <primary sortas="f-nfs-client">nfs-client</primary>
234 </indexterm>
235
236 <para>To automatically mount <systemitem
237 class="filesystem">nfs</systemitem> filesystems, clients will also
238 need to install the <filename>netfs</filename> bootscript as described
239 in <xref linkend='postlfs-config-netfs'/>.</para>
240
241 <indexterm zone="nfs-utils nfs-utils-client-config">
242 <primary sortas="f-netfs">netfs</primary>
243 </indexterm>
244
245 </sect4>
246
247 </sect3>
248
249 </sect2>
250
251 <sect2 role="content">
252 <title>Contents</title>
253 <segmentedlist>
254 <segtitle>Installed Programs</segtitle>
255 <segtitle>Installed Libraries</segtitle>
256 <segtitle>Installed Directories</segtitle>
257
258 <seglistitem>
259 <seg>exportfs, nfsstat, nhfsgraph, nhfsnums, nhfsrun, nhfsstone,
260 rpc.lockd, rpc.mountd, rpc.nfsd, rpc.rquotad, rpc.statd,
261 and showmount</seg>
262 <seg>None</seg>
263 <seg>/var/lib/nfs</seg>
264 </seglistitem>
265 </segmentedlist>
266
267 <variablelist>
268 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
269 <?dbfo list-presentation="list"?>
270 <?dbhtml list-presentation="table"?>
271
272 <varlistentry id="exportfs">
273 <term><command>exportfs</command></term>
274 <listitem>
275 <para>maintains a list of NFS exported file systems.</para>
276 <indexterm zone="nfs-utils exportfs">
277 <primary sortas="b-exportfs">exportfs</primary>
278 </indexterm>
279 </listitem>
280 </varlistentry>
281
282 <varlistentry id="nfsstat">
283 <term><command>nfsstat</command></term>
284 <listitem>
285 <para>prints NFS statistics.</para>
286 <indexterm zone="nfs-utils nfsstat">
287 <primary sortas="b-nfsstat">nfsstat</primary>
288 </indexterm>
289 </listitem>
290 </varlistentry>
291
292 <varlistentry id="nhfsgraph">
293 <term><command>nhfsgraph</command></term>
294 <listitem>
295 <para>runs <command>nhfsstone</command> over multiple loads.</para>
296 <indexterm zone="nfs-utils nhfsgraph">
297 <primary sortas="b-nhfsgraph">nhfsgraph</primary>
298 </indexterm>
299 </listitem>
300 </varlistentry>
301
302 <varlistentry id="nhfsnums">
303 <term><command>nhfsnums</command></term>
304 <listitem>
305 <para>converts raw numbers from <command>nhfsstone</command>
306 output into plot format.</para>
307 <indexterm zone="nfs-utils nhfsnums">
308 <primary sortas="b-nhfsnums">nhfsnums</primary>
309 </indexterm>
310 </listitem>
311 </varlistentry>
312
313 <varlistentry id="nhfsrun">
314 <term><command>nhfsrun</command></term>
315 <listitem>
316 <para>executes <command>nhfsstone</command> with a range of
317 different loads.</para>
318 <indexterm zone="nfs-utils nhfsrun">
319 <primary sortas="b-nhfsrun">nhfsrun</primary>
320 </indexterm>
321 </listitem>
322 </varlistentry>
323
324 <varlistentry id="nhfsstone">
325 <term><command>nhfsstone</command></term>
326 <listitem>
327 <para>is used on a NFS client to generate an artificial load
328 with a particular mix of NFS operations.</para>
329 <indexterm zone="nfs-utils nhfsstone">
330 <primary sortas="b-nhfsstone">nhfsstone</primary>
331 </indexterm>
332 </listitem>
333 </varlistentry>
334
335 <varlistentry id="rpclockd">
336 <term><command>rpc.lockd</command></term>
337 <listitem>
338 <para>starts the NFS lock manager (NLM) on kernels that don't
339 start it automatically. However, since most kernels do start it
340 automatically it is usually not required.</para>
341 <indexterm zone="nfs-utils rpclockd">
342 <primary sortas="b-rpclockd">rpc.lockd</primary>
343 </indexterm>
344 </listitem>
345 </varlistentry>
346
347 <varlistentry id="rpcmountd">
348 <term><command>rpc.mountd</command></term>
349 <listitem>
350 <para>implements the NFS mount protocol on an NFS server.</para>
351 <indexterm zone="nfs-utils rpcmountd">
352 <primary sortas="b-rpcmountd">rpc.mountd</primary>
353 </indexterm>
354 </listitem>
355 </varlistentry>
356
357 <varlistentry id="rpcnfsd">
358 <term><command>rpc.nfsd</command></term>
359 <listitem>
360 <para>implements the user level part of the NFS
361 service on the server.</para>
362 <indexterm zone="nfs-utils rpcnfsd">
363 <primary sortas="b-rpcnfsd">rpc.nfsd</primary>
364 </indexterm>
365 </listitem>
366 </varlistentry>
367
368 <varlistentry id="rpcrquotad">
369 <term><command>rpc.rquotad</command></term>
370 <listitem>
371 <para>is an rpc server which returns quotas for a user of a
372 local file system which is mounted by a remote machine over
373 the NFS.</para>
374 <indexterm zone="nfs-utils rpcrquotad">
375 <primary sortas="b-rpcrquotad">rpc.rquotad</primary>
376 </indexterm>
377 </listitem>
378 </varlistentry>
379
380 <varlistentry id="rpcstatd">
381 <term><command>rpc.statd</command></term>
382 <listitem>
383 <para>is used by the NFS file locking service,
384 <command>rpc.lockd</command>, to implement lock recovery when
385 the NFS server machine crashes and reboots. Runs on the NFS
386 server only.</para>
387 <indexterm zone="nfs-utils rpcstatd">
388 <primary sortas="b-rpcstatd">rpc.statd</primary>
389 </indexterm>
390 </listitem>
391 </varlistentry>
392
393 <varlistentry id="showmount">
394 <term><command>showmount</command></term>
395 <listitem>
396 <para>displays mount information for an NFS server.</para>
397 <indexterm zone="nfs-utils showmount">
398 <primary sortas="b-showmount">showmount</primary>
399 </indexterm>
400 </listitem>
401 </varlistentry>
402
403 </variablelist>
404
405 </sect2>
406
407</sect1>
Note: See TracBrowser for help on using the repository browser.