Converting an Unshared File System to a Shared File System

To perform initial installation and configuration for a shared file system, follow the instructions in Chapter 5, Installing Sun QFS and SAM-QFS, in Sun QFS and Sun Storage Archive Manager 5.3 Installation Guide. Many examples in this section use host names and configuration information that were introduced in that document.

Converting an unshared file system to a shared file system consists of two tasks:

• Converting the metadata server.

• Adding each client to the metadata server. This section describes these procedures.

How to Convert an Unshared Metadata Server to a Shared Metadata Server

You must have root permission to complete the steps in this procedure.

1. As superuser, log in to the system to be used as the primary metadata server.
2. (Optional) Back up all site-customized system files and configuration files.

   Depending on your software, these files might include the mcf, archiver.cmd, defaults.conf, samfs.cmd, or inquiry.conf files. Back up these files for all file systems. Also make sure that you have backup copies of files in the /etc/opt/SUNWsamfs directory and in the /var/opt/SUNWsamfs directory.

3. Ensure that each file system to be modified is backed up.

   File systems should be backed up regularly according to your site's policies. If you are comfortable with the backup files that already exist for your file systems, you do not need to back them up again now.

4. Unmount the file system.

   For instructions, see Unmounting File Systems in Sun QFS and Sun Storage Archive Manager 5.3 Installation Guide.

5. Convert the file system to a Sun QFS shared file system using the samfsck -S -F family-set-name command.

   For family-set-name, specify the family set name of the file system that you are converting to a new shared file system. For example:

   # samfsck -S -F sharefs1

6. In the /etc/opt/SUNWsamfs/mcf file, add the shared keyword in the file system's Additional Parameters field.

   For example:

   # Equipment Eq Eq Family Dev Add
   # Identifier Ord Type Set State Params
   # ---------- --- ---- ------ ----- ------
   sharefs1 10 ma sharefs1 on shared
   /dev/dsk/c2t50020F23000065EEd0s6 11 mm sharefs1 on
   /dev/dsk/c7t50020F2300005D22d0s6 12 mr sharefs1 on
   /dev/dsk/c7t50020F2300006099d0s6 13 mr sharefs1 on
   /dev/dsk/c7t50020F230000651Cd0s6 14 mr sharefs1 on

7. In the /etc/vfstab file, add the shared keyword in the file system's Mount Parameters field.

   For example:

   # File /etc/vfstab
   # FS name FS to fsck Mnt pt FS type fsck pass Mt@boot Mt params
   sharefs1 - /sharefs1 samfs - no shared

8. Create the /etc/opt/SUNWsamfs/hosts. fsname hosts configuration file.

   For example:

   # File /etc/opt/SUNWsamfs/hosts.sharefs1
   # Host     Host      IP               Server    Not  Server
   # Name       Addresses                Priority  Used Host
   # ---- ------------------------------ -------- ---- -----
   titan   titan-ge                       0 1 - server
   tethys  tethys-ge                      0 2 - server

   See Creating the Shared Hosts File on the Metadata Server in Using Sun QFS and Sun Storage Archive Manager with Oracle Solaris Cluster for more information about creating the hosts configuration file.

9. Run the samsharefs -u -R family-set-name command to initialize the file system and the host configuration.

   For example:

   # samsharefs -u -R sharefs1

   ---

   Note - If you see an error message from this command, you can probably ignore the message.

   ---

10. Notify the sam-fsd daemon of the configuration changes by issuing the samd config command.

    # samd config

11. Mount the file system.

How to Add a Client to the Metadata Server

1. Create the mount point for the file system.

   For example:

   # mkdir /sharefs1

2. (Optional) Create an /etc/opt/SUNWsamfs/hosts. file-system-name .local local hosts configuration file.

   You might want to perform this step if your Sun QFS shared host systems have multiple host interfaces. The local hosts configuration file defines the host interfaces that the metadata server and the client hosts can use when accessing the file system. You use this file to specify how file system traffic should flow over public and private networks in your environment.

   The following code example shows a sample local hosts configuration file.

   # This is file /etc/opt/SUNWsamfs/hosts.sharefs1.local
   # Host Name Host Interfaces
   # --------- ---------------
   titan 172.16.0.129
   tethys 172.16.0.130

   For more information on creating the local hosts file, see Creating the Local Hosts Configuration File.

3. If you want to move files from an existing Sun QFS file system into a new Sun QFS shared file system, ensure that each file system to be modified is backed up.

   File systems should be backed up regularly according to your site's policies. If you are comfortable with the backup files that already exist for your file systems, you do not need to back them up again now.

4. Unmount the file system.

   For instructions, see Unmounting File Systems in Sun QFS and Sun Storage Archive Manager 5.3 Installation Guide.

5. In the /etc/vfstab file, add the shared keyword in the file system's Mount Parameters field.

   For example:

   # File /etc/vfstab
   # FS name FS to fsck Mnt pt FS type fsck pass Mt@boot Mt params
   sharefs1 - /sharefs1 samfs - no *shared*

6. Create the /etc/opt/SUNWsamfs/hosts. fsname hosts configuration file.

   The following code example shows a sample file.

   # File /etc/opt/SUNWsamfs/hosts.sharefs1
   # Host Host IP Server Not Server
   # Name Addresses Priority Used Host
   # ---- --------- -------- ---- -----
   titan titan-ge0 1 - server
   tethys tethys-ge0 2 - server

   For more information about creating the hosts configuration file, see Creating the Shared Hosts File on the Metadata Server in Using Sun QFS and Sun Storage Archive Manager with Oracle Solaris Cluster.