chhost

Use o comando chhost para alterar o nome ou tipo de um objeto do host. Esse comando não afeta nenhum mapeamento de host existente.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>- chhost -- --+----------------------------------+------------>
                '- -type --+- hpux -----------+-- -'   
                           +- tpgs -----------+        
                           +- generic --------+        
                           +- openvms --------+        
                           +- adminlun -------+        
                           '- hide_secondary -'        

>--+---------------------------+-- ----------------------------->
   '- -mask - port_login_mask -'      

>--+-------------------------+-- ------------------------------->
   '- -name -- new_name_arg -'      

>--+-------------------------------------------------+-- ------->
   '- -iscsiusername -- username_for_authentication -'      

>--+------------------------------+----------------------------->
   +- -chapsecret -- chap_secret -+   
   '- -nochapsecret --------------'   

>--+--------------------------+--+- host_name -+---------------><
   +- -site --+- site_name -+-+  '- host_id ---'   
   |          '- site_id ---' |                    
   '- -nosite ----------------'                    

Parâmetros

-type hpux | tpgs | generic | openvms | adminlun | hide_secondary
(Opcional) Especifica o tipo do host. Os valores a seguir são os tipos de hosts disponíveis:
  • generic indica o padrão.
  • tpgs indica quando as informações da porta de destino mudam (são dadas atenções extras da unidade ao host).
  • openvms indica OpenVMS.
  • adminlun indica volumes virtuais, que são ativados no host.
  • hpux indica o firmware HP-UX.
  • hide_secondary indica que todos os volumes secundários de relacionamento de cópia remota estão indisponíveis para o host.

Para obter informações adicionais sobre hosts que requerem o parâmetro type, consulte a documentação de conexão de host do SAN Volume Controller .

-name new_name_arg
(Opcional) Especifica o novo nome que você deseja designar para o objeto do host.
-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 números 0 e 1, em que 0 indica que a porta de E/S do FC correspondente não poderá ser usada e 1 indica que poderá. O bit mais à direita na máscara corresponde à porta de E/S FC 1. Os valores de máscara válidos vão 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.
-iscsiusername username_for_authentication
(Opcional) Especifica o nome do usuário para um objeto host para autenticação unilateral para login de conexão de host do Small Computer System Interface (iSCSI). Se esse parâmetro for especificado, o valor será obtido como o "username" para autenticação unilateral para efetuar login na conexão de host do iSCSI. Se você não especificar o parâmetro iscsiusername, o IQN do objeto do host será usado como o nome do usuário por padrão. Se nenhum parâmetro iscsiusername for fornecido e existirem vários IQNs no mesmo objeto do host, o nome do usuário de cada IQN será o próprio IQN. Se o parâmetro iscsiusername for fornecido para um host de múltiplos IQNs, então efetue login em todos os hosts usando o IQN fornecido. Se você usar o parâmetro iscsiusername, deve-se também especificar o parâmetro chapsecret.
-chapsecret chap_secret
(Opcional) Configura o segredo do Challenge Handshake Authentication Protocol (CHAP) que é usado para autenticar o host para a E/S do iSCSI. Esse segredo é compartilhado entre o host e o cluster. O segredo do CHAP para cada host pode ser listado usando o comando lsiscsiauth.
-nochapsecret
(Opcional) Limpa qualquer segredo do CHAP configurado anteriormente para este host. O parâmetro nochapsecret não poderá ser especificado se chapsecret estiver especificado.
-site site_name | site_id
(Opcional) Especifica o valor do site numérico ou o nome do site do host. O nome do site deve ser um valor alfanumérico. O ID do site deve ser 1 ou 2. O site designado a um host pode ser mudado com qualquer topologia: (hyperswap, stretched ou standard).
Nota: Se o host for mapeado para um volume que esteja em um relacionamento ativo, não será possível especificar -nosite.
-nosite
(Opcional) Reconfigura o valor do site.
host_name | host_id
(Obrigatório) Especifica, por ID ou pelo nome atual, o objeto de host a ser modificado.

Descrição

Esse comando pode alterar o nome do host especificado para um novo nome ou pode alterar o tipo de host. Esse comando não afeta nenhum dos mapeamentos de host atual.

A máscara da porta aplica-se a logins da porta do inicializador do host associados ao objeto de host. Para cada login entre uma porta do adaptador de barramento de host (HBA) e uma porta de nó, o nó examina a máscara da porta que está associada ao objeto do host para o qual o HBA de host é um membro e determina se o acesso é permitido ou negado. Se o acesso for negado, o nó responderá aos comandos SCSI como se a porta fosse desconhecida.

Nota: Quando todos os grupos de E/S são removidos de um host iSCSI, o comando lsiscsiauth não exibe a entrada de autenticação desse host. Use o comando addhostiogrp para mapear o host iSCSI para pelo menos um grupo de E/S e, em seguida, use o comando addhostport para incluir a porta iSCSI nele. Você também deve incluir autenticação para esse host usando o comando chhost com o parâmetro chapsecret ou nochapsecret.

Um Exemplo de Chamada

chhost -name testhostlode -mask 111111101101 hostone

A seguinte saída é exibida:

Sem feedback

Um Exemplo de Chamada

chhost -type openvms 0

A seguinte saída é exibida:

Sem feedback

Um Exemplo de Chamada

chhost -site site1 host3

A seguinte saída é exibida:

Sem feedback