Scott at 00:10, 15 February 2011

2011-02-15T00:10:41Z

New page

{{lowercase title}}

== Install ==
* for server:
<pre>
apt-get install nfs-kernel-server
</pre>
* for client:
<pre>
apt-get install nfs-common
</pre>

== Common Setup ==
* In <tt>/etc/default/nfs-common</tt> set:
<pre>
NEED_IDMAPD=yes
NEED_GSSD=no
</pre>
* Edit <tt>/etc/idmapd.conf</tt>:
<pre>
Domain = mydomain.com
</pre>
* Restart the <tt>nfs-common</tt> service:
<pre>
sudo /etc/init.d/nfs-common restart
</pre>

== Server Setup ==
* In <tt>/etc/default/nfs-kernel-server</tt> set:
<pre>
NEED_SVCGSSD=no
</pre>
* Edit <tt>/etc/exports</tt> to look something like this:
<pre>
/export/nfs \
123.45.67.12(rw,sync,insecure,no_subtree_check,anonuid=65534,anongid=65534,fsid=0) \
123.45.67.13(rw,sync,insecure,no_subtree_check,anonuid=65534,anongid=65534,fsid=0) \
...
</pre>
* Export options: http://linux.die.net/man/5/exports
** sync vs async - Always use sync. This asks the server to write data immediately, important when crashes are possible
* restart the services:
<pre>
/etc/init.d/nfs-kernel-server restart
/etc/init.d/nfs-common restart
</pre>
* Allow clients to access TCP port 2049. Example:
<pre>
iptables -A INPUT --protocol tcp --dport 2049 --source 123.45.67.89 -m state --state NEW -j ACCEPT
</pre>
=== Important Note ===
There is a problem with the NFS server under Ubuntu versions ''before'' 9.04 (Jaunty). Whenever the file server gets rebooted, you need to immediately log in and restart the <tt>nfs-common</tt> service:
<pre>
sudo /etc/init.d/nfs-common restart
</pre>

== Client Setup ==
* Create the mounting directory:
<pre>
mkdir /nfs
</pre>
* For a static mount, add something like this to <tt>/etc/fstab</tt>:
<pre>
123.45.67.10:/ /nfs nfs4 rw,hard,intr,proto=tcp,port=2049 0 0
</pre>

=== Automounting on the client ===
Follow the instructions at [[autofs]].

== Troubleshooting ==
* https://help.ubuntu.com/community/NFSv4Howto
* Did you add an exception to the firewall?
* If user/group id's are showing up as <tt>nobody</tt> on the client, you need to restart the <tt>nfs-common</tt> service on the server:
<pre>
sudo /etc/init.d/nfs-common restart
</pre>
* User and group ids must be the same on both client and server. This may be achieved either through passwd/group files or through LDAP.
* Both client and server should be using ntp to sync clocks.
* Use these commands to monitor NFS activity:
<pre>
rpcinfo -p
netstat -tupa
</pre>
* Check NFS mount options by viewing <code>/proc/mounts</code>.
* You can get a "Stale NFS file handle" error if the NFS server goes down for awhile. The best solution is to completely unmount and remount, but if you can't unmount, just remount over the existing mount anyway.

Nfs4 - Revision history

Scott at 00:10, 15 February 2011