chsystem

Use o comando chsystem para modificar os atributos de um sistema em cluster existente (sistema). Insira esse comando a qualquer momento depois que um sistema é criado. Todos os parâmetros que estiverem associados a esse comando são opcionais. Entretanto, deve-se especificar um ou mais parâmetros com esse comando.

Sintaxe

Ler diagrama de sintaxeManter visual do diagrama de sintaxe
>>- chsystem -- --+------------------------+-- ----------------->
                  '- -name -- system_name -'      

>--+-----------------------------------+-- -- ------------------>
   '- -rcbuffersize -- new_size_in_MB -'         

>--+----------------------+-- ---------------------------------->
   '- -alias -- id_alias -'      

>--+--------------------------------------+-- ------------------>
   '- -icatip -- icat_console_ip_address -'      

>--+---------------------------------+-- ----------------------->
   '- -invemailinterval -- interval -'      

>--+--------------------------------------+-- ------------------>
   '- -gmlinktolerance -- link_tolerance -'      

>--+-------------------------------------+-- ------------------->
   '- -gmmaxhostdelay -- max_host_delay -'      

>--+-----------------------------------+-- --------------------->
   '- -icatip -- ipv4_icat_ip_address -'      

>--+-------------------------------------+-- ------------------->
   '- -icatip_6 -- ipv6_icat_ip_address -'      

>--+---------------------------------+-- ----------------------->
   '- -ntpip -- ipv4_ntp_ip_address -'      

>--+-----------------------------------+-- --------------------->
   '- -ntpip_6 -- ipv6_ntp_ip_address -'      

>--+---------------------------------+-- ----------------------->
   '- -isnsip -- sns_server_address -'      

>--+----------------------------------------+-- ---------------->
   '- -isnsip_6 -- ipv6_sns_server_address -'      

>--+----------------------------------------------------+-- ---->
   '- -relationshipbandwidthlimit -- bandwidth_in_mBps -'      

>--+-------------------------+-- ------------------------------->
   '- -infocenterurl -- url -'      

>--+----------------------------------------------------------+-->
   '- -iscsiauthmethod--+-nenhum----------------------------+-'   
                        '-chap-- -chapsecret-- chap_secret -'     

>--+--------------------------------------------------------+--->
   '- -rcauthmethod --+-nenhum----------------------------+-'   
                      '-chap-- -chapsecret-- chap_secret -'     

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

>--+------------------------------------------------------------------------------+-->
   '- -iscsiusername----nome do usuário do iscsi para autenticação de duas vias---'   

>-- --+--------------------------+-- --------------------------->
      '- -layer--+-replication-+-'      
                 '-storage-----'        

>--+-----------------------------+-- -- ------------------------>
   '- -cacheprefetch --+- on --+-'         
                       '- off -'           

>--+-------------------------------+-- ------------------------->
   '- -localfcportmask --port_mask-'      

>--+---------------------------------+-- -- -------------------->
   '- -partnerfcportmask --port_mask-'         

>--+----------------------------+-- ---------------------------->
   '- -topology --+-standard--+-'      
                  +-stretched-+        
                  '-hyperswap-'        

>--+--------------------------------------------+-- ------------>
   '- -vdiskprotectiontime -- value_in_minutes -'      

>--+--------------------------------------+-- ------------------>
   '- -vdiskprotectionenabled --+- yes -+-'      
                                '- no --'        

>--+-------------------+-- ------------------------------------->
   '- -odx --+- on --+-'      
             '- off -'        

>--+------------------------------------+-- -------------------->
   '- -easytieracceleration --+- on --+-'      
                              '- off -'        

>--+--------------------------------------------+-- ------------>
   '- -maxreplicationdelay -- value_in_seconds -'      

>--+------------------------------------------------------+----->
   '- -partnershipexclusionthreshold -- value_in_seconds -'   

>-- -- --+-------------------------------+---------------------->
         '- -ibmcustomer -- customer_id -'   

>--+---------------------------------+-------------------------->
   '- -ibmcomponent -- component_id -'   

>--+-----------------------------+------------------------------>
   '- -ibmcountry -- country_id -'     

>--+--------------------------------+-- ------------------------>
   '- -enhancedcallhome --+- on --+-'      
                          '- off -'        

>--+------------------------------+----------------------------->
   '- -censorcallhome --+- on --+-'     
                        '- off -'       

>--+---------------------+-------------------------------------><
   '- -unmap --+- on --+-'   
               '- off -'     

Parâmetros

-name system_name
(Opcional) Especifica um novo nome para o sistema.
Importante: O Internet Small Computer System Interface (iSCSI) Qualified Name (IQN) de cada nó é gerado usando os nomes do sistema e do nó. Se estiver usando o protocolo iSCSI, a mudança de qualquer nome também mudará o IQN de todos os nós no sistema e poderá requerer a reconfiguração de todos os hosts conectados por iSCSI.
-rcbuffersize new_size_in_MB
(Opcional) Especifica a quantidade de memória, em megabytes (MB), a ser usada em cada nó para comunicações do Metro Mirror e do Global Mirror, de 48 a 512 MB. O padrão é 48 MB.
Importante: Ajuste esta configuração somente quando orientado pela equipe de suporte.

Todos os nós no sistema devem estar on-line e ter um mínimo de 8 gigabytes (GB) - ou 8192 megabytes (MB) - de memória para mudar esta configuração.

Lembre-se:
  • Antes de alterar essa configuração, é necessário parar todas as parcerias com este sistema.
  • Este parâmetro opera no sistema local somente e mudá-lo é disruptivo para operações de espelhamento.
-alias id_alias
(Opcional) Especifica um nome alternativo que não muda o ID básico para o sistema, mas influencia o VDisk_UID de cada vdiskhostmap, tanto os novos quantos os existentes. Esses objetos são criados para um sistema cujo ID corresponde ao alias. Portanto, alterar o alias do sistema causará perda de acesso ao sistema host, até que cada host verifique os volumes apresentados pelo sistema.
-invemailinterval interval
(Opcional) Especifica o intervalo no qual os e-mails de inventário são enviados aos destinatários de e-mail designados. A extensão do intervalo é de 0 a 15. O intervalo é medido em dias. Configurar o valor como 0 desliga a função de notificação por email do inventário.
-gmlinktolerance link_tolerance
(Opcional) Especifica o período de tempo, em segundos, durante o qual é tolerado um link intersistema inadequado para uma operação de Global Mirror. O parâmetro aceita valores de 20 a 86400 segundos em etapas de 10 segundos. O padrão é 300 segundos. É possível desativar a tolerância de link inserindo um valor de 0 para esse parâmetro.
-gmmaxhostdelay max_host_delay
(Opcional) Especifica o tempo de atraso máximo, em milissegundos, no qual o cronômetro de tolerância do link de Global Mirror começa a contagem regressiva. Esse valor do limite determina o impacto adicional que as operações de Global Mirror podem incluir aos tempos de resposta dos volumes de origem do Global Mirror. Esse parâmetro pode usado para aumentar o limite do valor padrão de 5 milissegundos.
-icatip icat_console_ip_address
(Opcional) Especifica o novo endereço IPv4 do sistema que é usado pelo sistema. O formato desse endereço IP deve ser uma notação decimal com ponto com a porta; por exemplo, 255.255.255.255:8080. Se você especificar esse parâmetro, ele sobrescreverá qualquer endereço -icatip_6 existente.
-icatip_6 icat_console_ipv6_address
(Opcional) Especifica o novo endereço IPv6 do sistema. Se esse parâmetro for especificado, ele substituirá os endereços -icatip existentes. O formato do endereço IPv6 deve ser:
  • Oito grupos de quatro dígitos hexadecimais separados por dois pontos; por exemplo:
    [1234:1234:abcd:0123:0000:0000:7689:6576]:23
  • Oito grupos de dígitos hexadecimais separados por dois pontos, com os zeros à esquerda omitidos; por exemplo:
    [1234:1234:abcd:123:0:0:7689:6576]:23
  • Supressão de um ou mais grupos de zeros consecutivos; por exemplo:
    [1234:1234:abcd:123::7689:6576]:23
-ntpip ipv4_ntp_ip_address
(Opcional) Especifica o endereço IPv4 do servidor Network Time Protocol (NTP). A configuração de um endereço de servidor NTP faz com que o sistema use esse servidor NTP como sua fonte de tempo. Especifique o parâmetro -ntpip com um endereço zero para usar outra fonte de tempo:
chsystem -ntpip 0.0.0.0
-ntpip_6 ipv6_ntp_ip_address
Nota: Um prefixo e um gateway IPv6 devem ser configurados para o sistema antes de especificar o -ntpip_6.
(Opcional) Especifica o endereço IPv6 para o servidor NTP. A configuração de um endereço de servidor NTP faz com que o sistema comece a usar imediatamente esse servidor NTP como sua fonte de tempo. Para escolher outra fonte de tempo, especifique o parâmetro -ntpip_6 com um endereço zero, conforme a seguir:
chsystem -ntpip_6 0::0
-isnsip sns_server_address
(Opcional) Especifica o endereço IPv4 do serviço de nomes de armazenamento (SNS) do iSCSI. Especifique o parâmetro -isnsip com um endereço zero para selecionar outro servidor IPv4 iSCSI SNS:
chsystem -isnsip 0.0.0.0
-isnsip_6 ipv6_sns_server_address
(Opcional) Especifica o endereço IPv6 do SNS do iSCSI. Especifique o parâmetro -isnsip_6 com um endereço zero para selecionar outro servidor IPv6 iSCSI SNS configurado:
chsystem -isnsip_6 0::0
-relationshipbandwidthlimit bandwidth_in_mBps
(Opcional) Especifica a nova largura de banda da cópia de plano de fundo em megabytes por segundo (MBps), de 1 a 1000. O padrão é 25 MBps.
Importante: Para parcerias por meio de links IP com compactação, este parâmetro especifica a largura da banda agregada após a compactação ter sido aplicada aos dados. Não configure esse parâmetro maior que a largura da banda de link físico multiplicada pelo fator de compactação (cuidadosamente arrendondado para baixo).
Este parâmetro opera em todo o sistema e define a largura de banda da cópia de plano de fundo que qualquer relacionamento pode adotar. As configurações de largura de banda da cópia de plano de fundo existentes definidas em uma parceria continuam operando, tentando taxas de volume e de parceria mais baixas.
Nota: Não configure esse valor mais alto do que o padrão, sem estabelecer que a maior largura de banda pode ser sustentada.
-infocenterurl url
Especifica a URL da documentação online preferencial para substituir aquela usada pela GUI. Como essas informações são interpretadas pelo navegador da Internet, as informações especificadas podem conter um nome do host ou um endereço IP.
Lembre-se: Visualize a URL atualmente configurada no painel de preferências da GUI. Essa janela também pode ajudar a reconfigurar esse valor para a configuração padrão.
-iscsiauthmethod none | chap -chapsecret chap_secret
(Opcional) Configura o método de autenticação para as comunicações iSCSI do sistema:
  • chap indica que a autenticação Internet Small Computer System Interface (iSCSI) está ativada.
    Lembre-se: Isso ativa a autenticação de parceria da iSCSI quando uma chave secreta do Challenge Handshake Authentication Protocol (CHAP) é configurada para o sistema.
  • none indica que a autenticação de parceria de iSCSI está desativada.
-rcauthmethod none | chap -chapsecret chap_secret
(Opcional) Ativa ou desativa a autenticação para solicitações de parceria de cópia remota (RC) que são parcerias de IP nativas: A cópia remota inclui o Metro Mirror, Global Mirror e HyperSwap. Adicionalmente:
  • chap indica que a autenticação de cópia remota está ativada.
    Lembre-se: Essa ação ativa a autenticação de solicitações de parceria de cópia remota quando uma chave secreta do Challenge Handshake Authentication Protocol (CHAP) é configurada para o sistema.
  • none indica que a autenticação de parceria de cópia remota está desativada.
-chapsecretchap_secret
(Opcional) Configura o segredo do CHAP a ser usado para autenticar o sistema que usa iSCSI. Esse parâmetro é necessário se o parâmetro iscsiauthmethod chap for especificado. O CHAP secreto especificado não pode começar ou terminar com um espaço.
-nochapsecret
(Opcional) Limpa qualquer segredo do CHAP anteriormente configurado para autenticação por iSCSI. O parâmetro nochapsecret não pode ser especificado quando chapsecret está especificado.
-iscsiusername
(Opcional) Especifica o nome do usuário para o sistema SVC inteiro que é usado para autenticação de duas vias para login de conexão do host iSCSI. Se esse parâmetro for especificado, esse valor será obtido como "nome do usuário" para autenticação de duas vias no login de conexão do host iSCSI. Se o nome do usuário não for especificado, o nome do usuário para a autenticação CHAP de duas vias será NULL.
-layer replication | storage
(Opcional) Especifica em que camada um sistema está. O sistema pode criar parcerias com os sistemas na mesma camada.
Nota: Se você especificar -layer, deverá especificar replication ou storage. Essa opção poderá ser usada se nenhum outro sistema estiver visível na malha e nenhuma parceria do sistema estiver definida.
-cacheprefetch on | off
(Opcional) Indica se a pré-busca de cache está ativada ou desativada no sistema. Ajuste isso somente ao seguir orientação das informações do suporte do produto.
-localfcportmask port_mask
(Opcional) Indica a máscara da porta de E/S do Fibre Channel (FC) somente para comunicações de nó para nó do sistema local. A máscara da porta do Fibre Channel não afeta o host ou o tráfego do sistema de armazenamento. A máscara de porta é um binário de 64 bits e é composta de uma combinação de zeros e uns, em que 0 indica que a porta de E/S do FC correspondente não pode ser usada e 1 indica ela pode. A máscara é aplicada a todos os nós no sistema local. Pelo menos duas portas devem ser selecionadas para comunicações entre nós do sistema local. A máscara deve resultar em pelo menos 2 conexões FC entre cada nó no sistema local, usando somente as portas selecionadas e zonas de FC visíveis a essas portas. Os valores de máscara válidos podem variar de 0011 (somente as portas 1 e 2 ativadas) para 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.
Lembre-se: Uma máscara parcial (menos de 64 caracteres) tem extensão zero, o que significa que quaisquer portas que não sejam especificadas não são ativadas.
Especifique o comando lsportfc para exibir IDs de portas de E/S do FC.
-partnerfcportmask port_mask
(Opcional) Indica a máscara de porta de E/S do FC somente para comunicação sistema a sistema com parceiro. A máscara da porta do Fibre Channel não afeta o host ou o tráfego do sistema de armazenamento. A máscara de porta é um binário de 64 bits e é composta de uma combinação de zeros e uns, em que 0 indica que a porta de E/S do FC correspondente não pode ser usada e 1 indica ela pode. A máscara é aplicada a todos os nós no sistema local. 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.
Lembre-se: Uma máscara parcial (menos de 64 caracteres) é estendida para zero, o que significa que as portas não especificadas não são ativadas.
Especifique o comando lsportfc para exibir IDs de portas de E/S do FC.
-topology standard | stretched | hyperswap
(Opcional) Indica a topologia desejada do sistema, que é standard, stretched ou hyperswap.
-vdiskprotectiontime value_in_minutes
(Opcional) Configura o tempo de proteção do volume (em minutos).
-vdiskprotectionenabled yes | no
(Opcional) Ativa ou desativa a proteção de volume. Os valores são yes e no.
-odx on | off
(Opcional) Ativa ou desativa as transferências de dados feitas (ODX). Os valores são on e off.
-easytieracceleration on | off
(Opcional) Ativa a aceleração de balanceamento de Easy Tier e do conjunto. Os valores são on e off.
-maxreplicationdelay value_in_seconds
(Opcional) Configura um atraso de replicação máximo em segundos. O valor deve ser um número de 0 até 360.
-partnershipexclusionthreshold value_in_seconds
(Opcional) Configura o tempo limite para uma operação de E/S (em segundos) para sistemas remotos. O valor deve ser um número de 30 a 315 (padrão).
-ibmcustomer customer_id
(Opcional) Especifica o número do cliente designado quando uma licença de software é incluída automaticamente no banco de dados de autorizações. O valor deve ser um número que contém de 7 a 10 dígitos (ou em branco).
-ibmcomponent component_id
(Opcional) Especifica o ID de componente utilizado para autorização e sistema de call home. O valor está em branco ou SANVCNSW1.
-ibmcountry country_id
(Opcional) Especifica o ID do país usado para sistema de autorização e call home. O valor ficará em branco ou um número de 3 dígitos.
-enhancedcallhome on | off
(Opcional) Especifica que a função de call home é enviar relatórios aprimorados ao centro de suporte. Os valores válidos são sim ou não.

Os relatórios aprimorados incluem dados operacionais e relacionados a eventos e informações de configuração específicas que são incluídas no relatório de inventário. Essa função alerta o centro de suporte sobre falhas de hardware e problemas potencialmente sérios de configuração ou ambientais. O centro de suporte pode usar as informações de configuração para gerar automaticamente as melhores práticas ou recomendações que são baseadas em sua configuração real.

-censorcallhome on | off
(opcional) Especifica que os dados sensíveis são excluídos dos dados aprimorados do call home. Os valores são yes ou no.
-unmap on | off
(Opcional) Especifica se o administrador do sistema ativa o recurso de remoção de mapeamento do Small Computer System Interface (SCSI). Os valores são on (padrão) ou off.

Descrição

Este comando modifica recursos específicos de um sistema. Diversos recursos podem ser alterados pela emissão de um único comando.

Usar o parâmetro -ntpip ou -ntpip_6 permite que o sistema use um servidor NTP como uma fonte de tempo externa. O sistema ajusta o relógio do sistema do nó de configuração de acordo com os valores de tempo do servidor NTP. Os clocks de outros nós são atualizados a partir do clock do nó de configuração. No modo NTP, o comando setsystemtime é desativado.

Todos os parâmetros de comandos são opcionais, mas é necessário especificar pelo menos um parâmetro.

Use o comando chsystemip para modificar o endereço IP do sistema e o endereço IP do serviço.

Lembre-se: Configurar uma chave screta CHAP para o sistema não ativa a autenticação para hosts iSCSI ou parcerias de cópia remota. A cópia remota inclui o Metro Mirror, Global Mirror e HyperSwap. Desligue a autenticação emitindo -iscsiauthmethod ou -rciauthmethod.
A topologia pode ser configurada como HyperSwap apenas se os sites do nó tiverem sido configurados. Todos os nós devem ter um site definido. Se ambos os nós estiverem definidos em um grupo de E/S, eles deverão ser designados ao mesmo site (1 ou 2; 3 não pode ser usado para nós). Deve-se ter pelo menos um grupo de E/S com ambos os nós no site 1 e pelo menos um grupo de E/S com ambos os nós no site 2.
Nota: Se houver relacionamentos ativos definidos, a topologia do sistema deverá ser HyperSwap.

Um Exemplo de Chamada

chsystem -ntpip 9.20.165.16

A saída resultante:

Sem feedback

Exemplo de Chamada para Configurar um Servidor NTP Externo

chsystem -ntpip 123.234.123.234 

A saída resultante:

Sem feedback

Exemplo de Chamada para Alterar o Valor infocenterurl Preferencial

chsystem -infocenterurl http://miscserver.company.com/ibm/infocenter

A saída resultante:

Sem feedback

Exemplo de Chamada para Alterar o Valor da Máscara de Porta Local

Para configurar a máscara local para sessenta e dois 0 e dois 1, indicando que portas de E/S do FC com IDs 1 e 2 são capazes de comunicação com o nó local:

chsystem -localfcportmask 11

A saída resultante:

Sem feedback

Exemplo de Chamada para Alterar o Valor da Máscara de Porta do Parceiro

Para configurar a máscara de parceiro para sessenta e três 0 e um 1, indicando que a porta de E/S do FC com ID 2 é capaz de comunicação nó remoto:

svctask chsystem -partnerfcportmask 0010

A saída resultante:

Sem feedback

Exemplo de Chamada para Configurar a Topologia do Sistema

chsystem -topology standard

A saída resultante:

Sem feedback

Um exemplo de chamada para configurar a autenticação para cópia remota

chsystem -chapsecret ABCB1234 -iscsiauthmethod none -rcauthmethod chap

A saída resultante:

Sem feedback

Um exemplo de chamada para desativar a proteção de volume

chsystem -vdiskprotectionenabled no

A saída resultante:

Sem feedback

Um exemplo de chamada para ativar a proteção de volume e configurar o tempo de proteção para 60 minutos

chsystem -vdiskprotectionenabled yes -vdiskprotectiontime 60

A saída resultante:

Sem feedback

Um exemplo de chamada para ativar a aceleração do Easy Tier

chsystem -easytieracceleration on

A saída resultante:

Sem feedback

Um exemplo de chamada para ativar o ODX

chsystem -odx on

A saída resultante:

Sem feedback

Um exemplo de chamada para configurar o atraso máximo de replicação

chsystem -maxreplicationdelay 100

A saída resultante:

Sem feedback

Um exemplo de chamada para configurar o limite de exclusão da parceria

chsystem -partnershipexclusionthreshold 120

A saída resultante:

Sem feedback

Um exemplo de chamada para especificar um ID de cliente IBM, ID de componente e ID de país

chsystem -ibmcustomer 1928374 -ibmcomponent SANVCNSW1 -ibmcountry 001 

A saída resultante :

Sem feedback

Um exemplo de chamada para desativar o call home aprimorado

chsystem -enhancedcallhome off 

A saída resultante :

Sem feedback

Um exemplo de chamada para ativar o call home do censor

chsystem -censorcallhome on 

A saída resultante :

Sem feedback