mkhost
Use o comando mkhost para criar um objeto de host lógico.
Sintaxe
>>- mkhost -- --+---------------------+-- ----------------------> '- -name -- new_name -' >--+- -saswwpn -- wwpn_list ------+-----------------------------> +- -fcwwpn -- wwpn_list -------+ '- -iscsiname--iscsi_name_list-' >-- --+-----------------------+-- ------------------------------> '- -iogrp -iogrp_list -' >-- --+-------------------------+-- --+----------+--------------> '- -mask -port_login_mask-' '- -force -' >--+-------------------------------+--------------------------->< '- -type --+- hpux -----------+-' +- tpgs -----------+ +- generic --------+ +- openvms --------+ +- adminlun -------+ '- hide_secondary -'
Parâmetros
- -name new_name
- (Opcional) Especifica um nome ou etiqueta para o novo objeto de host.
- -saswwpn wwpn_list
- (Obrigatório se -iscsiname ou -fcwwpn não forem usados) Especifica uma lista de WWPNs da Serial Attached SCSI (SAS) com uma sequência hexadecimal de 16 caracteres.
- -fcwwpn wwpn_list
- (Obrigatório se você não usar -saswwpn ou -iscsiname) Especifica uma lista de WWPNs do Fibre Channel (FC) com uma sequência de 16 caracteres hexadecimais.
- -iscsiname iscsi_name_list
- (Obrigatório se você não usar -fcwwpn ou -saswwpn) Especifica a lista separada por vírgula 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.
- -iogrp iogrp_list
- (Opcional) Especifica um conjunto de um ou mais grupos de entrada/saída (E/S) do qual o host pode acessar os volumes. Os grupos de E/S são especificados usando seus nomes ou IDs, separados por vírgula. 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 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 por uma combinação de números 0 e 1, em que 0 indica que a porta de E/S FC correspondente não pode ser usada e 1 indica que esta porta pode ser usada. 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 de 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 pode ser 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 parâmetro tpgs permite as atenções extras de unidade de porta de destino. Consulte a documentação de conexão de host do Storwize V3700 para obter informações adicionais sobre os hosts que exigem o parâmetro type.
- -hostcluster host_cluster_id | host_cluster_name
- (Opcional) Especifica o ID (valor numérico) ou o nome (valor alfanumérico) do cluster do host no qual o novo objeto do host é criado.
Descrição
O comando mkhost associa um ou mais nomes WWPNs do HBA ou de iSCSI a um objeto do host lógico. Esse comando cria um novo host. O ID é exibido quando o comando é concluído. Posteriormente, é 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 ao especificar -hostcluster, ele herdará quaisquer mapeamentos compartilhados existentes.
Emita o comando mkhost apenas 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 efetuam login na malha até eles poderem visualizar os números da 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.
Um Exemplo de Chamada
mkhost -name hostone -saswwpn 210100E08B251DD4:210100F08C262DD8 -force -mask 111111101101
A saída resultante:
ID do Host [1] criado com sucesso
Um Exemplo de Chamada
mkhost -iscsiname iqn.localhost.hostid.7f000001 -name newhost
A saída resultante:
Host, id [10], successfully created
Um Exemplo de Chamada
mkhost -fcwwpn 210100E08B251EE6:210100F08C262EE7 -type openvms
A saída resultante:
Host, id [1], successfully created