Automatic File System Sharing

Servers provide access to their file systems by sharing the file systems over the NFS environment. You specify which file systems are to be shared with the share command or with the /etc/dfs/dfstab file.

Entries in the /etc/dfs/dfstab file are shared automatically whenever you start NFS server operation. You should set up automatic sharing if you need to share the same set of file systems on a regular basis. For example, if your computer is a server that supports home directories, you need to make the home directories available at all times. Most file system sharing should be done automatically. The only time that manual sharing should occur is during testing or troubleshooting.

The dfstab file lists all the file systems that your server shares with its clients. This file also controls which clients can mount a file system. You can modify dfstab to add or delete a file system or change the way sharing occurs. Just edit the file with any text editor that is supported (such as vi). The next time that the computer enters run level 3, the system reads the updated dfstab to determine which file systems should be shared automatically.

Each line in the dfstab file consists of a share command, the same command that you type at the command-line prompt to share the file system. The share command is located in /usr/sbin.

Table 5-1 File-System Sharing Task Map

How to Set Up Automatic File-System Sharing

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. Add entries for each file system to be shared.

   Edit /etc/dfs/dfstab. Add one entry to the file for every file system that you want to be automatically shared. Each entry must be on a line by itself in the file and use this syntax:

   share [-F nfs] [-o specific-options] [-d description] pathname

   See the dfstab(4) man page for a description of /etc/dfs/dfstab and the share_nfs(1M) man page for a complete list of options.

3. Share the file system.

   After the entry is in /etc/dfs/dfstab, you can share the file system by either rebooting the system or by using the shareall command.

   # shareall

4. Verify that the information is correct.

   Run the share command to check that the correct options are listed:

   # share
   -        /export/share/man   ro   ""
   -        /usr/src     rw=eng   ""
   -        /export/ftp    ro,public  ""

See Also

The next step is to set up your autofs maps so that clients can access the file systems that you have shared on the server. See Task Overview for Autofs Administration.

How to Enable WebNFS Access

Starting with the Solaris 2.6 release, by default all file systems that are available for NFS mounting are automatically available for WebNFS access. The only condition that requires the use of this procedure is one of the following:

• To allow NFS mounting on a server that does not already allow NFS mounting

• To reset the public file handle to shorten NFS URLs by using the public option

• To force the loading of a specific HTML file by using the index option

See Planning for WebNFS Access for a list of issues to consider before starting the WebNFS service.

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. Add entries for each file system to be shared by using the WebNFS service.

   Edit /etc/dfs/dfstab. Add one entry to the file for every file system. The public and index tags that are shown in the following example are optional.

   share -F nfs -o ro,public,index=index.html /export/ftp

   See the dfstab(4) man page for a description of /etc/dfs/dfstab and the share_nfs(1M) man page for a complete list of options.

3. Share the file system.

   After the entry is in /etc/dfs/dfstab, you can share the file system by either rebooting the system or by using the shareall command.

   # shareall

4. Verify that the information is correct.

   Run the share command to check that the correct options are listed:

   # share
   -        /export/share/man   ro   ""
   -        /usr/src     rw=eng   ""
   -        /export/ftp    ro,public,index=index.html  ""

How to Enable NFS Server Logging

1. Become superuser or assume an equivalent role.

   Roles contain authorizations and privileged commands. For more information about roles, see Configuring RBAC (Task Map) in System Administration Guide: Security Services.

2. (Optional) Change file system configuration settings.

   In /etc/nfs/nfslog.conf, you can change the settings in one of two ways. You can edit the default settings for all file systems by changing the data that is associated with the global tag. Alternately, you can add a new tag for this file system. If these changes are not needed, you do not need to change this file. The format of /etc/nfs/nfslog.conf is described in nfslog.conf(4).

3. Add entries for each file system to be shared by using NFS server logging.

   Edit /etc/dfs/dfstab. Add one entry to the file for the file system on which you are enabling NFS server logging. The tag that is used with the log=tag option must be entered in /etc/nfs/nfslog.conf. This example uses the default settings in the global tag.

   share -F nfs -o ro,log=global /export/ftp

   See the dfstab(4) man page for a description of /etc/dfs/dfstab and the share_nfs(1M) man page for a complete list of options.

4. Share the file system.

   After the entry is in /etc/dfs/dfstab, you can share the file system by either rebooting the system or by using the shareall command.

   # shareall

5. Verify that the information is correct.

   Run the share command to check that the correct options are listed:

   # share
   -        /export/share/man   ro   ""
   -        /usr/src     rw=eng   ""
   -        /export/ftp    ro,log=global  ""

6. Check if nfslogd, the NFS log daemon, is running.

   # ps -ef | grep nfslogd

7. (Optional) Start nfslogd, if it is not running already.
   • (Optional) If /etc/nfs/nfslogtab is present, start the NFS log daemon by typing the following:

     # svcadm restart network/nfs/server:default

   • (Optional) If /etc/nfs/nfslogtab is not present, run any of the share commands to create the file and then start the daemon.

     # shareall
     # svcadm restart network/nfs/server:default