General guidelines for using vxfentsthdw


		< Previous \| TOC \| Index \| Next >

General guidelines for using vxfentsthdw

The utility requires two systems connected to the shared storage.
Caution The tests overwrite and destroy data on the disks, unless you use the -r option.
The two nodes must have ssh (default) or remsh communication. If you use remsh, launch the vxfentsthdw utility with the -n option.
After completing the testing process, remove permissions for communication and restore public network connections.
To ensure both systems are connected to the same disk during the testing, you can use the vxfenadm -i diskpath command to verify a disk's serial number.
Verifying the nodes see the same disk
For disk arrays with many disks, use the -m option to sample a few disks before creating a disk group and using the -g option to test them all.
When testing many disks with the -f or -g option, you can review results by redirecting the command output to a file.
The utility indicates a disk can be used for I/O fencing with a message resembling:
The disk /dev/rdsk/c2t13d0s2 is ready to be configured for I/O Fencing on node north
If the disk you intend to test has existing SCSI-3 registration keys, the test issues a warning before proceeding.

vxfentsthdw options describes various options the utility provides to test storage devices.

vxfentsthdw options

vxfentsthdw option	Description	When to use
-n	Use /bin/rsh.	Use when `remsh` is used for communication.
-r	Non-destructive testing. Testing of the disks for SCSI-3 persistent reservations occurs in a non-destructive way; that is, there is only testing for reads, not writes. May be used with -m, -f, or -g options.	Use during non-destructive testing.
-t	Testing of the return value of `SCSI TEST UNIT (TUR)` command under SCSI-3 reservations. A warning is printed on failure of TUR testing.	When you want to perform TUR testing.
-d	Use DMP devices. May be used with -c or -g options.	By default, the script picks up the OS paths for disks in the disk group. If you want the script to use the DMP path, use the -d option.
-c	Utility tests the coordinator disk group prompting for systems and devices, and reporting success or failure.	For testing disks in coordinator disk group.
-m	Utility runs manually, in interactive mode, prompting for systems and devices, and reporting success or failure. May be used with -r and -t options. -m is the default option.	For testing a few disks or for sampling disks in larger arrays.
-f filename	Utility tests system/device combinations listed in a text file. May be used with -r and -t options.	For testing several disks.
-g disk_group	Utility tests all disk devices in a specified disk group. May be used with -r and -t options.	For testing many disks and arrays of disks. Disk groups may be temporarily created for testing purposes and destroyed (ungrouped) after testing.


^ Return to Top	< Previous \| TOC \| Index \| Next >