dsmmigfs enablefailover, and disablefailover
Use the dsmmigfs command with the enablefailover or disablefailover parameter to manage recovery from partial system failure.
This command is valid only on GPFS™
file systems.
You must have root user authority to use this command.
One space management client can take over from an HSM client that is involved in a partial system failure if the following conditions are true:
- The failing space management client node has failover enabled.
- There are one or more additional space management client nodes within the same GPFS cluster with failover enabled.
- The space-managed file system is mounted on at least one of these nodes.
- A synchronous time exists on the failing nodes and the client nodes.
- The peer node is online
Syntax
>>-DSMMIGFS--+-ENABLEFailover--+--+---------+------------------>< '-DISABLEFailover-' '-options-'
Parameters
- ENABLEFailover
- Activates the node for failover operations within the GPFS cluster.
- DISABLEFailover
- Deactivates failover operations on the node.
- options
- -MODE=value
- Specifies a failover mode. The mode option
is valid only with the enablefailover parameter.
You can specify the following values for the mode option:
- TAKEOVER
- The node can take over space-managed file systems when another HSM node fails. If the node fails, control of the space-managed file systems does not fail over to other HSM nodes.
- HANDOVER
- If the node fails, control of the space-managed file systems fails over to other HSM nodes. The node does not take over space-managed file systems when another HSM node fails.
- ENABLED
- The node can take over space-managed file systems when another HSM node fails. If the node fails, control of the space-managed file systems fails over to other HSM nodes.
- –ERRORLOGName=file_path
- Specifies the path and file name of the error log file to be used by this command. Output from only this command is logged to the specified file. Other commands and daemons write output to the error log file specified by the errorlogname option in options file dsm.sys or dsm.opt, or as specified by the DSM_LOG environment variable. If any part of the path you specify does not exist, the space management client creates it.
- –Logname=file_path
- Specifies the path and file name of the log file to be used by this command. The kinds of events that are logged to the file are specified with the hsmlogeventflags option. Error events are not logged to the file.
Examples
Commands are provided for the example tasks.
| Task | Command |
|---|---|
| Enable failover operations on the space management client node. If the node fails, control of the space-managed file systems fails over to other HSM nodes. The node does not take over space-managed file systems when another HSM node fails. | dsmmigfs enablef -mode=HANDOVER |
| Deactivate failover operations on the space management client node. | dsmmigfs disableFailover |