Changeset eaf6a1cd for server/major/nfs-utils.xml
- Timestamp:
- 04/23/2005 06:02:51 PM (19 years ago)
- 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
- File:
-
- 1 edited
Legend:
- Unmodified
- Added
- Removed
-
server/major/nfs-utils.xml
ra16cb066 reaf6a1cd 23 23 24 24 <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 userspace25 <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 32 32 server and client tools necessary to use the kernel's nfs-abilities. 33 33 <acronym>NFS</acronym> is a protocol that allows sharing file systems over the … … 44 44 </itemizedlist> 45 45 46 <bridgehead renderas="sect3"> nfs-utils Dependencies</bridgehead>46 <bridgehead renderas="sect3">NFS Utilities Dependencies</bridgehead> 47 47 <bridgehead renderas="sect4">Required</bridgehead> 48 48 … … 57 57 </sect2> 58 58 59 <sect2 id='nfs-utils-kernel'>59 <sect2 role="kernel" id='nfs-utils-kernel'> 60 60 <title>Kernel Configuration</title> 61 61 … … 63 63 and recompile the kernel if neccessary:</para> 64 64 65 <screen> File systems:65 <screen><literal>File systems: 66 66 Network File Systems: 67 67 NFS File System Support: M or Y 68 NFS Server Support: M or Y</ screen>68 NFS Server Support: M or Y</literal></screen> 69 69 70 70 <para>Select the appropriate sub-options that appear when the above options … … 76 76 </sect2> 77 77 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 && 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 82 class="username">nobody</systemitem> user and <systemitem 83 class="groupname">nogroup</systemitem> group are available. You can add these by 84 running the following commands as the <systemitem class="username">root</systemitem> 85 user:</para> 86 87 <screen role="root"><userinput>groupadd -g 99 nogroup && 88 useradd -c nobody -d /home -g nogroup -s /bin/bash -u 99 nobody</userinput></screen> 87 89 88 90 <note><para>The classic uid and gid values are 65534 which is also -2 when 89 91 interpreted 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> 92 some filesystems that do not have support for sparse files. The <systemitem 93 class="username">nobody</systemitem> and <systemitem 94 class="groupname">nogroup</systemitem> values have small impact. 95 The impact on a server is nil if the exports file is configured correctly. If it is misconfigured, 96 the impact is that a <command>ls -l</command> or <command>ps</command> listing 97 will show a uid or gid number of 65534 instead of a name. The client uses <systemitem 98 class="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> 97 102 98 103 <screen><userinput>./configure --prefix=/usr --sysconfdir=/etc \ … … 100 105 make</userinput></screen> 101 106 102 <para>Now, as the rootuser:</para>107 <para>Now, as the <systemitem class="username">root</systemitem> user:</para> 103 108 104 109 <screen role='root'><userinput>make install</userinput></screen> 105 110 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 114 an additional parameter <option>--sbindir=/sbin</option> to the above 109 115 <command>./configure</command> command.</para></note> 110 116 … … 115 121 116 122 <para><parameter>--disable-nfsv4</parameter>: Disbles support 117 for NFSVersion 4.</para>123 for <acronym>NFS</acronym> Version 4.</para> 118 124 119 125 <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 138 the syntax of this file. Also refer to the "NFS HowTo" available at <ulink 132 139 url="http://nfs.sourceforge.net/nfs-howto/"/> on how to configure the servers 133 140 and clients in a secure manner. For example, for sharing the 134 <filename >/home</filename> directory over the local network, the following line141 <filename class="directory">/home</filename> directory over the local network, the following line 135 142 may be added:</para> 136 143 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> 138 145 139 146 <indexterm zone="nfs-utils nfs-utils-server-config"> … … 145 152 the server at boot.</para> 146 153 147 <screen ><userinput><command>make install-nfs-server</command></userinput></screen>154 <screen role="root"><userinput>make install-nfs-server</userinput></screen> 148 155 149 156 <indexterm zone="nfs-utils nfs-utils-server-config"> … … 154 161 configuration file:</para> 155 162 156 <screen ><userinput><command>cat > /etc/sysconfig/nfs-server << "EOF"</command>157 PORT="2049"163 <screen role="root"><userinput>cat > /etc/sysconfig/nfs-server << "EOF" 164 <literal>PORT="2049" 158 165 PROCESSES="8" 159 166 QUOTAS="no" 160 KILLDELAY="10" 161 <command>EOF</command></userinput></screen>167 KILLDELAY="10"</literal> 168 EOF</userinput></screen> 162 169 163 170 <indexterm zone="nfs-utils nfs-utils-server-config"> … … 165 172 </indexterm> 166 173 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 170 179 directories that are to be mounted on the client. Alternately the partitions 171 180 can be mounted by using the <command>mount</command> command with the proper 172 options. To mount the <filename>/home</filename> and <filename>/usr</filename> 181 options. To mount the <filename class="directory">/home</filename> and 182 <filename class="directory">/usr</filename> 173 183 partitions, add the following to the <filename>/etc/fstab</filename>:</para> 174 184 175 <screen ><userinput><server-name>:/home /home nfs rw,_netdev,rsize=8192,wsize=8192 0 0185 <screen role="root"><userinput><server-name>:/home /home nfs rw,_netdev,rsize=8192,wsize=8192 0 0 176 186 <server-name>:/usr /usr nfs ro,_netdev,rsize=8192 0 0</userinput></screen> 177 187 … … 186 196 start the client services at boot.</para> 187 197 188 <screen ><userinput><command>make install-nfs-client</command></userinput></screen>198 <screen role="root"><userinput>make install-nfs-client</userinput></screen> 189 199 190 200 <indexterm zone="nfs-utils nfs-utils-client-config"> … … 192 202 </indexterm> 193 203 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, 205 clients will also need to install the <filename>netfs</filename> bootscript as described in 206 <xref linkend='postlfs-config-netfs'/>.</para> 196 207 197 208 <indexterm zone="nfs-utils nfs-utils-client-config"> … … 199 210 </indexterm> 200 211 201 </sect2> 202 203 <sect2> 212 </sect3> 213 214 </sect2> 215 216 <sect2 role="content"> 204 217 <title>Contents</title> 205 218 <segmentedlist> 206 <segtitle>Installed Program is</segtitle>219 <segtitle>Installed Programs</segtitle> 207 220 <segtitle>Installed Libraries</segtitle> 208 221 <segtitle>Installed Directories</segtitle> … … 210 223 <seglistitem> 211 224 <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> 213 226 <seg>None</seg> 214 227 <seg>/var/lib/nfs</seg> … … 224 237 <term><command>exportfs</command></term> 225 238 <listitem> 226 <para>maintains a list of NFSexported file systems.</para>239 <para>maintains a list of <acronym>NFS</acronym> exported file systems.</para> 227 240 <indexterm zone="nfs-utils exportfs"> 228 241 <primary sortas="b-exportfs">exportfs</primary> … … 234 247 <term><command>nfsstat</command></term> 235 248 <listitem> 236 <para>prints NFSstatistics.</para>249 <para>prints <acronym>NFS</acronym> statistics.</para> 237 250 <indexterm zone="nfs-utils nfsstat"> 238 251 <primary sortas="b-nfsstat">nfsstat</primary> … … 244 257 <term><command>nhfsgraph</command></term> 245 258 <listitem> 246 <para>runs nhfsstoneover multiple loads.</para>259 <para>runs <command>nhfsstone</command> over multiple loads.</para> 247 260 <indexterm zone="nfs-utils nhfsgraph"> 248 261 <primary sortas="b-nhfsgraph">nhfsgraph</primary> … … 254 267 <term><command>nhfsnums</command></term> 255 268 <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> 257 271 <indexterm zone="nfs-utils nhfsnums"> 258 272 <primary sortas="b-nhfsnums">nhfsnums</primary> … … 264 278 <term><command>nhfsrun</command></term> 265 279 <listitem> 266 <para>executes nhfsstonewith a range of different loads.</para>280 <para>executes <command>nhfsstone</command> with a range of different loads.</para> 267 281 <indexterm zone="nfs-utils nhfsrun"> 268 282 <primary sortas="b-nhfsrun">nhfsrun</primary> … … 274 288 <term><command>nhfsstone</command></term> 275 289 <listitem> 276 <para>is used on a NFSclient to generate an artificial load with a277 particular mix of NFSoperations.</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> 278 292 <indexterm zone="nfs-utils nhfsstone"> 279 293 <primary sortas="b-nhfsstone">nhfsstone</primary> … … 285 299 <term><command>rpc.lockd</command></term> 286 300 <listitem> 287 <para>starts the NFS lock manager (NLM) on kernels that don't288 start it automatically. However, since most kernels do start it301 <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 289 303 automatically it is usually not required.</para> 290 304 <indexterm zone="nfs-utils rpclockd"> … … 297 311 <term><command>rpc.mountd</command></term> 298 312 <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> 300 315 <indexterm zone="nfs-utils rpcmountd"> 301 316 <primary sortas="b-rpcmountd">rpc.mountd</primary> … … 307 322 <term><command>rpc.nfsd</command></term> 308 323 <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> 310 326 <indexterm zone="nfs-utils rpcnfsd"> 311 327 <primary sortas="b-rpcnfsd">rpc.nfsd</primary> … … 318 334 <listitem> 319 335 <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> 321 337 <indexterm zone="nfs-utils rpcrquotad"> 322 338 <primary sortas="b-rpcrquotad">rpc.rquotad</primary> … … 328 344 <term><command>rpc.statd</command></term> 329 345 <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> 333 350 <indexterm zone="nfs-utils rpcstatd"> 334 351 <primary sortas="b-rpcstatd">rpc.statd</primary> … … 340 357 <term><command>showmount</command></term> 341 358 <listitem> 342 <para>displays mount information for an NFSserver.</para>359 <para>displays mount information for an <acronym>NFS</acronym> server.</para> 343 360 <indexterm zone="nfs-utils showmount"> 344 361 <primary sortas="b-showmount">showmount</primary>
Note:
See TracChangeset
for help on using the changeset viewer.