B    Clearing Persistent Reservations on Disks Behind HSZ80 and HSG80 Controllers

TruCluster Server cluster members use persistent reservations to coordinate access to shared storage. These persistent reservations control access to devices and logical volumes, and are used to erect a barrier against any system that is not a member of the current cluster.

The base operating system does not know how to manage these persistent reservations. Attempts by the base operating system to access a disk that has a persistent reservation will return I/O error messages. All I/O attempts will fail.

If you boot (or reinstall) the base operating system on a system that attempts to access disks that were previously used by a cluster behind an HSZ80 or HSG80 controller, the base operating system might not be able to see the disks. This is most likely because the disk participated previously in a cluster, and one of the cluster members set a reservation on the disk to prohibit any other hosts (or noncluster members) on this shared bus from accessing the disk. The problem is that the reservation was not cleared when the cluster member or the cluster was shut down.

To remove the reservations, use the /usr/sbin/cleanPR clean command. The cleanPR script finds and clears all persistent reservations from the attached HSZ80 and HSG80 devices.

Caution

Do not run the cleanPR script on a system that is in a cluster. You do not want to remove reservations that the running cluster is using to actively control disk access. Doing so can result in data corruption.

There are two scenarios to consider. The first is where you can boot a disk containing Tru64 UNIX Version 5.1 and run the cleanPR command. The second is where you are trying to install Tru64 UNIX Version 5.1 on a disk that is behind an HSG80 or HSZ80 controller, has a persistent reservation on it, and there is no installed version of the base operating system is available.

For the first scenario, if you encounter persistent reservations when attempting to access storage that was previously used in a cluster, boot the Tru64 UNIX Version 5.1 operating system and enter the /usr/sbin/cleanPRclean command to clear the reservations.

The second scenario is more complex because you do not have a running version of the operating system from which you can run the cleanP script. However, the cleanPR script is on the Tru64 UNIX Version 5.1 CD-ROM. Therefore, you can start the installation from CD-ROM, get to the single-user shell, and enter the /usr/sbin/cleanPR clean command to clear the reservations.

For example:

/usr/sbin/cleanPR clean                        cleanPR Version: 1.3
 
 
                                WARNING
       This shell script will clear all Persistent Reservations
        from the HSX80 devices attached to this system.
 
                                WARNING
 
Do you wish to proceed ? {y/n} [n]: y
        Removing Persistent Reservations from all HSX80 devices...
 
 Checking HSG80 at /dev/rdisk/dsk10a (SCSI #2 (SCSI ID #4) (SCSI LUN #11))
                       Key Entry 0: 0x10002
                       Key Entry 1: 0x10001
 
                Registered with key 0x0
                Cleared
 
 Checking HSG80 at /dev/rdisk/dsk11a (SCSI #2 (SCSI ID #4) (SCSI LUN #10))
                       Key Entry 0: 0x10002
                       Key Entry 1: 0x10001
 
                Registered with key 0x0
                Cleared
 
 Checking HSG80 at /dev/rdisk/dsk12a (SCSI #2 (SCSI ID #4) (SCSI LUN #29))
                       Key Entry 0: 0x10002
                       Key Entry 1: 0x10001
 
                Registered with key 0x0
                Cleared
 
 Checking HSG80 at /dev/rdisk/dsk13a (SCSI #2 (SCSI ID #4) (SCSI LUN #28))
                       Key Entry 0: 0x10002
                       Key Entry 1: 0x10001
 
                Registered with key 0x0
                Cleared
 
 Checking HSG80 at /dev/rdisk/dsk14a (SCSI #2 (SCSI ID #1) (SCSI LUN #22))
                       Key Entry 0: 0x10001
                       Key Entry 1: 0x10002
 
                Registered with key 0x0
                Cleared
 
 Checking HSG80 at /dev/rdisk/dsk15a (SCSI #2 (SCSI ID #1) (SCSI LUN #20))
                       Key Entry 0: 0x10001
                       Key Entry 1: 0x10002
 
                Registered with key 0x0
                Cleared
 
 Checking HSG80 at /dev/rdisk/dsk16a (SCSI #2 (SCSI ID #1) (SCSI LUN #25))
                       Key Entry 0: 0x10001
                       Key Entry 1: 0x10002
 
                Registered with key 0x0
                Cleared
 
Checking HSG80 at /dev/rdisk/dsk17a (SCSI #2 (SCSI ID #1) (SCSI LUN #24))
                       Key Entry 0: 0x10001
                       Key Entry 1: 0x10002
 
                Registered with key 0x0
                Cleared
 
 Checking HSG80 at /dev/rdisk/dsk6a (SCSI #2 (SCSI ID #1) (SCSI LUN #1))
 
                       Key Entry 0: 0x10001
                       Key Entry 1: 0x10002
 
                Registered with key 0x0
                Cleared
 
 Checking HSG80 at /dev/rdisk/dsk7a (SCSI #2 (SCSI ID #1) (SCSI LUN #4))
 
                       Key Entry 0: 0x1
                       Key Entry 1: 0x1
 
                Registered with key 0x0
                Cleared
 
 
 Checking HSG80 at /dev/rdisk/dsk8a (SCSI #2 (SCSI ID #1) (SCSI LUN #7))
 
                       Key Entry 0: 0x10001
                       Key Entry 1: 0x1
 
                Registered with key 0x0
                Cleared
 
 Checking HSG80 at /dev/rdisk/dsk9a (SCSI #2 (SCSI ID #1) (SCSI LUN #6))
 
                       Key Entry 0: 0x1
                       Key Entry 1: 0x10002
 
                Registered with key 0x0
                Cleared
 
 
Total of 12 devices found w/Persistent Reservations
Total of 12 devices cleared of Persistent Reservations