mkhost

Use o comando mkhost para criar um objeto de host lógico.

Sintaxe

Parâmetros

-name new_name: (Opcional) Especifica um nome ou etiqueta para o novo objeto de host.
-protocol scsi | nvme: (Opcional) Especifica o protocolo usado pelo host para se comunicar com o sistema de armazenamento. O padrão é scsi.
-saswwpn wwpn_list: (Obrigatório se você não usar -iscsiname, -fcwwpn ou -nqn.) Especifica uma lista de WWPNs Serial Attached SCSI (SAS) com uma sequência hexadecimal de 16 caracteres.
-fcwwpn wwpn_list: (Obrigatório se você não usar -saswwpn, -iscsiname ou -nqn.) Especifica uma lista de WWPNs Fibre Channel (FC) com uma sequência hexadecimal de 16 caracteres.
-iscsiname iscsi_name_list: (Obrigatório se você não usar -fcwwpn, -saswwpn ou -nqn.) Especifica a lista separada por vírgulas de nomes iSCSI a serem incluídos no host. Pelo menos um nome de WWPN ou iSCSI deve ser especificado. Não é possível usar esse parâmetro com o parâmetro -fcwwpn ou -saswwpn.
-nqn nqn_list: (Obrigatório se você não usar -fcwwpn, -saswwpn ou -iscsiname.) Especifica a lista separada por vírgula de Nomes Qualificados de NVMe (NQNs) a serem incluídos no host. O protocolo do host deve ser nvme para usar este parâmetro.
-iogrp iogrp_list: (Opcional) Especifica um conjunto de um ou mais grupos de entrada/saída (E/S) a partir do qual o host pode acessar os volumes. Grupos de E/S são especificados usando seus nomes ou IDs, separados por dois pontos. Os nomes e IDs podem ser combinados na lista. Se esse parâmetro não for especificado, o host será associado a todos os grupos de E/S.
-mask port_login_mask: (Opcional) Especifica quais portas de destino do nó um host pode acessar e a máscara de porta do Fibre Channel (FC) para o host. Os nomes da porta universal (WWPNs) no objeto do host devem acessar volumes a partir das portas de nó que são incluídas na máscara e que estão no grupo de E/S do objeto do host. A máscara de porta é um binário de 64 bits e é composta de uma combinação de 0 e 1, em que 0 indica não usar a porta de E/S FC correspondente e 1 indica o uso da porta de E/S FC correspondente. O bit mais à direita na máscara corresponde à porta 1 de E/S FC. Os valores de máscara válidos podem variar de 0000 (nenhuma porta ativada) a 1111111111111111111111111111111111111111111111111111111111111111 (todas as portas ativadas). Por exemplo, uma máscara 111111101101 ativa as portas 1, 3, 4, 6, 7, 8, 9, 10, 11 e 12.
-force: (Opcional) Especifica que um objeto de host lógico é criado sem a validação dos WWPNs.
-type hpux | tpgs | generic | openvms | adminlun | hide_secondary: (Opcional) Especifica o tipo do host. O padrão é generic. O tipo de host adminlun é equivalente ao tipo de host VVOL na GUI de gerenciamento.
-hostcluster host_cluster_id | host_cluster_name: (Opcional) Especifica o ID (valor numérico) ou nome (valor alfanumérico) do cluster do host no qual o novo objeto do host é criado.
-ownershipgroup owner_id | owner_name: (Opcional) O nome ou ID do grupo de propriedades no qual o objeto está sendo incluído.

Descrição

O comando mkhost associa um ou mais WWPNs do HBA, nomes iSCSI ou NQNs a um objeto do host lógico. Esse comando cria um novo host. O ID é exibido quando o comando é concluído. Subsequentemente, é possível usar esse objeto ao mapear volumes para hosts usando o comando mkvdiskhostmap. Se você criar um host diretamente dentro de um cluster do host especificando -hostcluster, ele herdará quaisquer mapeamentos compartilhados existentes.

Os NQNs poderão ser incluídos apenas se o protocol for nvme. Todos os outros tipos de portas poderão ser incluídos somente se o protocol do host for scsi. Hosts de protocolo duplo não são suportados. Um host não pode ser incluído em um cluster do host que possui um protocolo diferente para o host. Os hosts NVMe devem ter o type configurado como default.

Emita o comando mkhost somente uma vez. O sistema em cluster varre a malha em busca de WWPNs na zona de host. O sistema em si não pode filtrar nos hosts para determinar quais WWPNs estão em quais hosts. Portanto, use o comando mkhost para identificar os hosts.

Depois de identificar os hosts, os mapeamentos são criados entre os hosts e volumes. Esses mapeamentos apresentam, de maneira efetiva, os volumes para os hosts para os quais eles são mapeados. Todos os WWPNs do objeto de host são mapeados para os volumes.

Alguns drivers de dispositivo HBA não são registrados na malha até reconhecerem números de unidade lógica (LUNs) de destino. Como eles não efetuam login, seus WWPNs não são reconhecidos como portas candidatas. É possível especificar o parâmetro force com esse comando para parar a validação da lista de WWPNs.

Esse comando falhará se você incluir o host em um grupo de E/S que estiver associado a mais portas do host ou objetos do host do que o permitido pelos limites dentro do sistema.

Para obter informações adicionais, consulte os comandosmkvdiskhostmap, lssasportcandidate e lsfcportcandidate.

Para obter mais informações sobre os requisitos de parâmetro para seu host específico, consulte o site de suporte a seguir: http://www-03.ibm.com/systems/support/storage/ssic/interoperability.wss.

Um exemplo de chamada

mkhost -name hostone -saswwpn 210100E08B251DD4:210100F08C262DD8 -force -mask 111111101101

A saída do resultado:

ID do Host [1] criado com sucesso

Um exemplo de chamada

mkhost -iscsiname iqn.localhost.hostid.7f000001 -name newhost

A saída do resultado:

Host, id [10], successfully created

Um Exemplo de Chamada

mkhost -fcwwpn 210100E08B251EE6:210100F08C262EE7 -type openvms

A saída resultante:

Host, ID [1], criado com êxito

Um Exemplo de Chamada

mkhost -fcwwpn 210100E08B251EE6 -site site1

A saída resultante:

Host, ID [1], criado com êxito

Um Exemplo de Chamada

mkhost -nqn nqn.2014-08.org.nvmexpress :NVMf:uuid: 644f51bf-8432-4f59-bb13-5ad13-5ada20c06397 -protocol nvme

A saída resultante:

Host, id [1], successfully created