Administrando com o Utilitário xscmd

Com o xscmd, é possível concluir tarefas administrativas no ambiente tais como: estabelecer links de replicação multimaster, substituir o quorum e parar grupos de servidores com o comando teardown.

Antes de Iniciar

Sobre Esta Tarefa

O utilitário xscmd substitui o utilitário xsadmin de amostra como uma ferramenta de monitoramento e de administração totalmente suportadas. Seria possível concluir operações semelhantes com a ferramenta xsadmin, mas esta ferramenta não é suportada. A amostra xsadmin fornece um método para analisar e descobrir dados de implementação atuais e pode ser usada como uma base para gravar utilitários customizados. Se a ferramenta xsadmin era usada anteriormente para monitoramento e administração, considere atualizar seus scripts para usar o utilitário xscmd. Para obter informações sobre os comandos xsadmin para os novos comandos xscmd, consulte Ferramenta xsadmin para a Migração de Ferramenta xscmd.

Procedimento

  1. Opcional: Se a autenticação de cliente estiver ativa: Abra uma janela de linha de comandos. Na linha de comandos, configure as variáveis de ambiente apropriadas.
    1. Configure a variável de ambiente CLIENT_AUTH_LIB:
      • [Windows] set CLIENT_AUTH_LIB=<path_to_security_JAR_or_classes>
      • [Unix] set CLIENT_AUTH_LIB=<path_to_security_JAR_or_classes> export CLIENT_AUTH_LIB
  2. Acesse o diretório wxs_home/bin.

    cd wxs_home/bin

  3. Exiba a ajuda para as várias opções xscmd.
    • Para exibir a ajuda geral, execute o seguinte comando:
      • [Unix] ./xscmd.sh -h
      • [Windows] xscmd.bat -h
    • Para exibir uma lista de todos os comandos, execute o comando a seguir:
      • [Unix] ./xscmd.sh -lc
      • [Windows] xscmd.bat -lc
    • Para exibir a ajuda para um comando específico, execute o seguinte comando:
      • [Unix] ./xscmd.sh -h command_name
      • [Windows] xscmd.bat -h command_name
    • Para exibir uma lista dos grupos de comandos, execute o seguinte comando:
      • [Unix] ./xscmd.sh -lcg
      • [Windows] xscmd.bat -lcg
    • Para exibir uma lista dos comandos dentro de um grupo de comandos, execute o seguinte comando:
      • [Unix] ./xscmd.sh -lc command_group_name
      • [Windows] xscmd.bat -lc command_group_name
  4. Execute comandos que se conectam a servidores de catálogos específicos. Por padrão, xscmd se conecta ao servidor de catálogos no host local, usando o nome do host e a porta de localhost:2809. Também é possível fornecer uma lista de nomes de host e portas para o comando para que você possa se conectar aos servidores de catálogo em outros hosts. Na lista, um dos utilitários xscmd se conecta a um host aleatório. A lista de hosts que você fornece deve estar dentro do mesmo domínio de serviço de catálogo.
    • Forneça uma lista de servidores de catálogos independentes a serem conectados:
      • [Unix] ./xscmd.sh -c <command_name> -cep hostname:port(,hostname:port)
      • [Windows] xscmd.bat -c <command_name> -cep hostname:port(,hostname:port)
      Nos comandos, o command_name é o nome do comando que você está executando. O valor hostname:port é o nome do host e a porta do listener do servidor de catálogos. O valor de porta do listener em um servidor de catálogos independente é especificado quando você executa o comando startOgServer.
    • Forneça uma lista de servidores de catálogos do WebSphere Application Server a serem conectados. Não é possível conectar-se aos servidores de catálogos que estão em execução no WebSphere Application Server com o valor do host local padrão:
      • [Unix] ./xscmd.sh -c <command_name> -cep was_hostname:port(,hostname:port)
      • [Windows] xscmd.bat -c <command_name> -cep was_hostname:port(,hostname:port)
      Nos comandos, o command_name é o nome do comando que você está executando. O valor was_hostname é o nome do host do servidor de catálogos na célula do WebSphere Application Server. O valor de port é a porta do listener. O valor da porta do listener no WebSphere Application Server é herdado pela configuração da porta BOOTSTRAP_ADDRESS. O valor padrão é 9809 se o servidor de catálogos está em execução no gerenciador de implementação. Se você estiver executando o servidor de catálogos em um servidor de aplicativos, verifique a configuração da porta BOOTSTRAP_ADDRESS do servidor de aplicativos para determinar o número da porta.