Comando devrsrv

Propósito

Consultas e quebra o único caminho e as reservas persistentes em um dispositivo.

Sintaxe

devrsrv-c consulta [-e ] | liberação | prin -s sa | (prout -s sa -r rkey -k sa_key -t prtype ) -l nome do dispositivo

devrsrv-f -l nome do dispositivo

devrsrv -d

Descrição

O devrsrv comando consultas e quebra o único caminho e as reservas persistentes no dispositivo. O comando executa a reserva persistente em (prin) e as ações de serviço de reserva persistente (prout).

O subcomando query consulta e exibe o status de reserva atual do dispositivo. O subcomando release libera a reserva no dispositivo usando a reserva de trajeto único.

O subcomando prin exibe todas as chaves de reserva registradas, portador de chave de reserva e informações de capacidades. O subcomando prout solicita ação de serviço que reserva um dispositivo para o uso exclusivo ou compartilhado de um determinado caminho de E/S para o dispositivo. O subcomando prout suporta as seguintes ações de serviço:

Item	Descrição
LIBERAÇÃO	Libera a reserva persistente especificada para o dispositivo.
LIMPAR	Limpa todas as chaves de reserva e todas as reservas persistentes.
PREEMPT	Apreendem as reservas persistentes ou removem registros, ou ambos.
PREEMPT E ABORT	Preempta reservas persistentes ou remove registros, ou ambos e pára todas as tarefas para todos os caminhos de E/S preemptidos para o dispositivo.
REGISTRAR E IGNORAR CHAVE	Registra o novo valor da chave no lugar do valor da chave antiga.

Sinalizações

Item	Descrição
-c	Especifica os seguintes subcomandos: consultar Consultas e exibe o status de reservas em um dispositivo. liberação Libera o dispositivo com a reserva de caminho único usando SCSI-2. príncipe Especifica a reserva persistente em ação de serviço. prout Especifica a ação de serviço de saída de reserva persistente.
-d	Lista o nome do disco e outras informações de identificação para todos os discos que são consultados ou manipulados usando o comando devrsrv .
-e	Evita abrir o disco em modo exclusivo, o que inclui os modos único e diagnóstico. Esta sinalização é aplicável apenas para os tipos de reserva `PR_exclusive` e `PR_shared` . Se a política de reserva do Object Data Manager (ODM) for `single_path`, essa sinalização será ignorada. Nota: Em alguns casos, se você usar esta sinalização, o comando devrsrv pode não determinar o status de reserva do disco ou se o disco já está aberto no host local.
-f	Quebra a reserva que é realizada por outro caminho de E/S ou host. Para reservas de trajeto único, o comando devrsrv emite uma ação SC_FORCED_OPEN para quebrar a reserva. Para reservas persistentes, o comando devrsrv emite um subcomando prout juntamente com a ação do serviço CLEAR para limpar a reserva persistente e as registrações.
-k	Especifica a chave de reserva de ação do serviço. A sinalização -k é necessária para as ações de serviço REGISTER, PREEMPT e PREEMPT_ABORT.
-l	Especifica o nome do dispositivo.
-r	Especifica a chave de reserva. A sinalização -r é necessária para as ações de serviço REGISTER, PREEMPT, PREEMPT E ABORT e RELEASE.
-s	Especifica a ação de serviço para reservas persistentes. As ações de serviço válidas para o subcomando prin seguem: 0 CHAVES DE LEITURA 1 RESERVA DE LEITURA 2 CAPACIDADES DE RELATÓRIO As ações de serviço válidas para o subcomando prout seguem: 2 LIBERAÇÃO 3 LIMPAR 4 PREEMPT 5 PREEMPT E ABORT 6 REGISTRAR E IGNORAR A CHAVE EXISTENTE
-t	Especifica o tipo de reserva persistente. Os tipos de reservas persistentes seguem: 1 Escrever exclusivo 2 Acesso exclusivo 3 Escreva apenas registrantes exclusivos 4 Apenas registrantes de acesso exclusivo 5 Escreva exclusiva todos os registrantes 6 Acesso exclusivo todos os registrantes

Exemplos

A seguir, os exemplos que estão relacionados a diferentes cenários.

Query operation

Para consultar o status de reserva do dispositivo hdisk0 quando ele não for reservado por nenhum host, digite o seguinte comando:
```
# 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
```
A saída mostra que o dispositivo não está aberto no host atual e que a política de reserva do Object Data Manager (ODM) é SINGLE PATH RESERVE. Ele indica que a política de reserva está configurada no ODM para este dispositivo O estado de reserva do dispositivo indica a reserva que está presente no dispositivo. Você pode encontrar o estado de reserva do dispositivo executando uma sequência de comandos SCSI.

Para consultar o status de reserva do dispositivo hdisk1 quando ele é reservado por um host, digite o seguinte comando:

# devrsrv -c query -l hdisk1

O dispositivo é reservado usando a reserva de caminho único por um 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

Para consultar o status de reserva do dispositivo hdisk2 quando ele estiver reservado no mesmo host, digite o seguinte comando:

# 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

Para consultar o status de reserva do dispositivo hdisk2 quando a política de reserva ODM for PR SHARED e o dispositivo não for reservado por nenhum host, insira o comando a seguir:

# 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

As descrições de vários campos a partir da saída de consulta seguem:

Chaves de PR registradas:: Exibe teclas que são registradas executando o subcomando prout juntamente com a ação de serviço REGISTER de todos os caminhos de E/S que estão compartilhando este dispositivo.
PR Capacidades Bytes:: Indica o conteúdo de bytes 2 e 3 retornado pela ação de serviço REPORT CAPACIDADES do subcomando prin . Veja o padrão SPC para interpretar a saída do Exemplo 4.
Tipos De PR Suportados:: Exibe os tipos de reserva persistentes que são suportados pelo dispositivo que são relatados pelo campo de máscara do tipo de reserva persistente na saída de recursos do relatório.

Se a reserva persistente for mantida em um dispositivo, a saída de consulta exibe informações adicionais sobre a reserva do dispositivo da seguinte forma:

Tipo De Reserva De PR:: Exibe um dos valores dos Tipos de PR que estão descritos na seção Flags.
Chave do titular do PR Valor:: Exibe o valor da chave de PR do titular da reserva atual. O valor da chave de reserva persistente é 0 se o Tipo de PR for 5 ou 6.

Persistent reserve in (prin) operation

Para ler todas as chaves de reserva registradas, digite o seguinte comando:
```
# devrsrv -c prin -s 0 -l hdisk0
```
```
Registered PR Keys              :
555
777
```

Para ler o titular da chave de reserva atual e digite, digite o seguinte comando:

# 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

Para retornar as informações de capacidades do PR que são suportadas pelo envio da ação do serviço de recursos do relatório, digite o seguinte comando:

# 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

Para liberar a reserva persistente do IT-nexus que é registrado e reservado com chave 1777 e reserva de PR tipo 4, digite o seguinte comando:

# 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

Se você executar a consulta agora, o resultado exibe oDevice Reservation Statecomo 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

Para liberar a reserva persistente e para remover todos os registros de um servidor de dispositivo que utilize a ação do serviço CLEAR usando um caminho de E/S registrado com chave 555, digite o seguinte comando:

# 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

Se você executar a consulta agora, a reserva persistente é liberada e os registros são removidos do dispositivo.

# 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

Para preemir a reserva persistente que é realizada com o titular da reserva 444 por outro IT-nexus com a chave registrada 777, digite o seguinte comando:

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

Antes de executar o comando

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

, a saída de consulta é exibida da seguinte forma.

# 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

Depois de executar o comando # devrsrv -c prout -s 4 -r 777 -k 444 -t 2 -l hdisk0 , a saída de consulta mostra que a reserva é preemptida por IT-nexus com chave 777 e chave 444 está sem registro.

# 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

Para liberar a reserva no dispositivo hdisk0 , digite os seguintes comandos:

Cenário 1: O anfitrião atual é o proprietário da reserva.

# 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.

Cenário 2: O host atual não é o proprietário da reserva.

# 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

O dispositivo já está reservado usando a reserva de caminho único por outro 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

Depois de executar o comando de liberação com sucesso, a opção de consulta deve exibir NO RESERVE como o estado de reserva do dispositivo.

# 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

O dispositivo hdisk0 é reservado com chave 777 partir de outro caminho de E/S. Para liberar esta reserva do outro cliente, digite o seguinte comando:

# 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

Antes de executar o comando

# devrsrv
-f -l hdisk0

, a consulta exibe a seguinte saída:

# 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

Depois de executar o comando # devrsrv -f -l hdisk0 , a saída indica que o dispositivo não está reservado.

# 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