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

B.2.2 sfxadm(1M) - Changes GFS Local File System partition information settings

[SYNOPSIS]

sfxadm [-r [-a]] raw_device_file,...
sfxadm -L size raw_device_file
sfxadm -A raw_device_file,...
sfxadm -D raw_device_file,...
sfxadm -U raw_device_file

[DESCRIPTION]

The sfxadm command changes the settings for GFS Local File System partition information.

GFS Local File System contains information on the file system component partitions in each of the partitions.

The partition information settings must be added or changed in the following cases:

• When the special file name of file system has changed
• When a file system is moved to another system
• When the size of a log area in a log partition is changed
• When the version of the file system is upgraded

When sfxadm is used to change partition configuration information for the GFS Local File System, the entry in /etc/sfxfstab will be updated and the information on the each partition will be changed.

[OPTIONS]

-r

This option is superblock and partition information restore.

Partition in the restoration origin become first partition specified by raw_device_file,...

-a

When the -r option is specified, performs the recovery using a copy of the super block and the partition configuration data in the partition of the recovery source. Use this option if the super block or the partition configuration data is broken.

raw_device_file, ...

This option specifies the character special device name for each partition in the GFS Local File System whose partition information is changed.

-L size raw_device_file

This option changes the size of log area in a log partition. In the size field, specify the size of the log area to be changed. This parameter is to be specified in megabyte. A value from 5 to 100 can be used here.

In the raw_device_file field, specify the character special device for the representative partition for the GFS Local File System in which log area size is to be changed.

-A raw_device_file,...

This option adds partition configuration information for the GFS Local File System to /etc/sfxfstab. In the raw_device_file field, specify all character special devices for partitions configuring the file system. At the beginning of the raw_device_file field, specify a representative partition.

At the beginning of the raw_device_file field, specify a representative partition. This option is used if a device cannot be opened on the standby node of the alternate file system. Before specifying this option, specify the -a option with sfxnode(1M) on an active node to set the node information.

-D raw_device_file,...

This option deletes partition configuration information for the GFS Local File System from /etc/sfxfstab. In the raw_device_file field, specify character special devices for partitions configuring the file system.

-U raw_device_file

This option upgrades the version of the GFS Local File System. In the raw_device_file field, specify a character special file for the representative partition of the GFS Local File System.

[EXAMPLE]

# sfxadm /dev/sfdsk/gfs/rdsk/vol0301,/dev/sfdsk/gfs/rdsk/vol0400,/dev/sfdsk/gfs/rdsk/vol0500,/dev/sfdsk/gfs/rdsk/vol0601

When a file system is configured with two or more partitions, specify the special file name for each partition.

[FILE]

/etc/sfxfstab

This file contains the names of each of the file system component partitions.

[SEE ALSO]

mkfs_sfxfs(1M), sfxnewfs(1M), sfxnode(1M), sfxadd(1M)

[NOTE]

• If the update log size is changed by -L option when immediately after system down, perform the update log replay by fsck_sfxfs(1M) with -o log option before it changes.
  The change history information of file system is discarded, when the update log size is changed without executing the update log replay. Therefore, an inconsistency may occur in file system. In this state, the file system can be mounted only after it was recovered by fsck_sfxfs(1M) with -o nolog option.