PRIMECLUSTER Global File Services Configuration and Administration Guide 4.2 (Solaris(TM) Operating Environment)

22.6.1 Changing an unmounted file system

This section explains the procedure for changing shared node information when the GFS Shared File System is unmounted.

22.6.1.1 Unmount

On all nodes, unmount the GFS Shared File System for which shared node information is to be changed.

For unmount details, see Section 22.2.4, "mount/umount/all nodes (u)mount" in this manual.

22.6.1.2 Setting shared disk

When a new-shared node is to be added, you must set the new node in the scope range of the disk class containing the GDS logical volumes that make up the file system for which node information is to be added.

For information on operating the disk class to which the GDS logical volumes belong, see the relevant items in "Operating on the management view" in the "PRIMECLUSTER Global Disk Services Configuration and Administration Guide."

22.6.1.3 Changing the management partition information

When a new-shared node is to be added, register the node information in the partition by first executing sfcsetup -a on the node to be added.

For details on registering node information to the management partition, see Section 20.3, "Adding node configuration information to the management partition" in this manual.

22.6.1.4 Changing the shared node information

The GFS Shared File System stores information about nodes that share the file system in each partition to restrict access from nodes other than the nodes that share the file system.

The node information mainly contains the following information:

• Host ID
• Host name

To add and delete node information for the file system, use sfcnode(1M).

For details on the sfcnode(1M) options, see Appendix F.2.15, "sfcnode(1M)."

22.6.1.4.1 Adding node information

To add node information for a file system, use sfcnode(1M). If you are adding node information while the file system is unmounted, you can execute sfcnode(1M) on either an existing shared node or on the node to be added.

Described below is the procedure for using sfcnode(1M) to add node information (star) to an existing file system (/dev/sfdsk/gfs01/rdsk/volume1).

1. Check that the target file system is unmounted on all nodes sharing the file system.

You can do this by checking that "STOP" is displayed in all status fields of the sfcinfo(1M) output.

# sfcinfo -n /dev/sfdsk/gfs01/dsk/volume1
/dev/sfdsk/gfs01/dsk/volume1:
FSID  hosted    status  hostname
   1  8038xxxx  STOP    sunny
   1  8038yyyy  STOP    moony

2. Add the node information.

# sfcnode -a star /dev/sfdsk/gfs01/rdsk/volume1

3. Confirm that the node information has been added.

You can do this by checking that the star field is newly displayed.

# sfcinfo -n /dev/sfdsk/gfs01/dsk/volume1
/dev/sfdsk/gfs01/dsk/volume1:
FSID  hostID    status  hostname
   1  8038xxxx  STOP    sunny
   1  8038yyyy  STOP    moony
   1  8038zzzz  STOP    star

If the MDS placement node setting for the file system is all, the added node is set as an MDS placement node.

If the MDS placement node setting for the file system is not all, use sfcadm(1M) to enable MDS operation on the added node.

For node changes that enable MDS operation, see Section 22.8.2, "Changing the MDS operational information."

22.6.1.4.2 Deleting node information

To delete node information for a file system, use sfcnode(1M). If you are deleting node information while the file system is unmounted, execute sfcnode(1M) on a node that shares the target file system.

Described below is the procedure for using sfcnode(1M) to delete node information (star) from an existing file system (/dev/sfdsk/gfs01/rdsk/volume1).

1. Check that the file system is unmounted in all nodes configuring the current file system and all nodes sharing the file system.

You can do this by checking that "STOP" is displayed in all status fields of the sfcinfo(1M) output.

# sfcinfo -n /dev/sfdsk/gfs01/dsk/volume1
/dev/sfdsk/gfs01/dsk/volume1:
FSID  hostID    status  hostname
   1  8038xxxx  STOP    sunny
   1  8038yyyy  STOP    moony
   1  8038zzzz  STOP    star

2. Delete the node information.

# sfcnode -d -h star /dev/sfdsk/gfs01/rdsk/volume1

3. Confirm that the node information has been deleted.

You can do this by checking that the star field is not displayed in the sfcinfo(1M) output.

# sfcinfo -n /dev/sfdsk/gfs01/dsk/volume1
/dev/sfdsk/gfs01/dsk/volume1:
FSID  hosted    status  hostname
   1  8038xxxx  STOP    sunny
   1  8038yyyy  STOP    moony

Node information about the primary MDS node and secondary MDS node cannot be deleted. Use sfcadm(1M) to change the primary MDS node or secondary MDS node to another node, then delete the related information.

22.6.1.5 Setting vfstab

In the GFS Shared File System, it is necessary to code an entry that is to be mounted on /etc/vfstab of all the nodes that share a file system.

For details on setting /etc/vfstab, see Section 22.2.3, "Setting vfstab."

22.6.1.5.1 If node information was added

An entry of the GFS Shared File System for which node information was added is added to /etc/vfstab of the added node.

22.6.1.5.2 If node information was deleted

An entry of the GFS Shared File System for which node information was deleted is deleted from /etc/vfstab of the deleted node.

22.6.1.6 Mount

After the shared node information has been modified, mount the file GFS Shared File system