Use os comandos esxcli para adicionar uma regra de reivindicação de PSA de vários caminhos ao conjunto de regras de reivindicação no sistema. Para que a nova regra de reivindicação fique ativa, primeiro defina a regra e, em seguida, carregue-a no sistema.

Exemplos de quando você adiciona uma regra de reivindicação de PSA incluem:
  • Você carrega um novo MPP de terceiros e deve definir os caminhos reivindicados por este módulo.
  • Você deve ativar o HPP nativo.
Aviso: Não é possível criar regras em que dois plug-ins diferentes reivindicam caminhos para o mesmo dispositivo. Suas tentativas de criar essas regras de reivindicação falham com um aviso em vmkernel.log .

Pré-requisitos

Instale o ESXCLI. Consulte Introdução ao ESXCLI . Para solução de problemas, execute esxcli comandos no ESXi Shell.

Procedimento

  1. Para definir uma nova regra de reivindicação, use o seguinte comando:
    reivindicação de núcleo de armazenamento esxcli add

    O comando tem as seguintes opções:

    Opção Descrição
    -A|--adapter=<adapter> Adaptador dos caminhos a serem usados. Válido somente se --type for location.
    -u|--autoassign Adiciona uma regra de reivindicação com base em suas características. O número da regra não é necessário.
    -C|--channel=<channel> Canal dos caminhos a serem usados. Válido somente se --type for location.
    -c|--claimrule-class=<cl> Reivindicar a classe de regra a ser usada nesta operação. Você pode especificar MP (padrão), Filter ou VAAI.

    Para configurar a aceleração de hardware para uma nova matriz, adicione duas regras de reivindicação, uma para o filtro VAAI e outra para o plug-in VAAI. Consulte Adicionar regras de reivindicação de aceleração de hardware para obter instruções detalhadas.

    -d|--device=<device_uid> UID do dispositivo. Válido somente quando --type for device.
    -D|--driver=<driver> Driver para o HBA dos caminhos a serem usados. Válido somente se --type for driver.
    -f|--force Forçar regras de reivindicação a ignorar as verificações de validade e instalar a regra de qualquer maneira.
    --force-reserved Substituir proteção de intervalos de ID de regra reservados.

    As regras de reivindicação reservadas são as regras com um ID abaixo de 100. Você pode usá-los para reatribuir dispositivos locais a plug-ins específicos, por exemplo, o dispositivo NVMe para HPP.

    --if-unset=<str> Execute este comando se essa variável de usuário avançado não estiver definida como 1.
    -i|--iqn=<iscsi_name> Nome Qualificado iSCSI para o destino. Válido somente quando --type for target .
    -L|--lun=<lun_id> LUN dos caminhos. Válido somente se --type for location.

    A ID do LUN não deve ser maior que o valor da opção de configuração avançada / Disco / MaxLUN.

    -M|--model=<model> Modelo dos caminhos a serem usados. Válido somente se --type for vendor.

    Valores válidos são valores da cadeia de caracteres de Modelo da cadeia de consulta SCSI. Execute vicfg-scsidevs <conn_options> -l em cada dispositivo para ver os valores da cadeia de caracteres do modelo.

    -P|--plugin=<plugin> Plug-in PSA a ser usado. Os valores são NMP, MASK_PATH ou HPP. Terceiros também podem fornecer seus próprios plug-ins PSA. Obrigatório.
    -r|--rule=<rule_ID> ID da regra a ser usada. O ID da regra indica a ordem na qual a regra de reivindicação deve ser avaliada. As regras de reivindicação definidas pelo usuário são avaliadas em ordem numérica, começando com 101.

    Você pode executar esxcli storage core claimrule list para determinar quais IDs de regra estão disponíveis.
    -T|--target=<target> Destino dos caminhos a serem usados. Válido somente se --type for location.
    -R|--transport=<transport>

    Transporte dos caminhos a serem usados. Válido somente se --type for transport. Os seguintes valores são suportados.

    • block - bloquear armazenamento
    • fc - Fibre Channel
    • iscsivendor - iSCSI
    • iscsi - não usado atualmente
    • ide - Armazenamento IDE
    • sas - Armazenamento SAS
    • sata - Armazenamento SATA
    • usb - Armazenamento USB
    • parallel - paralelo
    • fcoe - FCoE
    • unknown
    -t|--type=<type> Tipo de correspondência a ser usada para a operação. Os valores válidos são os seguintes. Obrigatório.
    • vendor
    • location
    • driver
    • transport
    • device
    • target
    -V|--vendor=<vendor> Fornecedor dos caminhos a serem usados. Válido somente se --type for vendor.

    Valores válidos são valores da cadeia de caracteres do fornecedor da cadeia de consulta SCSI. Execute vicfg-scsidevs <conn_options> -l em cada dispositivo para ver os valores de cadeia de caracteres do fornecedor.

    --wwnn=<wwnn> Número de nó mundial para o destino.
    --wwpn=<wwpn> Número de porta mundial para o destino.
    -a|--xcopy-use-array-values Use os valores relatados da matriz para construir o comando XCOPY a ser enviado para a matriz de armazenamento. Isso se aplica somente às regras de reivindicação VAAI.
    -s|--xcopy-use-multi-segs Use vários segmentos ao emitir uma solicitação XCOPY. Válido somente se --xcopy-use-array-values for especificado.
    -m|--xcopy-max-transfer-size Tamanho máximo de transferência de dados em MB quando você usa um tamanho de transferência diferente da matriz relatada. Válido somente se --xcopy-use-array-values for especificado.
    -k|--xcopy-max-transfer-size-kib Tamanho máximo de transferência em KiB para os comandos XCOPY quando você usa um tamanho de transferência diferente da matriz relatada. Válido somente se --xcopy-use-array-values for especificado.
  2. Para carregar a nova regra de reivindicação em seu sistema, use o seguinte comando:
    carga de reivindicação de núcleo de armazenamento esxcli
    Esse comando carrega todas as regras de reivindicação de vários caminhos recém-criadas do arquivo de configuração esx.conf para o VMkernel. O comando não tem opções.
  3. Para aplicar regras de reivindicação carregadas, use o seguinte comando:
    execução de reivindicação de núcleo de armazenamento esxcli

    O comando tem as seguintes opções:

    Opção Descrição
    -A|--adapter=<adapter> Se --type for location, nome do HBA para os caminhos nos quais as regras de reivindicação serão executadas. Para executar regras de reivindicação em caminhos de todos os adaptadores, omita essa opção.
    -C|--channel=<channel> Se --type for location, o valor do número do canal SCSI para os caminhos nos quais as regras de reivindicação serão executadas. Para executar regras de reivindicação em caminhos com qualquer número de canal, omita essa opção.
    -c|--claimrule-class=<cl> Reivindicar a classe de regra a ser usada nesta operação.
    -d|--device=<device_uid> UID do dispositivo.
    -L|--lun=<lun_id> Se --type for location, o valor do LUN SCSI para os caminhos para executar as regras de declaração. Para executar regras de reivindicação em caminhos com qualquer LUN, omita essa opção.
    -p|--path=<path_uid> Se --type for path, essa opção indicará o identificador de caminho exclusivo (UID) ou o nome do tempo de execução de um caminho no qual executar as regras de reivindicação.
    -T|--target=<target> Se --type for location, o valor do número de destino SCSI para os caminhos nos quais as regras de reivindicação serão executadas. Para executar regras de reivindicação em caminhos com qualquer número de destino, omita essa opção.
    -t|--type=<location|path|all> Tipo de reivindicação a ser executada. Por padrão, o usa all, o que significa que as regras de reivindicação são executadas sem restrição para caminhos específicos ou endereços SCSI. Os valores válidos são location, path e all.
    -w|--wait Você poderá usar essa opção somente se também usar --type all.

    Se a opção estiver incluída, a reivindicação aguardará a resolução dos caminhos antes de executar a operação de reivindicação. Nesse caso, o sistema não iniciará o processo de reivindicação até que seja provável que todos os caminhos no sistema tenham aparecido antes de iniciar o processo de reivindicação.

    Após o início do processo de reivindicação, o comando não retornará até que o registro do dispositivo seja concluído.

    Se você adicionar ou remover caminhos durante o processo de reivindicação ou descoberta, essa opção poderá não funcionar corretamente.

Exemplo: Definindo regras de reivindicação de vários caminhos

No exemplo a seguir, você adiciona e carrega a regra # 500. A regra reivindica todos os caminhos com a cadeia de caracteres do modelo NewMod e a cadeia de fornecedores NewVend para o plug-in NMP.

# esxcli storage core reivindicaçãorule add -r 500 -t fornecedor -V NewVend -M NewMod -P NMP

# esxcli storage core reivindrule load

Depois de executar o comando esxcli storage core reivindrule list , você poderá ver a nova regra de reivindicação aparecendo na lista.

A seguinte saída indica que a regra de reivindicação 500 foi carregada no sistema e está ativa. 
Rule Class  Rule   Class    Type       Plugin     Matches
...         ...    ...      ...        ...        ...
MP          500    runtime  vendor     NMP        vendor=NewVend model=NewMod  
MP          500    file     vendor     NMP        vendor=NewVend model=NewMod