9.21 monscsiclr (releases reservations for shared disks)
Format
monscsiclr server-alias-name
Users who can execute the command
Superuser
Description
The monscsiclr command releases reservations for the devices specified in the scsi_device and dmmp_device operands in the server environment definition (servers).
If the active server cannot be started because shared disks are reserved, use this command to release the reservations so that the active server can be started. You can execute this command regardless of whether HA Monitor is running.
If all the reservations are released successfully, the KAMN108-I message with detail code SUCCESS is issued. If the command fails to release the reservation for any shared disk, the KAMN108-I message with detail code FAILURE is issued. The command skips a device whose reservation could not be released and continues processing.
Options
-
server-alias-name
Specifies the alias name of the server for which shared disk reservations are to be released.
Return codes
Value |
Meaning |
---|---|
0 |
Normal termination (Reservations for all shared disks used by the server have been released.) |
Other than 0 |
Abnormal termination |
Notes
-
Do not execute the monscsiclr command while the active server whose alias name is specified in the option is running on any of the hosts. If the monscsiclr command is executed in such a case, the shared disks might no longer be locked.
-
This command ignores the scsi_timeout and scsi_retry operand settings in the HA Monitor environment settings (sysdef) and assumes the default values.
Example
- Display during command execution
-
This example assumes the following:
-
/dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000000 is reserved.
-
/dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000001 is reserved, but its open processing fails when the monscsiclr command is executed.
-
/dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000002 is not reserved.
> monscsiclr server1 KAMN107-I Reservation release processing for server server1 will now start. Device Status /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000000 CLEARED KAMN601-W An error occurred in the open system call. Error details: 2 Functional name: scsi_cmd_ctrl. KAMN725-W Execution of the SCSI command on the device /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000001 ended abnormally. (details code: OPEN, server: server1, host address: *(*)). KAMN726-E Errors occurred on all the paths to the device /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000001. /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000001 FAILED /dev/disk/by-id/scsi-360060e8010462fe004f2b6ae00000002 NO_RESERVE KAMN108-I Reservation release processing for server server1 is completed. Details: FAILURE
- Legend:
-
>: Indicates a user operation.
-
The value displayed for Device consists of a maximum of 61 single-byte characters. If the path of a shared disk consists of more than 61 characters, the excess characters are not displayed.
-
The following table shows the Status values and their meanings:
Status
Meaning
CLEARED
Reservation was released.
FAILED
Reservation release processing failed.
See the displayed message and take appropriate action.
NO_RESERVE
Reservation had not been made.
-