Difference between revisions of "Setting up an NFS File Server"

From wiki.emacinc.com
Jump to: navigation, search
m (Added note for new section to add.)
m (Fixed a couple inconsistent spacing issues)
 
(2 intermediate revisions by 2 users not shown)
Line 1: Line 1:
−
{{todo|Revise (12.19.13-11:10->MD+);(12.19.13-15:45->KY+);(12.30.13-19:15->MG+);(03.06.14-15:15->BS-);(04.11.14-13:00->BS+)|Mike Dean|project=oe 4,oe 5,md,ky,mg,bs}}
+
{{todo|Complete (12.19.13-11:10->MD+);(12.19.13-15:45->KY+);(12.30.13-19:15->MG+);(03.06.14-15:15->BS-);(04.11.14-13:00->BS+);(11.06.15-13:15->MD+);(11.06.15-13:40->MG+);(11.06.15-14:23->KY+)|Mike Dean|project=oe 4,oe 5,md,ky,mg,bs,Complete}}
−
 
 
 
{{#seo:
 
{{#seo:
 
|title=Setting up an NFS File Server
 
|title=Setting up an NFS File Server
Line 7: Line 6:
 
|description=An NFS file server can provide a variety of services to Linux machines on a network.
 
|description=An NFS file server can provide a variety of services to Linux machines on a network.
 
}}
 
}}
−
An NFS file server can provide a variety of services to Linux machines on a network.  It can provide a place to store files for a machine to use or write to, it can be used to allow machines to boot a root filesystem image stored on the NFS server, it can provide a place to store filesystem images when they're captured from MTD flash, or it can be connected to a desktop system to provide a common file store.
+
An NFS file server can provide a variety of services to Linux machines on a network.  It can provide a place to store files for a machine to use or to write to, it can be used to allow machines to boot a root filesystem image stored on the NFS server, it can provide a place to store filesystem images when they're captured from MTD flash, or it can be connected to a desktop system to provide a common file store.
  
 
NFS stands for Network File System.  NFS has been in existence since 1984, and is now on version 4.1.  Sun Microsystems was the original developer behind NFS, creating the first version in 1984 but only using it internally for the first five years.  Version 2 was released in 1989, and was the first version Sun released to the public.  Version 3 was released in 1995, and added support for files larger than 2 GB, asynchronous writes, performance improvements and support for TCP.  Version 4 was released in late 2000 and includes enhancements which are mostly useful for servers.  Version 4.1 was released in 2010, and includes enhancements for clustered server usage.  Version 4.2 is currently in development.  For embedded use, version 3 works well and is simpler to configure than version 4, so version 3 is described here.
 
NFS stands for Network File System.  NFS has been in existence since 1984, and is now on version 4.1.  Sun Microsystems was the original developer behind NFS, creating the first version in 1984 but only using it internally for the first five years.  Version 2 was released in 1989, and was the first version Sun released to the public.  Version 3 was released in 1995, and added support for files larger than 2 GB, asynchronous writes, performance improvements and support for TCP.  Version 4 was released in late 2000 and includes enhancements which are mostly useful for servers.  Version 4.1 was released in 2010, and includes enhancements for clustered server usage.  Version 4.2 is currently in development.  For embedded use, version 3 works well and is simpler to configure than version 4, so version 3 is described here.
Line 21: Line 20:
 
On Ubuntu, Debian, and similar systems, the services and tools required by an NFS server can be installed with the following command:
 
On Ubuntu, Debian, and similar systems, the services and tools required by an NFS server can be installed with the following command:
  
−
user@ldc:~$ sudo apt-get install nfs-kernel-server nfs-common portmap
+
{{ cli | username=user | hostname=ldc |sudo apt-get install nfs-kernel-server nfs-common portmap}}
  
 
On other distributions, check with your package manager for similar packages.
 
On other distributions, check with your package manager for similar packages.
Line 41: Line 40:
  
 
* ''location'' - specifies the directory on the NFS server's filesystem which will be exported as an NFS share.
 
* ''location'' - specifies the directory on the NFS server's filesystem which will be exported as an NFS share.
−
* ''address'' - specifies an IP address, a range of IP addresses, a hostname or a hostname wildcard of machine(s) which are allowed to connect to this NFS share.
+
* ''address'' - specifies an IP address, a range of IP addresses, a hostname, or a hostname wildcard of machine(s) which are allowed to connect to this NFS share.
 
* ''options'' - the list of options gathered above.  Each option is separated by a comma, with no spaces.
 
* ''options'' - the list of options gathered above.  Each option is separated by a comma, with no spaces.
  
Line 58: Line 57:
 
Adding any of the lines listed above will create the NFS share specified by the line, assuming the directory specified in the line exists.  After adding an export line to <code>/etc/exports</code>, run the following command to notify the NFS server of the configuration change:
 
Adding any of the lines listed above will create the NFS share specified by the line, assuming the directory specified in the line exists.  After adding an export line to <code>/etc/exports</code>, run the following command to notify the NFS server of the configuration change:
  
−
user@ldc:~$ exportfs -a
+
{{cli | hostname=ldc | username=user |exportfs -a}}
−
 
 
  
 
==Testing==
 
==Testing==
Line 65: Line 63:
 
In order to test to ensure that an NFS share was exported correctly, an NFS client needs to be installed on a second machine.  If this machine is an EMAC board, the NFS client software should already be installed.  On a Debian or Ubuntu system, the following command will install the needed packages:
 
In order to test to ensure that an NFS share was exported correctly, an NFS client needs to be installed on a second machine.  If this machine is an EMAC board, the NFS client software should already be installed.  On a Debian or Ubuntu system, the following command will install the needed packages:
  
−
user@ldc:~$ sudo apt-get install nfs-common portmap
+
{{ cli | username=user | hostname=ldc |sudo apt-get install nfs-common portmap}}
  
 
Now, to mount the <code>/srv/fs</code> share exported above with a server address of <code>192.168.1.20</code> on the local directory, /srv/nfs:
 
Now, to mount the <code>/srv/fs</code> share exported above with a server address of <code>192.168.1.20</code> on the local directory, /srv/nfs:
  
−
user@ldc:~$ sudo mount 192.168.1.20:/srv/fs /srv/nfs
+
{{ cli | username=user | hostname=ldc |sudo mount -o nolock 192.168.1.20:/srv/fs /srv/nfs}}
  
 
To verify that it mounted:
 
To verify that it mounted:
  
−
user@ldc:~$ mount
+
{{clo}}
−
...
+
{{ clio | username=user | hostname=ldc |mount}}
−
192.168.1.20:/srv/fs on /srv/nfs type nfs (ro,vers=3,addr=192.168.1.20,clientaddr=192.168.1.142)
+
...<br />
 +
192.168.1.20:/srv/fs on /srv/nfs type nfs (ro,vers=3,addr=192.168.1.20,clientaddr=192.168.1.142)<br />
 +
...<br />
 +
{{ clio | username=user | hostname=ldc |}}
 +
{{clos}}
  
 
In the output is the line which shows the mount.  The files in the directory can be listed:
 
In the output is the line which shows the mount.  The files in the directory can be listed:
  
−
user@ldc:~$ ls /srv/nfs
+
{{clo}}
−
filea fileb filec filed
+
{{ clio | username=user | hostname=ldc |ls /srv/nfs}}
 +
filea fileb filec filed
 +
{{ clio | username=user | hostname=ldc |}}
 +
 
 +
{{clos}}
  
 
==Configuring a Client==
 
==Configuring a Client==
Line 96: Line 102:
 
After a line is entered into the <code>/etc/fstab</code> file, it can be mounted either this way:
 
After a line is entered into the <code>/etc/fstab</code> file, it can be mounted either this way:
  
−
user@ldc:~$ sudo mount -a
+
{{ cli | username=user | hostname=ldc |sudo mount -a}}
  
 
or this way:
 
or this way:
  
−
user@ldc:~$ sudo mount /srv/nfs
+
{{ cli | username=user | hostname=ldc |sudo mount /srv/nfs}}
  
 
If there is an error, check to ensure the directory for the mount on the client machine exists.  For a share which is mounted <code>rw</code>, the <code>touch</code> command can be used to create an empty file in the NFS share from the client machine.  For example:
 
If there is an error, check to ensure the directory for the mount on the client machine exists.  For a share which is mounted <code>rw</code>, the <code>touch</code> command can be used to create an empty file in the NFS share from the client machine.  For example:
  
−
user@ldc:~$ touch /srv/logs/test_file
+
{{ clo }}
−
user@ldc:~$ ls /srv/logs
+
{{ clio | username=user | hostname=ldc |touch /srv/logs/test_file}}
−
test_file
+
{{ clio | username=user | hostname=ldc |ls /srv/logs}}
 +
test_file
 +
{{ clio | username=user | hostname=ldc |}}
 +
{{ clos }}
  
 
==Mounting an NFS Filesystem Temporarily==
 
==Mounting an NFS Filesystem Temporarily==
  
−
  '''''TODO'''''
+
The method of mounting an NFS share which was shown in the Testing section, above, is the method used to temporarily mount a filesystem. Temporarily, here, means that it will stay mounted until either the <code>umount</code> command is called on the mountpoint, or the system is rebooted.
 +
 
 +
{{ cli | username=user | hostname=ldc |sudo mount -o nolock 192.168.1.20:/srv/fs /srv/nfs}}
 +
 
 +
 
 +
In this example, the mountpoint is <code>/srv/nfs</code>.
  
 
==Summary==
 
==Summary==
  
 
The NFS filesystem is useful for making files available to remote machines, whether the client machines only need to be able to read them or write to them.  A use of NFS shares which is very helpful for embedded systems is to provide a network root filesystem.  See [[Booting with an NFS Root Filesystem]] for more information.
 
The NFS filesystem is useful for making files available to remote machines, whether the client machines only need to be able to read them or write to them.  A use of NFS shares which is very helpful for embedded systems is to provide a network root filesystem.  See [[Booting with an NFS Root Filesystem]] for more information.

Latest revision as of 14:25, 6 November 2015

TODO: {{#todo:Complete (12.19.13-11:10->MD+);(12.19.13-15:45->KY+);(12.30.13-19:15->MG+);(03.06.14-15:15->BS-);(04.11.14-13:00->BS+);(11.06.15-13:15->MD+);(11.06.15-13:40->MG+);(11.06.15-14:23->KY+)|Mike Dean|oe 4,oe 5,md,ky,mg,bs,Complete}}

An NFS file server can provide a variety of services to Linux machines on a network. It can provide a place to store files for a machine to use or to write to, it can be used to allow machines to boot a root filesystem image stored on the NFS server, it can provide a place to store filesystem images when they're captured from MTD flash, or it can be connected to a desktop system to provide a common file store.

NFS stands for Network File System. NFS has been in existence since 1984, and is now on version 4.1. Sun Microsystems was the original developer behind NFS, creating the first version in 1984 but only using it internally for the first five years. Version 2 was released in 1989, and was the first version Sun released to the public. Version 3 was released in 1995, and added support for files larger than 2 GB, asynchronous writes, performance improvements and support for TCP. Version 4 was released in late 2000 and includes enhancements which are mostly useful for servers. Version 4.1 was released in 2010, and includes enhancements for clustered server usage. Version 4.2 is currently in development. For embedded use, version 3 works well and is simpler to configure than version 4, so version 3 is described here.

NFS Server Fundamentals

An NFS server requires some services to run. These are a portmapper daemon, RPC support, and a security service. NFS also requires tools, both for monitoring and for mounting filesystems. Finally, NFS servers require a configuration file.

NFS Services and Tools

On Ubuntu, Debian, and similar systems, the services and tools required by an NFS server can be installed with the following command:

user@ldc:~# sudo apt-get install nfs-kernel-server nfs-common portmap

On other distributions, check with your package manager for similar packages.

Configuring the NFS Server

The NFS server's shares are configured in the /etc/exports file. Each share takes a list of option names to configure its behavior. Before configuring the NFS server, the following decisions need to be made (and a list of options created) based on the intended use(s) of the NFS share being created:

  • Do NFS clients need the ability to write to the NFS share? If so, it needs to be exported rw. Otherwise, export it as ro
  • If the filesystem will be writeable, is performance or data integrity more important? If performance, async will provide more performance at the risk of lost or corrupt data should the NFS server shut down unexpectedly during a write operation. Otherwise, sync should be used.
  • Is reliability or security more important? If reliability is, use no_subtree_check. Otherwise, use subtree_check.
  • Is user level access control required? If not, getting the NFS server working is much simpler with the no_root_squash option.

Once the above decisions have been made for a share that's being created, the new NFS share needs to be configured in the /etc/exports file. There are three parts to the configuration line that specifies a share: 

location     address(options)

Here:

  • location - specifies the directory on the NFS server's filesystem which will be exported as an NFS share.
  • address - specifies an IP address, a range of IP addresses, a hostname, or a hostname wildcard of machine(s) which are allowed to connect to this NFS share.
  • options - the list of options gathered above. Each option is separated by a comma, with no spaces.

For example, to export the /srv/fs directory to all machines on a 192.168.1.0/24 network, read-only, with reliability and performance options turned on: 

/srv/fs      192.168.1.0/255.255.255.0(ro,async,no_subtree_check,no_root_squash)

To export the /srv/logs/ directory as a writeable NFS share with data integrity and reliability options on the 10.0.0.0/8 network: 

/srv/logs    10.0.0.0/255.0.0.0(rw,sync,no_root_squash)

To export the /srv/homes directory as a writeable NFS share with data integrity, reliability and user level access control on the 172.16.0.0/16 network: 

/srv/homes    172.16.0.0/255.255.0.0(rw,sync)

Adding any of the lines listed above will create the NFS share specified by the line, assuming the directory specified in the line exists. After adding an export line to /etc/exports, run the following command to notify the NFS server of the configuration change:

user@ldc:~# exportfs -a

Testing

In order to test to ensure that an NFS share was exported correctly, an NFS client needs to be installed on a second machine. If this machine is an EMAC board, the NFS client software should already be installed. On a Debian or Ubuntu system, the following command will install the needed packages:

user@ldc:~# sudo apt-get install nfs-common portmap

Now, to mount the /srv/fs share exported above with a server address of 192.168.1.20 on the local directory, /srv/nfs:

user@ldc:~# sudo mount -o nolock 192.168.1.20:/srv/fs /srv/nfs

To verify that it mounted:

user@ldc:~# mount

...
192.168.1.20:/srv/fs on /srv/nfs type nfs (ro,vers=3,addr=192.168.1.20,clientaddr=192.168.1.142)
...

user@ldc:~#

In the output is the line which shows the mount. The files in the directory can be listed:

user@ldc:~# ls /srv/nfs

filea fileb filec filed

user@ldc:~#

Configuring a Client

In the testing section is shown a method of mounting an NFS share on a temporary basis. For many uses of an NFS server, however, having the NFS client automatically mount the NFS share on boot is preferred (or required). To enable this behavior, the NFS share needs to be configured rather than mounted directly.

The /etc/fstab file provides information to the operating system regarding what devices need to be mounted where. fstab stands for, "Filesystem Table." Each line of the file represents one mountpoint. To configure a system to mount an NFS share on boot, a line needs to be added to this file similar to the following: 

192.168.1.20:/srv/fs  /srv/nfs   nfs    ro,async 0 0

The above line configures the client system to connect to the /srv/fs share from the example in the configuring section above. To mount the /srv/logs share from the same section: 

10.0.0.30:/srv/logs  /srv/logs  nfs  rw,sync   0 0

After a line is entered into the /etc/fstab file, it can be mounted either this way:

user@ldc:~# sudo mount -a

or this way:

user@ldc:~# sudo mount /srv/nfs

If there is an error, check to ensure the directory for the mount on the client machine exists. For a share which is mounted rw, the touch command can be used to create an empty file in the NFS share from the client machine. For example:

user@ldc:~# touch /srv/logs/test_file
user@ldc:~# ls /srv/logs

test_file

user@ldc:~#

Mounting an NFS Filesystem Temporarily

The method of mounting an NFS share which was shown in the Testing section, above, is the method used to temporarily mount a filesystem. Temporarily, here, means that it will stay mounted until either the umount command is called on the mountpoint, or the system is rebooted.

user@ldc:~# sudo mount -o nolock 192.168.1.20:/srv/fs /srv/nfs


In this example, the mountpoint is /srv/nfs.

Summary

The NFS filesystem is useful for making files available to remote machines, whether the client machines only need to be able to read them or write to them. A use of NFS shares which is very helpful for embedded systems is to provide a network root filesystem. See Booting with an NFS Root Filesystem for more information.

Retrieved from "https://wiki.emacinc.com/index.php?title=Setting_up_an_NFS_File_Server&oldid=4998"