Symantec logo

< Previous  | TOC | Index | Next  >  

vxfentsthdw options

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

vxfentsthdw options

vxfentsthdw option

Description

When to use

-n 

Utility uses rsh for communication. 

Use when rsh 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.

 To test the coordinator disk group using vxfentsthdw -c

  1. Use the vxfentsthdw command with the -c option. For example:

    # /opt/VRTSvcs/vxfen/bin/vxfentsthdw -c vxfencoorddg

  2. Enter the nodes you are using to test the coordinator disks:

    Enter the first node of the cluster:

    north

    Enter the second node of the cluster:

    south

  1. 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/rhdisk75 have PASSED. 

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

 




 ALL tests on the disk /dev/rhdisk80 have PASSED.



The disk is now ready to be configured for I/O Fencing on node 
south as a COORDINATOR DISK.
  1. 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

  1. Use the vxdiskadm utility to remove the failed disk from the disk group. Refer to the Veritas Volume Manager Administrator's Guide.
  2. 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

  3. 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 north and south that might resemble:

north /dev/rhdisk75 south /dev/rhdisk77

north /dev/rhdisk76 south /dev/rhdisk78

Where the first disk is listed in the first line and is seen by north as /dev/rhdisk75 and by south as /dev/rhdisk77. The other disk, in the second line, is seen as /dev/rhdisk76 from north and /dev/rhdisk78 from south. 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  >