vxfentsthdw options


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

vxfentsthdw options

vxfentsthdw options describes three methods the utility provides to test storage devices.

vxfentsthdw options

vxfentsthdw option	Description	When to use
-n	Utility uses `remsh` for communication.	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.

Testing the coordinator disk group using vxfentsthdw -c

Use the vxfentsthdw utility to verify disks are configured to support I/O fencing. In this procedure, the vxfentsthdw utility tests the three disks one disk at a time from each node.

From the node galaxy, the disks are /dev/rdsk/c1t1d0, /dev/rdsk/c2t1d0, and /dev/rdsk/c3t1d0.

From the node nebula, the same disks are seen as /dev/rdsk/c4t1d0, /dev/rdsk/c5t1d0, and /dev/rdsk/c6t1d0.

Note To test the coordinator disk group using the vxfentsthdw utility, the utility requires that the coordinator disk group, vxfencoorddg, be accessible from two nodes.

To test the coordinator disk group using vxfentsthdw -c

Use the vxfentsthdw command with the -c option. For example:
# /opt/VRTSvcs/vxfen/bin/vxfentsthdw -c vxfencoorddg
Enter the nodes you are using to test the coordinator disks:
Enter the first node of the cluster:

galaxy

Enter the second node of the cluster:

nebula

Review the output of the testing process for both nodes for all disks in the coordinator disk group. Each disk should display output that resembles:
ALL tests on the disk /dev/rdsk/c1t1d0 have PASSED.

The disk is now ready to be configured for I/O Fencing on node galaxy as a COORDINATOR DISK.

ALL tests on the disk /dev/rdsk/c4t1d0 have PASSED.

The disk is now ready to be configured for I/O Fencing on node nebula as a COORDINATOR DISK.
After you test all disks in the disk group, the vxfencoorddg disk group is ready for use.

Removing and replacing a failed disk

If a disk in the coordinator disk group fails verification, remove the failed disk or LUN from the vxfencoorddg disk group, replace it with another, and retest the disk group.

If you need to replace a disk in an active coordinator disk group, refer to the troubleshooting procedure.

See Adding or removing coordinator disks

To remove and replace a failed disk

Use the vxdiskadm utility to remove the failed disk from the disk group. Refer to the Veritas Volume Manager Administrator's Guide.
Add a new disk to the node, initialize it, and add it to the coordinator disk group.
See Initializing disks

See Setting up coordinator disk groups
Retest the disk group.

Using the -r option for non-destructive testing

To test disk devices containing data you want to preserve, you can use the -r option with the -m, -f, or -g options, which are described in the following sections. For example, to use the -m option and the -r option, you can run the utility by entering:

# /opt/VRTSvcs/vxfen/bin/vxfentsthdw -rm

When invoked with the -r option, the utility does not use tests that write to the disks. Therefore, it does not test the disks for all of the usual conditions of use.

Using the -m option

Review the procedure to test the shared disks. The utility uses the -m option.

See Testing the shared disks for SCSI-3

Using the -f option

Use the -f option to test disks that are listed in a text file. For example, you can create a file to test two disks shared by systems galaxy and nebula that might resemble:

galaxy /dev/rdsk/c2t2d1 nebula /dev/rdsk/c3t2d1

where the first disk is listed in the first line and is seen by galaxy as /dev/rdsk/c2t2d1 and by nebula as /dev/rdsk/c3t2d1. The other disk, in the second line, is seen as /dev/rdsk/c2t2d2 from galaxy and /dev/rdsk/c3t2d2 from nebula. Typically, the list of disks could be extensive.

Suppose you created the file named disks_blue. To test the disks, you would enter:

# /opt/VRTSvcs/vxfen/bin/vxfentsthdw -f disks_blue

The utility reports the test results one disk at a time, just as for the -m option.

You can redirect the test results to a text file. Precede the command with "yes" to acknowledge that the testing destroys any data on the disks to be tested.

Caution Be advised that by redirecting the command's output to a file, a warning that the testing destroys data on the disks cannot be seen until the testing is done.

For example:

# yes | /opt/VRTSvcs/vxfen/bin/vxfentsthdw -f disks_blue > blue_test.txt

Using the -g option

Use the -g option to test all disks within a disk group. For example, you create a temporary disk group consisting of all disks in a disk array and test the group.

Note Do not import the test disk group as shared; that is, do not use the -s option.

The utility reports the test results one disk at a time. You can redirect the test results to a text file for review.

# /opt/VRTSvcs/vxfen/bin/vxfentsthdw -g red_disks_dg > redtest.txt

After testing, destroy the disk group and put the disks into disk groups as you need.

Testing a disk with existing keys

If the utility detects that a coordinator disk has existing keys, you see a message that resembles:

There are Veritas I/O Fencing keys on the disk. Please make sure

that I/O Fencing is shut down on all nodes of the cluster before

continuing.

******** WARNING!!!!!!!! ********

THIS SCRIPT CAN ONLY BE USED IF THERE ARE NO OTHER ACTIVE NODES IN THE CLUSTER! VERIFY ALL OTHER NODES ARE POWERED OFF OR INCAPABLE OF ACCESSING SHARED STORAGE.

If this is not the case, data corruption will result.

Do you still want to continue : [y/n] (default: n) y

The utility prompts you with a warning before proceeding. You may continue as long as I/O fencing is not yet configured.


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