J2UZ-5362-01ENZ2(A)
Before using this online manual
Preface
Chapter 1 File System Functions
1.1 File System Overview
1.1.1 Basic hardware configuration for use of file system
1.1.2 File system sharing with PRIMEQUEST
1.2 Simultaneous Shared Access Maintaining Coherency
1.3 High Availability
1.3.1 Uninterrupted operation in case of node failure
1.3.2 High-speed file system recovery
1.3.3 Area reassignment in case of disk block failure
1.4 Performance
1.4.1 Data access performance
1.4.2 Contiguous block assignment
1.4.3 Multi-partition configuration
1.4.4 Individualized meta-cache management
1.5 Extendibility
1.5.1 File system extension
1.6 Operability
1.6.1 GUI
1.7 Upper Limits of the File System
1.8 Notes
1.8.1 Relationships with Other Components of PRIMECLUSTER
1.8.2 Unavailable functions
1.8.2.1 Functions not provided by the GFS Shared File System
1.8.2.2 Unavailable functions on Linux kernel version 2.4
1.8.3 Service ports used by the GFS Shared File System
1.8.4 Notes on use of logical volumes of GDS
1.8.5 Notes on unmounting
1.8.6 Notes of updatedb(1L)
1.8.7 Notes on system time change
1.8.8 Notes on operation stop
1.8.9 Deleting a file being created from the other node
1.8.10 Notes on file owner change
1.8.11 Notes on ioctl(2) with FIONREAD
1.8.12 Notes on fcntl(2) with F_SETFL
1.8.13 Notes on fcntl(2) with F_SETLEASE
1.8.14 Notes on rename(2)
1.8.15 Notes on file lock function
1.8.15.1 Unavailable functions
1.8.15.2 Notes caused by Linux kernel specification
1.8.15.3 Effect of file lock on system performance
1.8.16 Open processing from other nodes to a file mapped by mmap(2) [Linux2.4]
1.8.17 Creating a regular file by mknod(2) [Linux2.4]
1.8.18 Notes on opening a file on the GFS Shared File System
Chapter 2 File System Structure
2.1 Disk Structure of File System
2.1.1 Super block
2.1.2 Partition configuration data
2.1.3 Meta-data area
2.1.3.1 Area management data
2.1.3.2 i-node area
2.1.3.3 V-data area
2.1.4 Update log area
2.1.5 File data area
2.1.6 Partition configuration
2.2 Component configuration
2.2.1 MDS (Meta Data Server)
2.2.2 AC (Access Client)
2.2.3 Monitoring daemon
2.3 File Access and Token Management
Chapter 3 Failure Recovery
3.1 MDS Failure Recovery
3.1.1 Automatic recovery for primary MDS failures
3.1.2 Automatic recovery for secondary MDS failures
3.1.3 Automatic recovery in case primary MDS goes down during primary MDS operation only
3.2 AC degeneration
Chapter 4 File System Design
4.1 Mount and unmount opportunity of the file system at the time of system starting and ending
4.2 System Design
4.2.1 Effects of file system operation and system load
4.2.2 Node layout
4.2.3 Disk layout
4.2.4 LAN selection
4.2.5 For future expansion
4.3 Backup Design
Chapter 5 Management Partition
5.1 Management Partition
5.2 Resources Required for the Management Partition
5.3 Notes on Management
Chapter 6 Starting and Exiting the Management View
6.1 Starting Web-Based Admin View
6.2 Web-Based Admin View Top Menu
6.2.1 Web-Based Admin View Operation Menu Functions
6.2.2 Web-Based Admin View Tool Menu Functions
6.3 Starting GFS Management View
6.4 Exiting GFS Management View
6.5 Exiting Web-Based Admin View
Chapter 7 Operation Management View Screen Elements
7.1 Screen Configuration
7.2 Menu Configurations and Functions
7.2.1 General
7.2.2 Operation
7.2.3 View
7.2.4 Help
7.3 Icon Types and Object Status
Chapter 8 Management Partition Operations (GUI)
8.1 Flow of Operations
8.1.1 Creating the management partition
8.1.2 Adding node configuration information to the management partition
8.2 Creating the management partition
8.2.1 Setting shared disks
8.2.2 Creating the management partition, registering node configuration information and starting sfcfrmd daemon
8.3 Adding node configuration information to the management partition
8.3.1 Setting shared disks
8.3.2 Stopping sfcfrmd daemon
8.3.3 Adding node configuration information to the management partition
8.3.4 Starting sfcfrmd daemon
Chapter 9 Management Partition Operations (Command)
9.1 Flow of Operations
9.1.1 Creating the management partition
9.1.2 Adding node configuration information to the management partition
9.1.3 Deleting node configuration information from the management partition
9.1.4 Changing the sfcfrmd daemon's startup mode registered in the management partition
9.1.5 Backup of the management partition information
9.1.6 Restoring of the management partition information
9.2 Creating of the management partition
9.2.1 Setting Shared disks
9.2.2 Initializing of the management partition
9.2.3 Registering node configuration information to the management partition
9.2.4 Starting sfcfrmd daemon
9.3 Adding node configuration information to the management partition
9.3.1 Setting Shared disks
9.3.2 Stopping sfcfrmd daemon
9.3.3 Adding node configuration information to the management partition
9.3.4 Starting sfcfrmd daemon
9.4 Deleting node configuration information from the management partition
9.4.1 Stopping sfcfrmd daemon
9.4.2 Deleting node configuration information from the management partition
9.4.3 Starting sfcfrmd daemon
9.5 Changing the sfcfrmd daemon's startup mode registered in the management partition
9.5.1 Choosing the sfcfrmd daemon's startup mode
9.5.2 Stopping sfcfrmd daemon
9.5.3 Changing the sfcfrmd daemon's startup mode
9.5.4 Starting sfcfrmd daemon
9.6 Backup of the management partition information
9.6.1 Backup of the management partition information
9.7 Restoring of the management partition information
9.7.1 Re-initializing the management partition
9.7.2 Re-registering node configuration information to the management partition
9.7.3 Re-configuring the sfcfrmd daemon's startup mode in the management partition
9.7.4 Starting sfcfrmd daemon
9.7.5 Restoring of the management partition information
Chapter 10 File System Operations (GUI)
10.1 Flow of Operations
10.1.1 Creation
10.1.2 Change (in file system attributes)
10.1.3 Change (partition addition)
10.1.4 Change (shared node information)
10.1.5 Deletion
10.2 Creation
10.2.1 Creating a file system
10.3 Change
10.3.1 Changing in file system attributes
10.3.2 Changing the file system configuration (partition addition)
10.3.3 Changing the shared node information
10.4 Deletion
10.4.1 Deleting the file system
Chapter 11 File System Operations (Command)
11.1 Flow of Operations
11.1.1 Creation
11.1.2 Change (in file system attributes)
11.1.3 Change (partition addition)
11.1.4 Change (shared node information)
11.1.5 Change (re-creating a file system)
11.1.6 Change (MDS operational information)
11.1.7 Deletion
11.2 Creation
11.2.1 Setting shared disks
11.2.2 Creating a file systems
11.2.2.1 Defaults of parameters used by sfcmkfs(8)
11.2.2.2 Examples of creating a representative file system
11.2.2.3 Customizing a GFS Shared File System
11.2.2.4 Setting MDS operational information
11.2.3 Setting fstab
11.2.4 Mount
11.2.4.1 Mount of all nodes
11.2.4.2 Mount
11.2.5 Checking file system status
11.2.6 Notes applying when the partitions of a created file system are used
11.2.6.1 The GFS Shared File System
11.2.6.2 File systems other than GFS Shared File System
11.3 Change (file system attributes)
11.3.1 Unmount
11.3.1.1 Unmount of all nodes
11.3.1.2 Unmount
11.3.2 Change the file system attributes
11.3.2.1 Changing the mount information
11.3.2.2 Tuning file system
11.3.3 Mount
11.4 Change (partition addition)
11.4.1 Unmount
11.4.2 Setting shared disk
11.4.3 Partition addition
11.4.4 Mount
11.5 Change (shared node information)
11.5.1 Unmount
11.5.2 Shared disk setting (addition)
11.5.3 Shared node information change
11.5.3.1 Adding node information
11.5.3.2 Deleting node information
11.5.4 Setting fstab
11.5.5 Mount
11.6 Change (re-creating a file system)
11.6.1 Unmount
11.6.2 Re-creating the file system
11.6.3 Mount
11.7 Change (MDS operational information)
11.7.1 Unmount
11.7.2 Changing the MDS operational information
11.7.3 Mount
11.8 Deleting
11.8.1 Unmount
11.8.2 Removing the entry in /etc/fstab
11.8.3 Deleting the file system
Chapter 12 File System Management
12.1 File System Management Commands
12.2 Checking a File System for Consistency and Repairing It
12.2.1 Action to be taken when fsck terminates abnormally
12.2.1.1 Memory allocation request error
12.2.1.2 File system configuration information acquisition failure
12.2.1.3 File system partition configuration data error
12.2.1.4 Node addition not performed
12.2.1.5 Irreparable file system destruction
12.2.1.6 Operation error
12.2.1.7 Repairing of file system is non-completion
12.2.1.8 Other messages
12.3 Extending a File System
12.4 Displaying File System Information
12.4.1 Acquiring file system information
12.4.2 Displaying partition/node information
12.4.3 Displaying file system management state
12.5 How to set GFS Shared File System applications as cluster applications
12.5.1 To set GFS Shared File System applications as cluster application
12.5.2 Notes on cluster application settings
12.5.3 Procedure flow chart for setting GFS Shared File System applications as cluster applications
12.5.4 Procedure for setting GFS Shared File System applications as cluster applications
12.5.5 Setup flow chart of adding file data partitions to GFS Shared File Systems of cluster applications
12.5.6 Setup procedure of adding file data partitions to GFS Shared File Systems of cluster applications
12.6 How to start up CF from GUI when a GFS Shared File System is used
Chapter 13 File System Backing-up and Restoring
13.1 Type of Backing-up and Restoring
13.2 Backing-up by Standard Linux commands
13.2.1 Backing-up file by file
13.2.2 Backing-up entire file system
13.3 Restoring by Standard Linux commands
13.3.1 File-by-file restoring
13.3.2 Entire-file-system restoring
13.3.3 Set up after Restoration
13.3.3.1 Resetting the partition information
13.3.3.2 Repairing the file system
Chapter 14 Tuning
14.1 Tuning Parameters
14.1.1 Amount of Cache
14.1.2 Communication timeout value
Chapter 15 Migration to the GFS Shared File System
15.1 Moving the existing files
Appendix A List of Messages
A.1 AC Messages of the GFS Shared File System
A.1.1 Panic messages
A.1.2 Warning messages
A.1.3 Information messages
A.2 GFS Shared File System Daemon messages
A.2.1 Panic messages (MDS(sfcfsmg daemon))
A.2.2 Panic messages (sfcprmd daemon)
A.2.3 Error messages (sfcfrmd daemon)
A.2.4 Error messages (MDS (sfcfsmg daemon))
A.2.5 Error messages (sfcfsd daemon)
A.2.6 Error messages (sfcfs_mount command)
A.2.7 Error messages (sfcpncd daemon)
A.2.8 Error messages (sfcprmd daemon)
A.2.9 Warning messages (MDS (sfcfsmg daemon))
A.2.10 Warning messages (sfcfsd daemon)
A.2.11 Information messages (sfcfrmd daemon)
A.2.12 Information messages (MDS (sfcfsmg daemon))
A.2.13 Information messages (sfcprmd daemon)
A.3 GFS Shared File System Script Messages
A.3.1 sfcfsrm script
A.4 GFS Shared File System Implementations of Standard File System Management Commands' Messages
A.4.1 sfcdf command
A.4.2 sfcfsck command
A.4.3 sfcmkfs command
A.4.4 sfcmount command
A.4.5 sfcumount command
A.5 GFS Shared File System Specific Management Commands' Messages
A.5.1 libsfcfs library
A.5.2 sfcadd command
A.5.3 sfcadm and sfcnode commands
A.5.4 sfcfrmstart command
A.5.5 sfcfrmstop command
A.5.6 sfcgetconf command
A.5.7 sfcinfo command
A.5.8 sfcmntgl command
A.5.9 sfcsetup command
A.5.10 sfcstat command
A.5.11 sfcumntgl command
A.5.12 sfcrscinfo command
A.6 GFS Management View Messages
A.6.1 Error messages
A.6.2 Warning messages
A.6.3 Information messages
A.7 Web-Based Admin View Messages
A.8 Messages Of Functions For GFS To Use
A.9 Installation Error Messages
Appendix B Reference Manual
B.1 GFS Shared File System Exclusive Management Commands
B.1.1 sfcdf(8) Display the GFS Shared File System use status and configuration information
B.1.2 sfcfsck(8) Verify and restore GFS Shared File System consistency
B.1.3 sfcmkfs(8) Construct the GFS Shared File System
B.1.4 sfcmount(8) Mount the GFS Shared File System on the local node
B.1.5 sfcumount(8) Unmount the GFS Shared File System from the local node
B.2 GFS Shared File System Specific Management Commands
B.2.1 sfcadd (8) Adds file data partitions
B.2.2 sfcadm(8) Change partition information setting
B.2.3 sfcfrmstart(8) Start sfcfrmd daemon on the local node
B.2.4 sfcfrmstop(8) Stop sfcfrmd daemon on the local node
B.2.5 sfcgetconf(8) Make a backup of the management partition
B.2.6 sfcinfo(8) Display partition information
B.2.7 sfcmntgl(8) Mount the GFS Shared File System on all nodes
B.2.8 sfcnode(8) Add, delete, and change node configuration information
B.2.9 sfcrscinfo(8) Display file system information
B.2.10 sfcsetup(8) Initialize the management partition, add, delete and display node information, display path of management partition, and register and display the startup mode of the sfcfrmd daemon
B.2.11 sfcstat(8) Report statistics on GFS Shared File Systems
B.2.12 sfcumntgl(8) Unmount the GFS Shared File System from all nodes
Appendix C Trouble shooting
C.1 Corrective actions of messages
C.2 Collecting information for troubleshooting
C.2.1 Collecting a crash dump file
C.2.2 Collecting a core image of the daemon
C.3 Common corrective actions against failures
C.3.1 Action for I/O errors
C.3.2 Corrective action in the event of data inconsistency
C.3.3 Action to Be Taken When Unmounted by umount(8)
C.3.4 Corrective action when the sfcfrmd daemon is not started
Appendix D Incompatibility from Each Version
D.1 Incompatibilities from 4.1A30
D.1.1 Does not support sendfile(2)
D.1.2 Changes operation of truncate(2), ftruncate(2), creat(2), and open(2) specified with O_TRUNC from the other node to the file where mmap(2) is being executed
D.1.3 Changes port numbers reserved by GFS
D.1.4 Changes the type of a special file specified for the GFS command argument
D.1.5 Change in error message of sfcdf(8)
D.1.6 Change in error message of sfcfsck(8)
D.1.7 Check strengthening of parameter specified for -o specific_options option of sfcmkfs(8)
D.1.8 Changes allocated reserved area size by writing operations
D.1.9 Add the upper limit of concurrently open files
D.1.10 Addition of the i-node's cache memory release function at the time of accessing many files
D.2 Incompatibilities from 4.1A20
D.2.1 Communication timeout value between nodes
D.2.2 Information message of sfcfrmd demon
Glossary