mkvdiskhostmap

Use o comando mkvdiskhostmap para criar um novo mapeamento entre um volume e um host, que faz com que o volume fique acessível para operações de entrada/saída (E/S) para o host especificado.

Sintaxe

Parâmetros

-force: (Opcional) Permite múltiplas designações de volume-para-host, o que normalmente não são permitidas.
-host host_id | host_name: (Obrigatório) Especifica o host para mapear o volume, seja pelo ID ou pelo nome.
-scsi scsi_num_arg: (Opcional) Especifica o ID de número da unidade lógica (LUN) do Small Computer System Interface (SCSI) para designar a esse volume no host fornecido. O parâmetro scsi_num_arg contém o ID de LUN do SCSI que é designado para o volume no host especificado para todos os grupos de E/S que fornecem acesso ao volume. Você deve verificar no seu sistema host o próximo ID de LUN do SCSI disponível no adaptador de barramento de host (HBA) especificado. Se você não especificar o parâmetro -scsi, o próximo ID de LUN SCSI disponível em cada grupo de E/S que fornece acesso será fornecido para o host. O parâmetro -scsi não é suportado para hosts NVMe. Quando um volume é mapeado para um host que usa o protocolo NVMe, o ID de namespace de volume (NSID) é designado pelo sistema. Este parâmetro é mutuamente exclusivo com -allowmismatchedscsiids.
-allowmismatchedscsiids: (Opcional) Ao criar um novo mapeamento de host, este parâmetro permite que o sistema aloque IDs de LUN SCSI não idênticos nos grupos de E/S de acesso para o volume. Este parâmetro é mutuamente exclusivo com -scsi.
vdisk_name | vdisk_id: (Obrigatório) Especifica o nome do volume que você deseja mapear para o host, seja por ID ou por nome.

Descrição

Este comando cria um novo mapeamento entre o volume e o host especificado. O volume é apresentado para o host como se o disco estivesse conectado diretamente ao host. É apenas depois que esse comando for processado que o host poderá executar transações de E/S para o volume.

Opcionalmente, é possível designar um ID de LUN SCSI para o mapeamento para hosts SCSI. Quando o HBA no host fizer uma varredura dispositivos que estão conectados a ele, ele descobrirá todos os volumes que são mapeados para suas portas Fibre Channel. Quando os dispositivos forem localizados, para cada um será alocado um identificador (ID de LUN SCSI). Por exemplo, o primeiro disco localizado geralmente é o SCSI LUN 0 e assim por diante. É possível controlar a ordem na qual o HBA descobre volumes ao designar o ID de LUN SCSI, conforme necessário. Se não especificar um ID de LUN SCSI, o cluster designará automaticamente o próximo ID de LUN SCSI disponível, se qualquer mapeamento já existir com esse host. Quando o comando mkvdiskhostmap é emitido, o número do ID da LUN SCSI é retornado.

Para NVMe, o ID do LUN SCSI é irrelevante e, em vez dele, o sistema designa o NSID que não pode ser mudado. Quando você cria um mapeamento para um volume NVMe, o NSID é retornado (O NSID é o vdisk_ID + 1).

O comando mkvdiskhostmap falhará se o:

Host para o qual este mapeamento está sendo feito não é associado a nenhum dos grupos de E/S na configuração de acesso do volume
O volume tem mais de um grupo de E/S em sua configuração de acesso e o host que está sendo mapeado para o volume não suporta volumes que estão sendo mapeados a partir de diversos grupos de E/S.
O protocolo de host é incompatível com o protocolo de volume
O volume tem mais de um grupo de E/S de acesso e o protocolo de host é NVMe
Um ID de LUN SCSI idêntico não está disponível em todos os grupos de E/S de acesso

Se você não especificar um ID de LUN SCSI, o sistema tentará designar o menor ID de LUN SCSI comum em todos os grupos de E/S de acesso. O ID retornado é o mesmo para todos os grupos de E/S para os quais o volume está mapeado.

Use o parâmetro -allowmismatchedscsiids para permitir que o sistema aloque IDs de LUN SCSI não idênticos nos grupos de E/S de acesso. O menor valor disponível em cada grupo de E/S de acesso é usado. Ele pode não ser o mesmo em todos os grupos de E/S de acesso. Certifique-se de que o host suporte essa configuração. Este parâmetro não pode ser usado com o parâmetro -scsi e não é suportado para os hosts NVMe. Se um volume é mapeado para um host que usa o protocolo NVMe, o ID de namespace de volume (NSID) é designado pelo sistema.

Lembre-se: Os hosts iSCSI podem acessar volumes que estão acessíveis por meio de diversos grupos de E/S (assim como grupos de E/S únicos).

Se você gerar diferentes ID de LUN SCSI, apenas um será retornado. O ID retornado é para o grupo de E/S de numeração mais alta, ao qual o volume foi mapeado. Para visualizar outros valores, emita o comando lshostvdiskmap ou lsvdiskhostmap.

O ID de LUN SCSI é utilizado para o grupo de E/S de numeração mais alta para o qual o volume está mapeado.

Alguns drivers de dispositivo do HBA pararão quando localizarem uma diferença nos IDs de LUN do SCSI. Por exemplo:

O Volume 1 é mapeado para o Host 1 com o ID de LUN SCSI 1
O Volume 2 é mapeado para o Host 1 com o ID de LUN SCSI 2
O Volume 3 é mapeado para o Host 1 com o ID de LUN SCSI 4

Quando o driver de dispositivo fizer a varredura do HBA, ele deverá parar depois de identificar os volumes 1 e 2 porque nenhum LUN de SCSI é mapeado com o ID 3. Para obter um desempenho ideal, certifique-se de que a alocação de ID de LUN SCSI seja contígua.

É possível criar múltiplas designações de volume (designando o mesmo volume a múltiplos hosts, por exemplo, o que pode ser particularmente útil para hosts do sistema em cluster que designam um volume a múltiplos hosts). Normalmente, não são usadas diversas designações de volume ao host porque é provável que ocorram danos se mais de um host puder acessar um disco. No entanto, em certos ambientes de diversos caminhos, um volume deve ser mapeado para mais de um host. Isso inclui o IBM® SAN File System. Para mapear para mais de um host, você deve usar o comando mkvdiskhostmap com o parâmetro -force. Por exemplo:

mkvdiskhostmap -host host1 -force 4 mkvdiskhostmap -host host2 -force
     4

Nota: Ao designar o mesmo volume a vários hosts, use o mesmo ID SCSI para todos os hosts.

Esses comandos criam dois mapeamentos de host para volume para o volume 4 que são mapeados para host1 e host2. Omitir o parâmetro -force fará com que o mapeamento falhe se esse volume já estiver mapeado para um host.

O comando também falhará se o objeto do host (para o qual este mapeamento está sendo feito) não estiver associado ao grupo de E/S que contém o volume.

Se o novo mapeamento for criado entre um host (tipo hide_secondary) e um volume que é um volume secundário em um relacionamento de cópia remota, o:

Mapeamento será criado para propósitos de configuração (pode ser alterado ou excluído)
Volume secundário não estará presente no host

O volume mapeado é apresentado para o host se o:

O tipo de host for mudado para um tipo diferente de hide_secondary
Relacionamento da cópia remota for parado especificando o -access
Volume não é mais um volume secundário, pois o relacionamento da cópia remota foi excluído ou alternado

Nota: Não será possível especificar esse comando se o volume for um volume auxiliar em um relacionamento active-active ou se um volume for um volume de mudança em qualquer tipo de relacionamento.

Lembre-se: Este comando não pode ser usado em um volume pertencente a um sistema de arquivos.

Nota: Devido a uma limitação na especificação NVMe, os volumes HyperSwap e volumes com mais de um grupo de E/S de acesso não podem ser mapeados para hosts NVMe.

Um exemplo de chamada

mkvdiskhostmap -host host1 -scsi 1 5

A saída do resultado:

Virtual Disk to Host map, id [1], successfully created