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

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>- mkvdiskhostmap -- --+----------+-- ------------------------->
                        '- -force -'      

>-- -host --+- host_id ---+-- --+-------------------------+----->
            '- host_name -'     '- -scsi -- scsi_num_arg -'   

>-- --+- vdisk_name -+-----------------------------------------><
      '- vdisk_id ---'   

Parâmetros

-force
(Opcional) Permite diversas designações de volume para host, 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 do SCSI disponível em cada grupo de E/S que fornece acesso será fornecido para o host.
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

Esse 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. O host poderá executar transações de E/S para o volume somente depois que esse comando for processado.

Opcionalmente, poderá designar um ID de LUN SCSI para o mapeamento. Quando o HBA no host fizer uma varredura de 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.

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.
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:
  • Volume 1 é mapeado para o Host 1 com ID de LUN SCSI 1
  • Volume 2 é mapeado para o Host 1 com ID de LUN SCSI 2
  • Volume 3 é mapeado para o Host 1 com 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, você deve usar o mesmo ID de 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:
  • Tipo do host for mudado para um outro tipo diferente do 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

Um Exemplo de Chamada

mkvdiskhostmap -host host1 -scsi 1 5

A saída resultante:

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