mirror of
https://github.com/Zeckmathederg/glfs.git
synced 2025-02-03 23:07:23 +08:00
Tagged nfs-utils.xml
git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4346 af4574ff-66df-0310-9fd7-8a98e5e911e0
This commit is contained in:
Manuel Canales Esparcia
parent
5d62564033
commit
b86cfc2a06
@ -13,12 +13,13 @@
|
||||
]>
|
||||
|
||||
<sect1 id="nfs-utils" xreflabel="NFS Utilities-&nfs-utils-version;">
|
||||
<?dbhtml filename="nfs-utils.html"?>
|
||||
|
||||
<sect1info>
|
||||
<othername>$LastChangedBy$</othername>
|
||||
<date>$Date$</date>
|
||||
</sect1info>
|
||||
|
||||
<?dbhtml filename="nfs-utils.html"?>
|
||||
<title>NFS Utilities-&nfs-utils-version;</title>
|
||||
|
||||
<indexterm zone="nfs-utils">
|
||||
@ -26,34 +27,46 @@
|
||||
</indexterm>
|
||||
|
||||
<sect2 role="package">
|
||||
<title>Introduction to <application>NFS Utilities</application></title>
|
||||
<title>Introduction to NFS Utilities</title>
|
||||
|
||||
<para>The <application>NFS Utilities</application> package contains the userspace
|
||||
server and client tools necessary to use the kernel's nfs abilities.
|
||||
<acronym>NFS</acronym> is a protocol that allows sharing file systems over the
|
||||
<para>The <application>NFS Utilities</application> package contains the
|
||||
userspace server and client tools necessary to use the kernel's nfs
|
||||
abilities. NFS is a protocol that allows sharing file systems over the
|
||||
network.</para>
|
||||
|
||||
<bridgehead renderas="sect3">Package information</bridgehead>
|
||||
<itemizedlist spacing='compact'>
|
||||
<listitem><para>Download (HTTP): <ulink url="&nfs-utils-download-http;"/></para></listitem>
|
||||
<listitem><para>Download (FTP): <ulink url="&nfs-utils-download-ftp;"/></para></listitem>
|
||||
<listitem><para>Download MD5 sum: &nfs-utils-md5sum;</para></listitem>
|
||||
<listitem><para>Download size: &nfs-utils-size;</para></listitem>
|
||||
<listitem><para>Estimated disk space required: &nfs-utils-buildsize;</para></listitem>
|
||||
<listitem><para>Estimated build time: &nfs-utils-time;</para></listitem>
|
||||
<listitem>
|
||||
<para>Download (HTTP): <ulink url="&nfs-utils-download-http;"/></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Download (FTP): <ulink url="&nfs-utils-download-ftp;"/></para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Download MD5 sum: &nfs-utils-md5sum;</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Download size: &nfs-utils-size;</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Estimated disk space required: &nfs-utils-buildsize;</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>Estimated build time: &nfs-utils-time;</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
|
||||
<bridgehead renderas="sect3">NFS Utilities Dependencies</bridgehead>
|
||||
<bridgehead renderas="sect4">Required</bridgehead>
|
||||
|
||||
<bridgehead renderas="sect4">Required</bridgehead>
|
||||
<para><xref linkend="portmap"/></para>
|
||||
|
||||
<bridgehead renderas="sect4">Optional</bridgehead>
|
||||
<para><ulink url="http://www.monkey.org/~provos/libevent/">libevent</ulink>
|
||||
and <ulink url="http://www.citi.umich.edu/projects/nfsv4/linux/libnfsidmap/">libnsfidmap</ulink>
|
||||
and <ulink
|
||||
url="http://www.citi.umich.edu/projects/nfsv4/linux/libnfsidmap/">libnsfidmap</ulink>
|
||||
for nfsv4 support, and <xref linkend="mitkrb"/> or <xref linkend="heimdal"/>
|
||||
for gss (RPC Security) support.
|
||||
</para>
|
||||
for gss (RPC Security) support.</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
@ -74,32 +87,37 @@ are selected.</para>
|
||||
<indexterm zone="nfs-utils nfs-utils-kernel">
|
||||
<primary sortas="d-nfs-utils">NFS Utilities</primary>
|
||||
</indexterm>
|
||||
|
||||
</sect2>
|
||||
|
||||
<sect2 role="installation">
|
||||
<title>Installation of NFS Utilities</title>
|
||||
|
||||
<para>Before you compile the program, you need to be sure the <systemitem
|
||||
class="username">nobody</systemitem> user and <systemitem
|
||||
class="groupname">nogroup</systemitem> group are available. You can add these by
|
||||
running the following commands as the <systemitem class="username">root</systemitem>
|
||||
user:</para>
|
||||
<para>Before you compile the program, you need to be sure the
|
||||
<systemitem class="username">nobody</systemitem> user and
|
||||
<systemitem class="groupname">nogroup</systemitem> group are available.
|
||||
You can add these by running the following commands as the
|
||||
<systemitem class="username">root</systemitem> user:</para>
|
||||
|
||||
<screen role="root"><userinput>groupadd -g 99 nogroup &&
|
||||
useradd -c nobody -d /home -g nogroup -s /bin/bash -u 99 nobody</userinput></screen>
|
||||
|
||||
<note><para>The classic uid and gid values are 65534 which is also -2 when
|
||||
<note>
|
||||
<para>The classic uid and gid values are 65534 which is also -2 when
|
||||
interpreted as a signed 16-bit number. These values impact other files on
|
||||
some filesystems that do not have support for sparse files. The <systemitem
|
||||
class="username">nobody</systemitem> and <systemitem
|
||||
some filesystems that do not have support for sparse files. The
|
||||
<systemitem class="username">nobody</systemitem> and <systemitem
|
||||
class="groupname">nogroup</systemitem> values have small impact.
|
||||
The impact on a server is nil if the exports file is configured correctly. If it is misconfigured,
|
||||
the impact is that a <command>ls -l</command> or <command>ps</command> listing
|
||||
will show a uid or gid number of 65534 instead of a name. The client uses <systemitem
|
||||
The impact on a server is nil if the exports file is configured correctly.
|
||||
If it is misconfigured, the impact is that a <command>ls -l</command> or
|
||||
<command>ps</command> listing will show a uid or gid number of 65534
|
||||
instead of a name. The client uses <systemitem
|
||||
class="username">nobody</systemitem> only as the user running
|
||||
<command>rpc.statd</command>.</para></note>
|
||||
<command>rpc.statd</command>.</para>
|
||||
</note>
|
||||
|
||||
<para>Install <application>NFS Utilities</application> by running the following commands:</para>
|
||||
<para>Install <application>NFS Utilities</application> by running
|
||||
the following commands:</para>
|
||||
|
||||
<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \
|
||||
--disable-nfsv4 --disable-gss &&
|
||||
@ -109,11 +127,13 @@ make</userinput></screen>
|
||||
|
||||
<screen role='root'><userinput>make install</userinput></screen>
|
||||
|
||||
<note><para>If your <filename class="directory">/usr</filename> directory is
|
||||
<acronym>NFS</acronym> mounted, you should install the executables in
|
||||
<note>
|
||||
<para>If your <filename class="directory">/usr</filename> directory
|
||||
is NFS mounted, you should install the executables in
|
||||
<filename class="directory">/sbin</filename> by passing
|
||||
an additional parameter <option>--sbindir=/sbin</option> to the above
|
||||
<command>./configure</command> command.</para></note>
|
||||
an additional parameter <option>--sbindir=/sbin</option> to the
|
||||
above <command>./configure</command> command.</para>
|
||||
</note>
|
||||
|
||||
</sect2>
|
||||
|
||||
@ -121,10 +141,10 @@ an additional parameter <option>--sbindir=/sbin</option> to the above
|
||||
<title>Command Explanations</title>
|
||||
|
||||
<para><parameter>--disable-nfsv4</parameter>: Disables support
|
||||
for <acronym>NFS</acronym> Version 4.</para>
|
||||
for NFS Version 4.</para>
|
||||
|
||||
<para><parameter>--disable-gss</parameter>: Disables support for
|
||||
<acronym>RPCSEC GSS</acronym> (<acronym>RPC</acronym> Security).</para>
|
||||
RPCSEC GSS (RPC Security).</para>
|
||||
|
||||
</sect2>
|
||||
|
||||
@ -134,13 +154,13 @@ for <acronym>NFS</acronym> Version 4.</para>
|
||||
<sect3 id='nfs-utils-server-config'>
|
||||
<title>Server Configutation</title>
|
||||
|
||||
<para><filename>/etc/exports</filename> contains the exported directories on
|
||||
<acronym>NFS</acronym> servers. Refer to the exports manual page for
|
||||
the syntax of this file. Also refer to the "NFS HowTo" available at <ulink
|
||||
url="http://nfs.sourceforge.net/nfs-howto/"/> on how to configure the servers
|
||||
and clients in a secure manner. For example, for sharing the
|
||||
<filename class="directory">/home</filename> directory over the local network, the following line
|
||||
may be added:</para>
|
||||
<para><filename>/etc/exports</filename> contains the exported directories
|
||||
on NFS servers. Refer to the exports manual page for the syntax of this
|
||||
file. Also refer to the "NFS HowTo" available at <ulink
|
||||
url="http://nfs.sourceforge.net/nfs-howto/"/> on how to configure the
|
||||
servers and clients in a secure manner. For example, for sharing the
|
||||
<filename class="directory">/home</filename> directory over the local
|
||||
network, the following line may be added:</para>
|
||||
|
||||
<screen role="root"><userinput>/home 192.168.0.0/255.255.255.0(rw,anonuid=99,anongid=99)</userinput></screen>
|
||||
|
||||
@ -148,13 +168,17 @@ may be added:</para>
|
||||
<primary sortas="e-etc-exportfs">/etc/exportfs</primary>
|
||||
</indexterm>
|
||||
|
||||
<para>Install the <filename>/etc/rc.d/init.d/nfs-server</filename> init script
|
||||
included in the <xref linkend="intro-important-bootscripts"/> package to start
|
||||
the server at boot.</para>
|
||||
<sect4 id="nfs-utils-server-init">
|
||||
<title>Boot Script</title>
|
||||
|
||||
<para>Install the <filename>/etc/rc.d/init.d/nfs-server</filename>
|
||||
init script included in the <xref
|
||||
linkend="intro-important-bootscripts"/> package to start the server
|
||||
at boot.</para>
|
||||
|
||||
<screen role="root"><userinput>make install-nfs-server</userinput></screen>
|
||||
|
||||
<indexterm zone="nfs-utils nfs-utils-server-config">
|
||||
<indexterm zone="nfs-utils nfs-utils-server-init">
|
||||
<primary sortas="f-nfs-server">nfs-server</primary>
|
||||
</indexterm>
|
||||
|
||||
@ -168,20 +192,24 @@ QUOTAS="no"
|
||||
KILLDELAY="10"</literal>
|
||||
EOF</userinput></screen>
|
||||
|
||||
<indexterm zone="nfs-utils nfs-utils-server-config">
|
||||
<primary sortas="e-etc-sysconfig-nfs-server">/etc/sysconfig/nfs-server</primary>
|
||||
<indexterm zone="nfs-utils nfs-utils-server-init">
|
||||
<primary
|
||||
sortas="e-etc-sysconfig-nfs-server">/etc/sysconfig/nfs-server</primary>
|
||||
</indexterm>
|
||||
|
||||
</sect4>
|
||||
|
||||
</sect3>
|
||||
|
||||
<sect3 id='nfs-utils-client-config'><title>Client Configutation</title>
|
||||
<sect3 id='nfs-utils-client-config'>
|
||||
<title>Client Configutation</title>
|
||||
|
||||
<para><filename>/etc/fstab</filename> contains the
|
||||
directories that are to be mounted on the client. Alternately the partitions
|
||||
can be mounted by using the <command>mount</command> command with the proper
|
||||
options. To mount the <filename class="directory">/home</filename> and
|
||||
<filename class="directory">/usr</filename>
|
||||
partitions, add the following to the <filename>/etc/fstab</filename>:</para>
|
||||
<para><filename>/etc/fstab</filename> contains the directories that
|
||||
are to be mounted on the client. Alternately the partitions can be
|
||||
mounted by using the <command>mount</command> command with the proper
|
||||
options. To mount the <filename class="directory">/home</filename>
|
||||
and <filename class="directory">/usr</filename> partitions, add the
|
||||
following to the <filename>/etc/fstab</filename>:</para>
|
||||
|
||||
<screen role="root"><userinput><server-name>:/home /home nfs rw,_netdev,rsize=8192,wsize=8192 0 0
|
||||
<server-name>:/usr /usr nfs ro,_netdev,rsize=8192 0 0</userinput></screen>
|
||||
@ -190,6 +218,9 @@ partitions, add the following to the <filename>/etc/fstab</filename>:</para>
|
||||
<primary sortas="e-etc-fstab">/etc/fstab</primary>
|
||||
</indexterm>
|
||||
|
||||
<sect4 id="nfs-utils-client-init">
|
||||
<title>Boot Script</title>
|
||||
|
||||
|
||||
<para>Install the <filename>/etc/rc.d/init.d/nfs-client</filename>
|
||||
init script included in the
|
||||
@ -202,14 +233,17 @@ start the client services at boot.</para>
|
||||
<primary sortas="f-nfs-client">nfs-client</primary>
|
||||
</indexterm>
|
||||
|
||||
<para>To automatically mount <systemitem class="filesystem">nfs</systemitem> filesystems,
|
||||
clients will also need to install the <filename>netfs</filename> bootscript as described in
|
||||
<xref linkend='postlfs-config-netfs'/>.</para>
|
||||
<para>To automatically mount <systemitem
|
||||
class="filesystem">nfs</systemitem> filesystems, clients will also
|
||||
need to install the <filename>netfs</filename> bootscript as described
|
||||
in <xref linkend='postlfs-config-netfs'/>.</para>
|
||||
|
||||
<indexterm zone="nfs-utils nfs-utils-client-config">
|
||||
<primary sortas="f-netfs">netfs</primary>
|
||||
</indexterm>
|
||||
|
||||
</sect4>
|
||||
|
||||
</sect3>
|
||||
|
||||
</sect2>
|
||||
@ -223,7 +257,8 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
|
||||
<seglistitem>
|
||||
<seg>exportfs, nfsstat, nhfsgraph, nhfsnums, nhfsrun, nhfsstone,
|
||||
rpc.lockd, rpc.mountd, rpc.nfsd, rpc.rquotad, rpc.statd, and showmount</seg>
|
||||
rpc.lockd, rpc.mountd, rpc.nfsd, rpc.rquotad, rpc.statd,
|
||||
and showmount</seg>
|
||||
<seg>None</seg>
|
||||
<seg>/var/lib/nfs</seg>
|
||||
</seglistitem>
|
||||
@ -237,7 +272,7 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="exportfs">
|
||||
<term><command>exportfs</command></term>
|
||||
<listitem>
|
||||
<para>maintains a list of <acronym>NFS</acronym> exported file systems.</para>
|
||||
<para>maintains a list of NFS exported file systems.</para>
|
||||
<indexterm zone="nfs-utils exportfs">
|
||||
<primary sortas="b-exportfs">exportfs</primary>
|
||||
</indexterm>
|
||||
@ -247,7 +282,7 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="nfsstat">
|
||||
<term><command>nfsstat</command></term>
|
||||
<listitem>
|
||||
<para>prints <acronym>NFS</acronym> statistics.</para>
|
||||
<para>prints NFS statistics.</para>
|
||||
<indexterm zone="nfs-utils nfsstat">
|
||||
<primary sortas="b-nfsstat">nfsstat</primary>
|
||||
</indexterm>
|
||||
@ -267,8 +302,8 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="nhfsnums">
|
||||
<term><command>nhfsnums</command></term>
|
||||
<listitem>
|
||||
<para>converts raw numbers from <command>nhfsstone</command> output
|
||||
into plot format.</para>
|
||||
<para>converts raw numbers from <command>nhfsstone</command>
|
||||
output into plot format.</para>
|
||||
<indexterm zone="nfs-utils nhfsnums">
|
||||
<primary sortas="b-nhfsnums">nhfsnums</primary>
|
||||
</indexterm>
|
||||
@ -278,7 +313,8 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="nhfsrun">
|
||||
<term><command>nhfsrun</command></term>
|
||||
<listitem>
|
||||
<para>executes <command>nhfsstone</command> with a range of different loads.</para>
|
||||
<para>executes <command>nhfsstone</command> with a range of
|
||||
different loads.</para>
|
||||
<indexterm zone="nfs-utils nhfsrun">
|
||||
<primary sortas="b-nhfsrun">nhfsrun</primary>
|
||||
</indexterm>
|
||||
@ -288,8 +324,8 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="nhfsstone">
|
||||
<term><command>nhfsstone</command></term>
|
||||
<listitem>
|
||||
<para>is used on a <acronym>NFS</acronym> client to generate an artificial load with a
|
||||
particular mix of <acronym>NFS</acronym> operations.</para>
|
||||
<para>is used on a NFS client to generate an artificial load
|
||||
with a particular mix of NFS operations.</para>
|
||||
<indexterm zone="nfs-utils nhfsstone">
|
||||
<primary sortas="b-nhfsstone">nhfsstone</primary>
|
||||
</indexterm>
|
||||
@ -299,8 +335,8 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="rpclockd">
|
||||
<term><command>rpc.lockd</command></term>
|
||||
<listitem>
|
||||
<para>starts the <acronym>NFS</acronym> lock manager (<acronym>NLM</acronym>)
|
||||
on kernels that don't start it automatically. However, since most kernels do start it
|
||||
<para>starts the NFS lock manager (NLM) on kernels that don't
|
||||
start it automatically. However, since most kernels do start it
|
||||
automatically it is usually not required.</para>
|
||||
<indexterm zone="nfs-utils rpclockd">
|
||||
<primary sortas="b-rpclockd">rpc.lockd</primary>
|
||||
@ -311,8 +347,7 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="rpcmountd">
|
||||
<term><command>rpc.mountd</command></term>
|
||||
<listitem>
|
||||
<para>implements the <acronym>NFS</acronym> mount protocol on an
|
||||
<acronym>NFS</acronym> server.</para>
|
||||
<para>implements the NFS mount protocol on an NFS server.</para>
|
||||
<indexterm zone="nfs-utils rpcmountd">
|
||||
<primary sortas="b-rpcmountd">rpc.mountd</primary>
|
||||
</indexterm>
|
||||
@ -322,7 +357,7 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="rpcnfsd">
|
||||
<term><command>rpc.nfsd</command></term>
|
||||
<listitem>
|
||||
<para>implements the user level part of the <acronym>NFS</acronym>
|
||||
<para>implements the user level part of the NFS
|
||||
service on the server.</para>
|
||||
<indexterm zone="nfs-utils rpcnfsd">
|
||||
<primary sortas="b-rpcnfsd">rpc.nfsd</primary>
|
||||
@ -333,8 +368,9 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="rpcrquotad">
|
||||
<term><command>rpc.rquotad</command></term>
|
||||
<listitem>
|
||||
<para>is an rpc server which returns quotas for a user of a local file
|
||||
system which is mounted by a remote machine over the <acronym>NFS</acronym>.</para>
|
||||
<para>is an rpc server which returns quotas for a user of a
|
||||
local file system which is mounted by a remote machine over
|
||||
the NFS.</para>
|
||||
<indexterm zone="nfs-utils rpcrquotad">
|
||||
<primary sortas="b-rpcrquotad">rpc.rquotad</primary>
|
||||
</indexterm>
|
||||
@ -344,10 +380,10 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="rpcstatd">
|
||||
<term><command>rpc.statd</command></term>
|
||||
<listitem>
|
||||
<para>is used by the <acronym>NFS</acronym> file locking service,
|
||||
<command>rpc.lockd</command>, to implement lock recovery when the
|
||||
<acronym>NFS</acronym> server machine crashes and reboots. Runs
|
||||
on the <acronym>NFS</acronym> server only.</para>
|
||||
<para>is used by the NFS file locking service,
|
||||
<command>rpc.lockd</command>, to implement lock recovery when
|
||||
the NFS server machine crashes and reboots. Runs on the NFS
|
||||
server only.</para>
|
||||
<indexterm zone="nfs-utils rpcstatd">
|
||||
<primary sortas="b-rpcstatd">rpc.statd</primary>
|
||||
</indexterm>
|
||||
@ -357,16 +393,15 @@ clients will also need to install the <filename>netfs</filename> bootscript as d
|
||||
<varlistentry id="showmount">
|
||||
<term><command>showmount</command></term>
|
||||
<listitem>
|
||||
<para>displays mount information for an <acronym>NFS</acronym> server.</para>
|
||||
<para>displays mount information for an NFS server.</para>
|
||||
<indexterm zone="nfs-utils showmount">
|
||||
<primary sortas="b-showmount">showmount</primary>
|
||||
</indexterm>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
|
||||
|
||||
</variablelist>
|
||||
|
||||
</sect2>
|
||||
</sect1>
|
||||
|
||||
</sect1>
|
||||
|
||||
Loading…
Reference in New Issue
Block a user