Connexion  

   

En ligne  

Nous avons 56 invités et aucun membre en ligne

   

Annexes  

   
   

Note utilisateur: 3 / 5

Etoiles activesEtoiles activesEtoiles activesEtoiles inactivesEtoiles inactives
 

La commande 'devrsrv' permet d'afficher et de retirer d'éventuelles réservations sur des disques.

Sans argument, la commande retourne les informations générales d'usage :

# devrsrv

ERROR: Incomplete command

Usage :

For Command Line Inputs:

devrsrv -c query | release | prin -s sa |

        (prout -s sa -r rkey -k sa_key -t prtype) -l devicename

devrsrv -f -l devicename

devrsrv -d

==================================================

Service Action Values:

==================================================

For PRIN Command :

 0(READ KEYS)            1(READ_RESERVATION)

 2(REPORT CAPABILITIES)

For PROUT Command:

 2(RELEASE)              3(CLEAR)

 4(PREEMPT)              5(PREEMPT AND ABORT)

==================================================

rkey specifies the reservation key

This field is needed for service actions PREEMPT, PREEMPT AND ABORT, RELEASE AND CLEAR

 sa_key specifies the service action reservation key

           This field is needed for service actions PREEMPT, PREEMPT AND ABORT

prtype specifies the Persistent Reservation Type

PRTYPE values supported are:

1(WRITE EXCLUSIVE)                       2(EXCLUSIVE ACCESS)

3(WRITE EXCLUSIVE REGISTRANTS ONLY)      4(EXCLUSIVE ACCESS REGISTRANTS ONLY)

5(WRITE EXCLUSIVE ALL REGISTRANTS)       6(EXCLUSIVE ACCESS ALL REGISTRANTS)

 Avec les arguments '-c query' et '-l device', on interroge l'unité passée en argument.

# devrsrv -c query -l hdisk0

Device Reservation State Information

==================================================

Device Name                     :  hdisk0

Device Open On Current Host?    :  YES

ODM Reservation Policy          :  SINGLE PATH RESERVE

Device Reservation State        :  SINGLE PATH RESERVE

Path Id of Reserved Path        :  0

 

En cas de verrou sur ce disque, il est possible d'utiliser l'action 'release' pour demande son retrait.

 

Avec l'option '-d', on affichage la liste des unités.

# devrsrv -d

#Name WW Port Name LUN ID SCSI ID xport
hdisk0 50060e80167c0c16 0000000000000000 001e2700 fcp
hdisk1 50060e80167c0c16 0001000000000000 001e2700 fcp

 

Ci-dessous la documentation officielle.

Purpose

       Queries and breaks the single-path and persistent reservations on a device.

Syntax

       devrsrv -c query | release | prin -s sa | (prout -s sa -r rkey -k sa_key -t prtype) -l devicename

       devrsrv -f -l devicename

       devrsrv -d

Description

       The devrsrv command queries and breaks the single-path and persistent reservations on the device. The command runs the

       persistent reserve in (prin) and persistent reserve out (prout) service actions.

       The query subcommand queries and displays the current reservation status of the device. The release subcommand releases

       the reservation on the device by using the single-path reservation.

       The prin subcommand displays all the registered reservation keys, reservation key holder, and capabilities information.

       The prout subcommand requests service action that reserves a device for the exclusive or shared use of a particular I/O

       path to the device. The prout subcommand supports the following service actions:

       Item

            Description

       RELEASE

            Releases the specified persistent reservation for the device.

       CLEAR

            Clears all the reservation keys and all the persistent reservations.

       PREEMPT

            Preempts the persistent reservations or removes registrations, or both.

       PREEMPT AND ABORT

            Preempts persistent reservations or removes registrations, or both and stops all tasks for all preempted I/O paths

            to the device.

       REGISTER AND IGNORE KEY

            Registers the new key value in place of the old key value.

Flags

       Item

            Description

       -c

            Specifies the following subcommands:

              query

                   Queries and displays the status of reservations on a device.

              release

                   Releases the device with the single-path reservation by using SCSI-2.

              prin

                   Specifies the persistent reservation in service action.

              prout

                   Specifies the persistent reservation out service action.

       -d

            Lists the disk name and other identifying information for all disks that are queried or manipulated by using the

            devrsrv command.

       -f

            Breaks the reservation that is held by other I/O path or host. For single-path reservations, the devrsrv command

            issues a SC_FORCED_OPEN action to break the reservation. For persistent reservations, the devrsrv command issues a

            prout subcommand along with the CLEAR service action to clear the persistent reservation and the registrations.

       -k

            Specifies the service action reservation key. The -k flag is required for the REGISTER, PREEMPT, and PREEMPT_ABORT

            service actions.

       -l

            Specifies the name of the device.

       -r

            Specifies the reservation key. The -r flag is required for the REGISTER, PREEMPT, PREEMPT AND ABORT, and RELEASE

            service actions.

       -s

            Specifies the service action for persistent reservations. The valid service actions for the prin subcommand follow:

              0

                   READ KEYS

              1

                   READ RESERVATION

              2

                   REPORT CAPABILITIES

            The valid service actions for the prout subcommand follow:

              2

                   RELEASE

              3

                   CLEAR

              4

                   PREEMPT

              5

                   PREEMPT AND ABORT

              6

                   REGISTER AND IGNORE EXISTING KEY

       -t

            Specifies the persistent reservation type. The types of persistent reservations follow:

              1

                   Write exclusive

              2

                   Exclusive access

              3

                   Write exclusive registrants only

              4

                   Exclusive access registrants only

              5

                   Write exclusive all registrants

              6

                   Exclusive access all registrants

Examples

       The following are the examples that are related to different scenarios.

       Query operation

       1    To query the reservation status of the hdisk0 device when it is not reserved by any host, enter the following

            command:

            # devrsrv -c query -l hdisk0

            Device Reservation State Information

            ==================================================

            Device Name                      :  hdisk0

            Device Open On Current Host?     :  NO

            ODM Reservation Policy           :  SINGLE PATH RESERVE

            Device Reservation State         :  NO RESERVE

            The output shows that the device is not opened on the current host and the Object Data Manager (ODM) reservation

            policy is SINGLE PATH RESERVE. It indicates that the reservation policy is set in the ODM for this device. The

            device reservation state indicates the reservation that is present on the device. You can find the device

            reservation state by running a sequence of SCSI commands.

       2    To query the reservation status of the hdisk1 device when it is reserved by a host, enter the following command:

            # devrsrv -c query -l hdisk1

            The device is reserved by using the single path reservation by a host.

            Device Reservation State Information

            ==================================================

            Device Name                     :  hdisk1

            Device Open On Current Host?    :  NO

            ODM Reservation Policy          :  SINGLE PATH RESERVE

            Device Reservation State        :  SINGLE PATH RESERVE

       3    To query the reservation status of the hdisk2 device when it is reserved on the same host, enter the following

            command:

            # devrsrv -c query -l hdisk2

            Device Reservation State Information

            ==================================================

            Device Name                     :  hdisk2

            Device Open On Current Host?    :  YES

            ODM Reservation Policy          :  SINGLE PATH RESERVE

            Device Reservation State        :  SINGLE PATH RESERVE

            Path Id of Reserved Path        :  0

       4    To query the reservation status of the hdisk2 device when the ODM reservation policy is PR SHARED and the device is

            not reserved by any host, enter the following command:

            # devrsrv -c query -l hdisk0

            Device Reservation State Information

            ==================================================

            Device Name              :  hdisk0

            Device Open              :  NO

            ODM Reservation Policy   :  PR SHARED

            ODM PR Key Value         :  7777

            Device Reservation State :  NO RESERVE

            Registered PR Keys       :

            555

            777

            PR Capabilities Byte[2]  :  0xd  SIP_C   ATP_C   PTPL_C

            PR Capabilities Byte[3]  :  0x0

            PR Types Supported       :  NOT VALID

            Descriptions of several fields from the query output follow:

       Registered PR Keys:

            Displays keys that are registered by running the prout subcommand along with the REGISTER service action from all

            I/O paths that are sharing this device.

       PR Capabilities Bytes:

            Indicates the content of bytes 2 and 3 returned by the REPORT CAPABILITIES service action of the prin subcommand.

            See the SPC standard to interpret the output of the Example 4.

       PR Types Supported:

            Displays the persistent reservation types that are supported by the device that are reported by the persistent

            reservation type mask field in the report capabilities output.

       If the persistent reservation is held on a device, the query output displays additional information about the device

       reservation as follows:

       PR Reservation Type:

            Displays one of the values of the PR Types that are described in the Flags section.

       PR Holder key Value:

            Displays the PR key value of the current reservation holder. The persistent reservation key value is 0 if the PR

            Type is 5 or 6.

       Persistent reserve in (prin) operation

       1    To read all of the registered reservation keys, enter the following command:

            # devrsrv -c prin -s 0 -l hdisk0

            Registered PR Keys              :

            555

            777

       2    To read the current reservation key holder and type, enter the following command:

            # devrsrv -c prin -s 1 -l hdisk0

            PR Generation Value     :  2

            PR Type                 :  PR_EA_RO (EXCLUSIVE ACCESS, REGISTRANTS ONLY)

            PR Holder Key Value     :  777

       3    To return the PR capabilities information that is supported by sending the report capabilities service action, enter

            the following command:

            # devrsrv -c prin -s 2 -l hdisk0

            PR Capabilities Byte[2]         :  0xd  SIP_C   ATP_C   PTPL_C

            PR Capabilities Byte[3]         :  0x0

            PR Types Supported              :  NOT VALID

       Persistent reserve out (prout) operation

       RELEASE service action

       To release the persistent reservation from IT-nexus that is registered and reserved with key 1777 and PR reservation type

       4, enter the following command:

       # devrsrv -c prout -s 2 -r 1777 -t 4 -l hdisk0

       Device Reservation State Information

       ==================================================

       Device Name                     :  hdisk0

       Device Open On Current Host?    :  YES

       ODM Reservation Policy          :  PR SHARED

       ODM PR Key Value                :  7777

       Device Reservation State        :  PR SHARED

       Reservation will be cleared on the device. Do you want to continue y/n:y

       If you run the query now, the result displays the Device Reservation State as NO RESERVE.

       # devrsrv -c query -l hdisk0

       Device Reservation State Information

       ==================================================

       Device Name              :  hdisk0

       Device Open              :  NO

       ODM Reservation Policy   :  PR SHARED

       ODM PR Key Value         :  7777

       Device Reservation State :  NO RESERVE

       Registered PR Keys       :

       555

       1777

       PR Capabilities Byte[2]  :  0xd  SIP_C   ATP_C   PTPL_C

       PR Capabilities Byte[3]  :  0x0

       PR Types Supported       :  NOT VALID

       CLEAR service action

       To release the persistent reservation and to remove all the registrations from a device server that uses the CLEAR

       service action by using a registered I/O path with key 555, enter the following command:

       # devrsrv -c prout -s 3 -r 555 -l hdisk0

       Device Reservation State Information

       ==================================================

       Device Name                     :  hdisk0

       Device Open On Current Host?    :  YES

       ODM Reservation Policy          :  PR SHARED

       ODM PR Key Value                :  5555

       Device Reservation State        :  PR SHARED

       Reservation will be cleared on the device. Do you want to continue y/n:y

       If you run the query now, the persistent reservation is released and the registrations are removed from the device.

       # devrsrv -c query -l hdisk0

       Device Reservation State Information

       ==================================================

       Device Name               :  hdisk0

       Device Open               :  NO

       ODM Reservation Policy    :  PR SHARED

       ODM PR Key Value          :  5555

       Device Reservation State  :  NO RESERVE

       Registered PR Keys        :  No Keys Registered

       PR Capabilities Byte[2]   :  0xd  SIP_C   ATP_C   PTPL_C

       PR Capabilities Byte[3]   :  0x0

       PR Types Supported        :  NOT VALID

       PREEMPT and PREEMPT_ABORT service actions

       To preempt the persistent reservation that is held with reservation holder 444 by another IT-nexus with the registered

       key 777, enter the following command:

       # devrsrv -c prout -s 4 -r 777 -k 444 -t 2 -l hdisk0

       Before you run the # devrsrv -c prout -s 4 -r 777 -k 444 -t 2 -l hdisk0 command, the query output is displayed as

       follows.

       # devrsrv -c query -l hdisk0

       Device Reservation State Information

       ==================================================

       Device Name               :  hdisk0

       Device Open               :  NO

       ODM Reservation Policy    :  PR SHARED

       ODM PR Key Value          :  7777

       Device Reservation State  :  PR EXCLUSIVE

       PR Generation Value       :  5

       PR Type                   :  PR_WE (WRITE EXCLUSIVE)

       PR Holder Key Value       :  444

       Registered PR Keys        :

       777

       444

       PR Capabilities Byte[2]   :  0xd  SIP_C   ATP_C   PTPL_C

       PR Capabilities Byte[3]   :  0x0

       PR Types Supported        :  NOT VALID

       After you run the # devrsrv -c prout -s 4 -r 777 -k 444 -t 2 -l hdisk0 command, the query output shows that the

       reservation is preempted by IT-nexus with key 777 and key 444 is unregistered.

       # devrsrv -c query -l hdisk0

       Device Reservation State Information

       ==================================================

       Device Name              :  hdisk0

       Device Open              :  NO

       ODM Reservation Policy   :  PR SHARED

       ODM PR Key Value         :  7777

       Device Reservation State :  PR EXCLUSIVE

       PR Generation Value      :  6

       PR Type                  :  PR_EA (EXCLUSIVE ACCESS)

       PR Holder Key Value      :  777

       Registered PR Keys       :

       777

       PR Capabilities Byte[2]  :  0xd  SIP_C   ATP_C   PTPL_C

       PR Capabilities Byte[3]  :  0x0

       PR Types Supported       :  NOT VALID

       RELEASE operation for SINGLE PATH RESERVE policy

       To release the reservation on the hdisk0 device, enter the following commands:

       *    Scenario 1: The current host is the owner of the reservation.

            # devrsrv -c query -l hdisk0

            Device Reservation State Information

            ==================================================

            Device Name                     :  hdisk0

            Device Open On Current Host?    :  YES

            ODM Reservation Policy          :  SINGLE PATH RESERVE

            Device Reservation State        :  SINGLE PATH RESERVE

            Path Id of Reserved Path        :  0

            # devrsrv -c release -l hdisk0

            Device Reservation State Information

            ==================================================

            Device Name                     :  hdisk0

            Device Open On Current Host?    :  YES

            ODM Reservation Policy          :  SINGLE PATH RESERVE

            Device Reservation State        :  SINGLE PATH RESERVE

            Device is currently Open on this host by a process.Do you want to continue y/n:y

            Command Successful

            Reservation cleared on the device. Query operation may not work properly.

            Close the application that holds the reservation and retry.

       *    Scenario 2: The current host is not the owner of the reservation.

            # devrsrv -c query -l hdisk0

            Device Reservation State Information

            ==================================================

            Device Name                     :  hdisk0

            Device Open On Current Host?    :  NO

            ODM Reservation Policy          :  SINGLE PATH RESERVE

            Device Reservation State        :  SINGLE PATH RESERVE

            Because the current host does not own the reservation on the device,

            try the force option if you want to break the reservation.

            # devrsrv -f -l hdisk0

            The device is already reserved by using the single-path reservation by another host.

            Device Reservation State Information

            ==================================================

            Device Name                     :  hdisk0

            Device Open On Current Host?    :  NO

            ODM Reservation Policy          :  SINGLE PATH RESERVE

            Device Reservation State        :  SINGLE PATH RESERVE

            Reservation will be cleared on the device. Do you want to continue y/n:y

            After you run the release command successfully, the query option must display NO RESERVE as the device reservation

            state.

            # devrsrv -c query -l hdisk0

            Device Reservation State Information

            ==================================================

            Device Name                     :  hdisk0

            Device Open On Current Host?    :  NO

            ODM Reservation Policy          :  SINGLE PATH RESERVE

            Device Reservation State        :  NO RESERVE

       Forced mode

       The hdisk0 device is reserved with key 777 from another I/O path. To release this reservation from the other client,

       enter the following command:

       # devrsrv -f -l hdisk0

       Device Reservation State Information

       ==================================================

       Device Name                     :  hdisk16

       Device Open On Current Host?    :  NO

       ODM Reservation Policy          :  PR SHARED

       ODM PR Key Value                :  5555

       Device Reservation State        :  PR SHARED

       Reservation will be cleared on the device. Do you want to continue y/n:y

       Command Successful

       Before you run the # devrsrv -f -l hdisk0 command, the query displays the following output:

       # devrsrv -c query -l hdisk0

       Device Reservation State Information

       ==================================================

       Device Name               :  hdisk0

       Device Open               :  NO

       ODM Reservation Policy    :  PR SHARED

       ODM PR Key Value          :  5555

       Device Reservation State  :  PR EXCLUSIVE

       PR Generation Value       :  1

       PR Type                   :  PR_WE (WRITE EXCLUSIVE)

       PR Holder Key Value       :  777

       Registered PR Keys        :

       777

       PR Capabilities Byte[2]   :  0xd  SIP_C   ATP_C   PTPL_C

       PR Capabilities Byte[3]   :  0x0

       PR Types Supported        :  NOT VALID

       After you execute the # devrsrv -f -l hdisk0 command, the output indicates that the device is not reserved.

       # devrsrv -c query -l hdisk0

       Device Reservation State Information

       ==================================================

       Device Name                     :  hdisk16

       Device Open On Current Host?    :  NO

       ODM Reservation Policy          :  PR SHARED

       ODM PR Key Value                :  5555

       Device Reservation State        :  NO RESERVE

       Registered PR Keys              :  No Keys Registered

       PR Capabilities Byte[2]         :  0x0

       PR Capabilities Byte[3]         :  0x0

       PR Types Supported              :  NOT VALID

 

   
© ALLROUNDER