Changeset eaf6a1cd for server


Ignore:
Timestamp:
04/23/2005 06:02:51 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
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
Children:
343fb6d
Parents:
a16cb066
Message:

Updated template.xml to match current edguide.
Updated stylesheets to match the new tagging.
Retagged nfs-utils.xml to match current template.xml and edguide tags policies.

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • server/major/nfs-utils.xml

    ra16cb066 reaf6a1cd  
    2323
    2424<indexterm zone="nfs-utils">
    25   <primary sortas="a-nfs-utils">NFS Utilities</primary>
    26 </indexterm>
    27 
    28 <sect2>
    29 <title>Introduction to <application>nfs-utils</application></title>
    30 
    31 <para>The <application>nfs-utils</application> package contains the userspace
     25  <primary sortas="a-Nfs-utils">NFS Utilities</primary>
     26</indexterm>
     27
     28<sect2 role="package">
     29<title>Introduction to <application>NFS Utilities</application></title>
     30
     31<para>The <application>NFS Utilities</application> package contains the userspace
    3232server and client tools necessary to use the kernel's nfs-abilities.
    3333<acronym>NFS</acronym> is a protocol that allows sharing file systems over the
    … …  
    4444</itemizedlist>
    4545
    46 <bridgehead renderas="sect3">nfs-utils Dependencies</bridgehead>
     46<bridgehead renderas="sect3">NFS Utilities Dependencies</bridgehead>
    4747<bridgehead renderas="sect4">Required</bridgehead>
    4848
    … …  
    5757</sect2>
    5858
    59 <sect2 id='nfs-utils-kernel'>
     59<sect2 role="kernel" id='nfs-utils-kernel'>
    6060<title>Kernel Configuration</title>
    6161
    … …  
    6363and recompile the kernel if neccessary:</para>
    6464
    65 <screen>File systems:
     65<screen><literal>File systems:
    6666  Network File Systems:
    6767    NFS File System Support: M or Y
    68     NFS Server Support: M or Y</screen>
     68    NFS Server Support: M or Y</literal></screen>
    6969
    7070<para>Select the appropriate sub-options that appear when the above options
    … …  
    7676</sect2>
    7777
    78 <sect2>
    79 <title>Installation of nfs-utils</title>
    80 
    81 <para>Before you compile the program, you need to be sure the "nobody"
    82 user and "nogroup" group are available. You can add these by
    83 running the following commands as the root user:</para>
    84 
    85 <screen><userinput><command>groupadd -g 99 nogroup &amp;&amp;
    86 useradd -c nobody -d /home -g nogroup -s /bin/bash -u 99 nobody</command></userinput></screen>
     78<sect2 role="installation">
     79<title>Installation of NFS Utilities</title>
     80
     81<para>Before you compile the program, you need to be sure the <systemitem
     82class="username">nobody</systemitem> user and <systemitem
     83class="groupname">nogroup</systemitem> group are available. You can add these by
     84running the following commands as the <systemitem class="username">root</systemitem>
     85user:</para>
     86
     87<screen role="root"><userinput>groupadd -g 99 nogroup &amp;&amp;
     88useradd -c nobody -d /home -g nogroup -s /bin/bash -u 99 nobody</userinput></screen>
    8789
    8890<note><para>The classic uid and gid values are 65534 which is also -2 when
    8991interpreted as a signed 16-bit number.  These values impact other files on
    90 some filesystems that do not have support for sparse files.  The nobody
    91 and nogroup values have small impact.  The impact on a server is nil if the
    92 exports file is configured correctly.  If it is misconfigured, the impact is
    93 that a ls -l or ps listing will show a uid or gid number of 65534 instead
    94 of a name. The client uses nobody only as the user running rpc.statd.</para></note>
    95 
    96 <para>Install nfs-utils by running the following commands:</para>
     92some filesystems that do not have support for sparse files.  The <systemitem
     93class="username">nobody</systemitem> and <systemitem
     94class="groupname">nogroup</systemitem> values have small impact. 
     95The impact on a server is nil if the exports file is configured correctly.  If it is misconfigured,
     96the impact is that a <command>ls -l</command> or <command>ps</command> listing
     97will show a uid or gid number of 65534 instead of a name. The client uses <systemitem
     98class="username">nobody</systemitem> only as the user running
     99<command>rpc.statd</command>.</para></note>
     100
     101<para>Install NFS Utilities by running the following commands:</para>
    97102
    98103<screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \
    … …  
    100105make</userinput></screen>
    101106
    102 <para>Now, as the root user:</para>
     107<para>Now, as the <systemitem class="username">root</systemitem> user:</para>
    103108
    104109<screen role='root'><userinput>make install</userinput></screen>
    105110
    106 <note><para>If your <filename>/usr</filename> directory is NFS mounted,
    107 you should install the executables in <filename>/sbin</filename> by passing
    108 an additional parameter <command>--sbindir=/sbin</command> to the above
     111<note><para>If your <filename class="directory">/usr</filename> directory is
     112<acronym>NFS</acronym> mounted, you should install the executables in
     113<filename class="directory">/sbin</filename> by passing
     114an additional parameter <option>--sbindir=/sbin</option> to the above
    109115<command>./configure</command> command.</para></note>
    110116
    … …  
    115121
    116122<para><parameter>--disable-nfsv4</parameter>: Disbles support 
    117 for NFS Version 4.</para>
     123for <acronym>NFS</acronym> Version 4.</para>
    118124
    119125<para><parameter>--disable-gss</parameter>: Disbles support for
    120 RPCSEC GSS (RPC Security).</para>
    121 
    122 </sect2>
    123 
    124 <sect2>
    125 <title>Configuring nfs-utils</title>
    126 
    127 <bridgehead renderas="sect3">Server Configutation</bridgehead>
    128 
    129 <para id='nfs-utils-server-config'><filename>/etc/exports</filename> contains
    130 the exported directories on NFS servers. Refer to the exports manual page for
    131 the syntax of this file. Also refer to the NFS HowTo available at <ulink
     126<acronym>RPCSEC GSS</acronym> (<acronym>RPC</acronym> Security).</para>
     127
     128</sect2>
     129
     130<sect2 role="configuration">
     131<title>Configuring NFS Utilities</title>
     132
     133<sect3 id='nfs-utils-server-config'>
     134<title>Server Configutation</title>
     135
     136<para><filename>/etc/exports</filename> contains the exported directories on
     137<acronym>NFS</acronym> servers. Refer to the exports manual page for
     138the syntax of this file. Also refer to the "NFS HowTo" available at <ulink
    132139url="http://nfs.sourceforge.net/nfs-howto/"/> on how to configure the servers
    133140and clients in a secure manner. For example, for sharing the
    134 <filename>/home</filename> directory over the local network, the following line
     141<filename class="directory">/home</filename> directory over the local network, the following line
    135142may be added:</para>
    136143
    137 <screen><userinput>/home 192.168.0.0/255.255.255.0(rw,anonuid=99,anongid=99)</userinput></screen>
     144<screen role="root"><userinput>/home 192.168.0.0/255.255.255.0(rw,anonuid=99,anongid=99)</userinput></screen>
    138145
    139146<indexterm zone="nfs-utils nfs-utils-server-config">
    … …  
    145152the server at boot.</para>
    146153
    147 <screen><userinput><command>make install-nfs-server</command></userinput></screen>
     154<screen role="root"><userinput>make install-nfs-server</userinput></screen>
    148155
    149156<indexterm zone="nfs-utils nfs-utils-server-config">
    … …  
    154161configuration file:</para>
    155162
    156 <screen><userinput><command>cat &gt; /etc/sysconfig/nfs-server &lt;&lt; "EOF"</command>
    157 PORT="2049"
     163<screen role="root"><userinput>cat &gt; /etc/sysconfig/nfs-server &lt;&lt; "EOF"
     164<literal>PORT="2049"
    158165PROCESSES="8"
    159166QUOTAS="no"
    160 KILLDELAY="10"
    161 <command>EOF</command></userinput></screen>
     167KILLDELAY="10"</literal>
     168EOF</userinput></screen>
    162169
    163170<indexterm zone="nfs-utils nfs-utils-server-config">
    … …  
    165172</indexterm>
    166173
    167 <bridgehead renderas="sect3">Client Configutation</bridgehead>
    168 
    169 <para id='nfs-utils-client-config'><filename>/etc/fstab</filename> contains the
     174</sect3>
     175
     176<sect3 id='nfs-utils-client-config'><title>Client Configutation</title>
     177
     178<para><filename>/etc/fstab</filename> contains the
    170179directories that are to be mounted on the client. Alternately the partitions
    171180can be mounted by using the <command>mount</command> command with the proper
    172 options. To mount the <filename>/home</filename> and <filename>/usr</filename>
     181options. To mount the <filename class="directory">/home</filename> and
     182<filename class="directory">/usr</filename>
    173183partitions, add the following to the <filename>/etc/fstab</filename>:</para>
    174184
    175 <screen><userinput>&lt;server-name&gt;:/home  /home nfs   rw,_netdev,rsize=8192,wsize=8192 0 0
     185<screen role="root"><userinput>&lt;server-name&gt;:/home  /home nfs   rw,_netdev,rsize=8192,wsize=8192 0 0
    176186&lt;server-name&gt;:/usr   /usr  nfs   ro,_netdev,rsize=8192            0 0</userinput></screen>
    177187
    … …  
    186196start the client services at boot.</para>
    187197
    188 <screen><userinput><command>make install-nfs-client</command></userinput></screen>
     198<screen role="root"><userinput>make install-nfs-client</userinput></screen>
    189199
    190200<indexterm zone="nfs-utils nfs-utils-client-config">
    … …  
    192202</indexterm>
    193203
    194 <para>To automatically mount nfs filesystems, clients will also need to install
    195 the netfs bootscript as described in <xref linkend='postlfs-config-netfs'/>.</para>
     204<para>To automatically mount <systemitem class="filesystem">nfs</systemitem> filesystems,
     205clients will also need to install the <filename>netfs</filename> bootscript as described in
     206<xref linkend='postlfs-config-netfs'/>.</para>
    196207
    197208<indexterm zone="nfs-utils nfs-utils-client-config">
    … …  
    199210</indexterm>
    200211
    201 </sect2>
    202 
    203 <sect2>
     212</sect3>
     213
     214</sect2>
     215
     216<sect2 role="content">
    204217<title>Contents</title>
    205218<segmentedlist>
    206   <segtitle>Installed Programis</segtitle>
     219  <segtitle>Installed Programs</segtitle>
    207220  <segtitle>Installed Libraries</segtitle>
    208221  <segtitle>Installed Directories</segtitle>
    … …  
    210223  <seglistitem>
    211224    <seg>exportfs, nfsstat, nhfsgraph, nhfsnums, nhfsrun, nhfsstone,
    212          rpc.lockd, rpc.mountd, rpc.nfsd, rpc.rquotad, rpc.statd, showmount</seg>
     225         rpc.lockd, rpc.mountd, rpc.nfsd, rpc.rquotad, rpc.statd, and showmount</seg>
    213226    <seg>None</seg>
    214227    <seg>/var/lib/nfs</seg>
    … …  
    224237  <term><command>exportfs</command></term>
    225238  <listitem>
    226     <para>maintains a list of NFS exported file systems.</para>
     239    <para>maintains a list of <acronym>NFS</acronym> exported file systems.</para>
    227240    <indexterm zone="nfs-utils exportfs">
    228241      <primary sortas="b-exportfs">exportfs</primary>
    … …  
    234247  <term><command>nfsstat</command></term>
    235248  <listitem>
    236     <para>prints NFS statistics.</para>
     249    <para>prints <acronym>NFS</acronym> statistics.</para>
    237250    <indexterm zone="nfs-utils nfsstat">
    238251      <primary sortas="b-nfsstat">nfsstat</primary>
    … …  
    244257  <term><command>nhfsgraph</command></term>
    245258  <listitem>
    246     <para>runs nhfsstone over multiple loads.</para>
     259    <para>runs <command>nhfsstone</command> over multiple loads.</para>
    247260    <indexterm zone="nfs-utils nhfsgraph">
    248261      <primary sortas="b-nhfsgraph">nhfsgraph</primary>
    … …  
    254267  <term><command>nhfsnums</command></term>
    255268  <listitem>
    256     <para>converts raw numbers from nhfsstone output into plot format.</para>
     269    <para>converts raw numbers from <command>nhfsstone</command> output
     270       into plot format.</para>
    257271    <indexterm zone="nfs-utils nhfsnums">
    258272      <primary sortas="b-nhfsnums">nhfsnums</primary>
    … …  
    264278  <term><command>nhfsrun</command></term>
    265279  <listitem>
    266     <para>executes nhfsstone with a range of different loads.</para>
     280    <para>executes <command>nhfsstone</command> with a range of different loads.</para>
    267281    <indexterm zone="nfs-utils nhfsrun">
    268282      <primary sortas="b-nhfsrun">nhfsrun</primary>
    … …  
    274288  <term><command>nhfsstone</command></term>
    275289  <listitem>
    276     <para>is used on a NFS client to generate an artificial load with a
    277           particular mix of NFS operations.</para>
     290    <para>is used on a <acronym>NFS</acronym> client to generate an artificial load with a
     291          particular mix of <acronym>NFS</acronym> operations.</para>
    278292    <indexterm zone="nfs-utils nhfsstone">
    279293      <primary sortas="b-nhfsstone">nhfsstone</primary>
    … …  
    285299  <term><command>rpc.lockd</command></term>
    286300  <listitem>
    287     <para>starts the NFS lock manager (NLM) on kernels that don't
    288        start it automatically.  However, since most kernels do start it
     301    <para>starts the <acronym>NFS</acronym> lock manager (<acronym>NLM</acronym>)
     302       on kernels that don't start it automatically.  However, since most kernels do start it
    289303       automatically it is usually not required.</para>
    290304    <indexterm zone="nfs-utils rpclockd">
    … …  
    297311  <term><command>rpc.mountd</command></term>
    298312  <listitem>
    299     <para>implements the NFS mount protocol on an NFS server.</para>
     313    <para>implements the <acronym>NFS</acronym> mount protocol on an
     314       <acronym>NFS</acronym> server.</para>
    300315    <indexterm zone="nfs-utils rpcmountd">
    301316      <primary sortas="b-rpcmountd">rpc.mountd</primary>
    … …  
    307322  <term><command>rpc.nfsd</command></term>
    308323  <listitem>
    309     <para>implements the user level part of the NFS service on the server.</para>
     324    <para>implements the user level part of the <acronym>NFS</acronym>
     325       service on the server.</para>
    310326    <indexterm zone="nfs-utils rpcnfsd">
    311327      <primary sortas="b-rpcnfsd">rpc.nfsd</primary>
    … …  
    318334  <listitem>
    319335    <para>is an rpc server which returns quotas for a user of a local file
    320        system which is mounted by a remote machine over the NFS.</para>
     336       system which is mounted by a remote machine over the <acronym>NFS</acronym>.</para>
    321337    <indexterm zone="nfs-utils rpcrquotad">
    322338      <primary sortas="b-rpcrquotad">rpc.rquotad</primary>
    … …  
    328344  <term><command>rpc.statd</command></term>
    329345  <listitem>
    330     <para>is used by the NFS file locking service, rpc.lockd, to implement
    331        lock recovery when the NFS server machine crashes and reboots. Runs
    332        on the NFS server only.</para>
     346    <para>is used by the <acronym>NFS</acronym> file locking service,
     347       <command>rpc.lockd</command>, to implement lock recovery when the
     348       <acronym>NFS</acronym> server machine crashes and reboots. Runs
     349       on the <acronym>NFS</acronym> server only.</para>
    333350    <indexterm zone="nfs-utils rpcstatd">
    334351      <primary sortas="b-rpcstatd">rpc.statd</primary>
    … …  
    340357  <term><command>showmount</command></term>
    341358  <listitem>
    342     <para>displays mount information for an NFS server.</para>
     359    <para>displays mount information for an <acronym>NFS</acronym> server.</para>
    343360    <indexterm zone="nfs-utils showmount">
    344361      <primary sortas="b-showmount">showmount</primary>
Note: See TracChangeset for help on using the changeset viewer.