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
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:
genericindica o padrão.tpgsindica quando as informações da porta de destino mudam (são dadas atenções extras da unidade ao host).openvmsindica OpenVMS.adminlunindica volumes virtuais, que são ativados no host.hpuxindica o firmware HP-UX.hide_secondaryindica que todos os volumes secundários de relacionamento de cópia remota estão indisponíveis para o host.
O tipo de host para hosts NVMe não pode ser mudado. 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.
- -protocol scsi | nvme
- (Opcional) Especifica o protocolo que é usado pelo host para se comunicar com o sistema de armazenamento. O padrão é scsi. O host -protocol
não pode ser mudado ao mesmo tempo que o host -type. O protocol de um
host pode ser mudado apenas se os seguintes itens forem verdadeiros:
- Nenhum volume é mapeado para o host.
- Nenhuma porta está definida no host.
- O tipo de host é compatível com o novo protocolo. Um host que usa o protocolo NVMe deve ser do tipo generic.
- -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.
Atenção: Mudar a máscara da porta do host pode resultar em uma perda de acesso. Antes de desativar portas, verifique se o host tem acesso a outras portas.
- -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 de usuário de cada IQN será o próprio IQN. Se o parâmetro iscsiusername for fornecido para um host de IQNs múltiplos, 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
1ou2. O site designado a um host pode ser mudado com qualquer topologia: (hyperswap,stretchedoustandard).Nota: Se o host for mapeado para um volume que esteja em um relacionamento ativo/ativo (HyperSwap), não será possível especificar -nosite. - -nosite
- (Opcional) Reconfigura o valor do site.
- -statuspolicy redundant | complete
- (Opcional) Especifica se a política complete ou redundant é usada para cálculos de status on-line.
- Conectividade completa é aquela em que o status do host on-line indica conectividade completa, com cada porta do host logada em cada nó através dos quais um host pode acessar volumes e o status do host comprometido indica que um ou mais desses nós não têm login.
- Cálculo de conectividade redundante é aquele em que o status do host on-line indica conectividade redundante, em que portas suficientes do host são logadas a nós suficientes, de modo que a remoção de um único nó ou único host permita que o host acesse todos os seus volumes. Além disso, deve haver a mesma contagem do total de logins a partir do host para cada nó dentro de um grupo de E/S. O status do host Degradado indica conectividade não redundante, em que um único ponto de falha evita que um host acesse pelo menos alguns de seus volumes, ou não há nenhum ponto de falha, mas a contagem total de login do host para cada nó dentro de um grupo de E/S é Não é a mesma coisa.
O valor padrão é redundant.
- -statussite all | local
- (Opcional) Especifica se a conectividade de todos os sites, all, ou apenas do site host local é usada para determinar o status on-line. local é aplicável apenas em uma topologia de site dual para um host com um site válido. O valor padrão é all.
- -ownershipgroup owner_id | owner_name
- (Opcional) O nome ou ID do grupo de propriedades no qual o objeto está sendo incluído.
- -noownershipgroup
- (Opcional) Se especificado, o objeto será removido do grupo de propriedades ao qual ele pertence.
- 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 do 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 do qual o HBA do host é 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.
Um exemplo de chamada
chhost -name testhostlode -mask 111111101101 hostone
A seguinte saída é exibida:
Sem feedbackUm exemplo de chamada
chhost -type openvms 0
A seguinte saída é exibida:
Sem feedback
Um exemplo de chamada
chhost -site site1 host3A seguinte saída é exibida:
Sem feedback
Um exemplo de chamada mudando a propriedade de um host
chhost -ownershipgroup 2 myhost
A seguinte saída é exibida:
Sem feedbackUm exemplo de chamada movendo o host para nenhuma propriedade
chhost -noownershipgroup myhost
A seguinte saída é exibida:
Sem feedback