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

23.1 File System Management Commands

For each file system, there are two different types of management commands, namely, the general purpose management commands and the system specific management commands. The general purpose management commands that provided by Solaris OE are used for basic functions and the system specific commands are called by specifying options or file system types.

The GFS Shared File System features an exclusive management commands that act as the general purpose management command and the system specific management command for the GFS Shared File System's original functions.

Specify "sfcfs" for -F option as a file system type when using the general purpose management command to a GFS Shared File System. If you omit the -F option, a search is made of those entries matched with "special" or "mount_point" in "/etc/vfstab," after which the registered file system types are automatically selected.

[Table General purpose file system management commands]

Command	Description
df(1M)	Displays the number of free disk blocks, number of files, etc.
fsck(1M)	Checks a file system for consistency and repairs it.
fstyp(1M)	Determines the file system type.
mkfs(1M)	Creates a file system.
mount(1M)	Mounts a file system.
umount(1M)	Umounts a file system.

For details of the general-purpose management commands, see each command's page of "Solaris X Reference Manual."

[Table Commands for Common File System Management]

Command	Description
df_sfcfs(1M)	Reports the free disk area of GFS Shared File System
fsck_sfcfs(1M)	Checks the GFS Shared File System for consistency and recovers the file system
fstyp_sfcfs(1M)	Determines the type of a file system
mkfs_sfcfs(1M)	Constructs the GFS Shared File System
mount_sfcfs(1M)	Mounts the GFS Shared File System on the self-mode.
umount_sfcfs(1M)	Unmounts the GFS Shared File System from the self-node.

Execute the commands for common file system management in the nodes that share the target file system. Also when executing fsck_sfcfs(1M) and mkfs_sfcfs(1M) (except -m) make sure that the sfcfrmd daemon has been started in all nodes that share the target file system.

[Table Management Commands Specific to the GFS Shared File System]

Command	Description
sfcadd(1M)	Adds file data partitions.
sfcadm(1M)	Changes partition information settings.
sfcddr(1M)	Restores backup data and checks device restoring.
sfcdu(1M)	Summarizes disk usage.
sfcdump(1M)	Dumps a GFS Shared File System.
sfcedquota(1M)	Edits quota limits for each user.
sfcfrmstart(1M)	Starts FsRM on the self-node.
sfcfrmstop(1M)	Stops FsRM on the self-node.
sfcgetconf(1M)	Backs up the management partition.
sfchost(1M)	Displays and changes a connection host name with MDS.
sfcinfo(1M)	Displays partition information.
sfcmkbkup(1M)	Generates a shell script for backing up.
sfcmkrstr(1M)	Generates a shell script for restoring.
sfcmntgl(1M)	Mounts the GFS Shared File System on all nodes.
sfcnewfs(1M)	Builds the GFS Shared File System (front end of mkfs_sfcfs).
sfcnode(1M)	Adds, deletes, and alters node configuration information.
sfcproxybreak(1M)	Cancels the relationship for high speed backup and restoration.
sfcproxyinfo(1M)	Displays information about the relationship for high speed backup and restoration.
sfcproxyjoin(1M)	Sets up the relationship for high speed backup and restoration.
sfcproxyop(1M)	Executes operations for high speed backup and restoration.
sfcproxyrestore(1M)	Restores a file system at high speed.
sfcquota(1M)	Displays the quota limit value and uses amount for each user.
sfcquotadm(1M)	Manages quotas files.
sfcquotaon(1M)	Validates the quota function.
sfcquotaoff(1M)	Invalidates the quota function.
sfcrepquota(1M)	Displays the quota function limits and use amounts of all users.
sfcrestore(1M)	Restores from dump created with sfcdump.
sfcrscinfo(1M)	Displays file system information.
sfcsetup(1M)	Initializes the management partition; adds, deletes, and displays node information; displays path of the management partition.
sfcstat(1M)	Reports statistics on the GFS Shared File Systems.
sfcswitch(1M)	MDS failback
sfctune(1M)	Tunes the GFS Shared File System.
sfcumntgl(1M)	Unmounts the GFS Shared File System from all nodes.

Original commands for general users of the GFS Shared File System original functions are listed below.

When executing sfcadd(1M), sfcadm(1M), sfchost(1M), sfcnewfs(1M), sfcnode(1M), sfcproxybreak(1M), sfcproxyjoin(1M), sfcproxyop(1M), or sfcproxyrestore(1M), make sure that the sfcfrmd daemon has been started in all nodes that share the target file system.

[Table General Commands Specific to the GFS Shared File System]

Command	Description
sfccp(1)	Copies files with extent attribute information.
sfccpio(1)	Extracts or restores files from an archive with extent attribute information.
sfcgetext(1)	Displays extent attribute information.
sfcgetfattr(1)	Reports extent attribute information of a file.
sfcmv(1)	Moves files with extent attribute information.
sfcsetext(1)	Specifies extent attribute information.
sfcsettime(1)	Sets or deletes ignore update time attribute information.
sfcsetvolume(1)	Sets or deletes file data allocation attribute information.

Commands of GFS Shared File System are classified as follows:

[ used in mounted file system ]

umount_sfcfs
sfcdu, sfcedquota, sfchost(except -c), sfcquota, sfcquotadm, sfcquotaoff, sfcquotaon, sfcrepquota, sfcrestore, sfcstat
sfccp, sfccpio, sfcgetext, sfcmv, sfcsetext, sfcgetfattr, sfcmv, sfcsetext, sfcsettime, sfcsetvolume

[ used in unmounted file system ]

fsck_sfcfs, mkfs_sfcfs(except -m), mount_sfcfs
sfcadm(except -A), sfcddr, sfcfrmstart, sfcfrmstop, sfchost -c, sfcnewfs, sfcnode, sfcproxyrestore, sfctune

[ used in both mounted and unmounted file system ]

df_sfcfs, fstyp_sfcfs, mkfs_sfcfs -m
sfcadd, sfcadm -A, sfcdump^*1, sfcgetconf, sfcinfo, sfcmkbkup, sfcmkrstr, sfcmntgl^*2, sfcproxybreak, sfcproxyinfo, sfcproxyjoin, sfcproxyop^*3, sfcrscinfo, sfcsetup, sfcswitch^*4, sfcumntgl

(*1: While the sfcdump(1M) is used in mounted file system, the file system information must be not updated. For details on sfcdump(1M), see Appendix F.2.5, "sfcdump(1M)".)
(*2: An error occurs if the file system is mounted in all shared nodes.)
(*3: The file system of the backup destination must be unmounted except the umount subcommand. For details on sfcproxyop(1M), see Appendix F.2.19, " sfcproxyop(1M)".)
(*4: An error occurs if primary server and secondary server are not mounted.)