Tarefas Administrativas de Domínio do Serviço de Catálogo

É possível usar os idiomas de script Jacl ou Jython para gerenciar os domínios de serviço de catálogo em sua configuração do WebSphere Application Server. Com o WebSphere DataPower XC10 Appliance, você define domínios de serviço de catálogo para estabelecer conexões com os servidores de catálogos em execução no dispositivo. A criação dessa configuração é necessária apenas para grades de dados em cache dinâmico.

Requisitos

É necessário ter o WebSphere eXtreme Scale Client instalado em seu ambiente do WebSphere Application Server.

Lista de Todas as Tarefas Administrativas

Para obter uma lista de todas as tarefas administrativas associadas aos domínios do serviço de catálogo, execute o seguinte comando com wsadmin:
wsadmin>$AdminTask help XSDomainManagement 

Comandos

As tarefas administrativas para os domínios do serviço de catálogo incluem os seguintes comandos:

createXSDomain

O comando createXSDomain registra um novo domínio do serviço de catálogo.
Tabela 1. Argumentos de Comando createXSDomain
Argumento Descrição
-name (obrigatório) Especifica o nome do domínio do serviço de catálogo que deseja criar.
-default Especifica se o domínio do serviço de catálogo é o padrão para a célula. O valor padrão é true. (Booleano: configurar para true ou false)
-properties Especifica as propriedades customizadas para o domínio do serviço de catálogo.
Tabela 2. Argumentos da Etapa defineDomainServers
Argumento Descrição
name_of_endpoint Especifica o nome do terminal do serviço de catálogo.
  • Para servidores de aplicativos existentes: O nome do terminal deve estar no seguinte formato: cell_name\node_name\server_name
  • Para servidores remotos: Especifica o nome do host do servidor remoto. É possível usar o mesmo nome para diversos terminais, mas os valores de porta do cliente devem ser exclusivos para cada terminal.
custom_properties Especifica propriedades customizadas para o terminal do domínio do serviço de catálogo. Se não tiver nenhuma propriedade customizada, use um conjunto de aspas duplas ("") para este argumento.
endpoint_ports
Especifica os números de porta para o terminal do domínio do serviço de catálogo. As portas devem ser especificadas na seguinte ordem: <client_port>,<listener_port>
Porta do Cliente
Especifica a porta que é usada para a comunicação entre os servidores de catálogos no domínio de serviço de catálogo. Este valor é necessário para os servidores de catálogos que estão em execução apenas nos processos do WebSphere Application Server e podem ser configurados para qualquer porta que não está sendo usada em outro lugar.
Porta do Listener
Especifica a porta que é usada para comunicação com clientes. Este valor é necessário para terminais remotos e deve corresponder ao valor usado quando o serviço de catálogo foi iniciado. A porta do listener é usada pelos clientes e contêineres se comunicarem com o serviço de catálogo.
Para obter os terminais remotos do WebSphere DataPower XC10 Appliance : Use o valor 2809 para os terminais remotos de dispositivo.

Valor de retorno:

Uso de exemplo do modo em lote

O modo em lote requer formatação correta da entrada do comando. Considere usar o modo interativo para assegurar que os valores que você inserir sejam processados corretamente. Quando usar o modo em lote, você deverá definir os argumentos da etapa -defineDomainServers usando uma matriz de propriedades específica. Esta matriz de propriedades está no formato name_of_endpoint custom_properties endpoint_ports. O valor de endpoint_ports é uma lista de portas que devem ser especificadas na seguinte ordem: <client_port>,<listener_port>.

Uso de exemplo do modo interativo
  • Usando Jacl:
    $AdminTask createXSDomain {-interactive}
  • Usando a cadeia Jython:
    AdminTask.createXSDomain ('[-interactive]')

deleteXSDomain

O comando deleteXSDomain exclui um domínio do serviço de catálogo.

Parâmetros obrigatórios:
-name
Especifica o nome do domínio do serviço de catálogo a excluir.

Valor de retorno:

Uso de exemplo do modo em lote
  • Usando Jacl:
    $AdminTask deleteXSDomain {-name TestDomain }
  • Usando a cadeia Jython:
    AdminTask.deleteXSDomain('[-name TestDomain ]')
Uso de exemplo do modo interativo
  • Usando Jacl:
    $AdminTask deleteXSDomain {-interactive}
  • Usando a cadeia Jython:
    AdminTask.deleteXSDomain ('[-interactive]')

getDefaultXSDomain

O comando getDefaultXSDomain retorna o domínio do serviço de catálogo padrão para a célula.

Parâmetros obrigatórios: Nenhum

Valor de retorno: O nome do domínio do serviço de catálogo padrão.

Uso de exemplo do modo em lote
  • Usando Jacl:
    $AdminTask getDefaultXSDomain
  • Usando a cadeia Jython:
    AdminTask.getDefaultXSDomain
Uso de exemplo do modo interativo
  • Usando Jacl:
    $AdminTask getDefaultXSDomain {-interactive}
  • Usando a cadeia Jython:
    AdminTask.getDefaultXSDomain ('[-interactive]')

listXSDomains

O comando listXSDomains retorna uma lista dos domínios do serviço de catálogo existentes.

Parâmetros obrigatórios: Nenhum

Valor de retorno: Uma lista de todos os domínios do serviço de catálogo na célula.

Uso de exemplo do modo em lote
  • Usando Jacl:
    $AdminTask listXSDomains
  • Usando a cadeia Jython:
    AdminTask.listXSDomains
Uso de exemplo do modo interativo
  • Usando Jacl:
    $AdminTask listXSDomains {-interactive}
  • Usando a cadeia Jython:
    AdminTask.listXSDomains ('[-interactive]')

modifyXSDomain

O comando modifyXSDomain modifica um domínio do serviço de catálogo existente.

O modo em lote requer formatação correta da entrada do comando. Considere usar o modo interativo para assegurar que os valores que você inserir sejam processados corretamente. Quando usar o modo em lote, você deve definir os argumentos da etapa -modifyEndpoints, -addEndpoints e -removeEndpoints usando uma matriz de propriedades específica. Esta matriz de propriedades está no formato name_of_endpoint host_name custom_properties endpoint_ports. O valor de endpoint_ports é uma lista de portas que devem ser especificadas na seguinte ordem: <client_port>,<listener_port>.

Tabela 3. Argumentos de Comando modifyXSDomain
Argumento Descrição
-name (obrigatório) Especifica o nome do domínio do serviço de catálogo que você deseja editar.
-default Se configurado para true, especifica que o domínio do serviço de catálogo selecionado é o padrão para a célula. (Booleano)
-properties Especifica as propriedades customizadas para o domínio do serviço de catálogo.
Tabela 4. Argumentos da Etapa modifyEndpoints
Argumento Descrição
name_of_endpoint Especifica o nome do terminal do serviço de catálogo.
  • Para servidores de aplicativos existentes: O nome do terminal deve estar no seguinte formato: cell_name\node_name\server_name
  • Para servidores remotos: Especifica o nome do host do servidor remoto. É possível usar o mesmo nome para diversos terminais, mas os valores da porta do listener devem ser exclusivos para cada terminal. Este valor deve ser um nome de domínio completo se estiver configurando um dispositivo.
endpoint_ports
Especifica os números de porta para o terminal do domínio do serviço de catálogo. Os terminais devem ser especificados na seguinte ordem: <client_port>,<listener_port>
Porta do Cliente
Especifica a porta que é usada para a comunicação entre os servidores de catálogos no domínio de serviço de catálogo. Este valor é necessário para os servidores de catálogos que estão em execução apenas nos processos do WebSphere Application Server e podem ser configurados para qualquer porta que não está sendo usada em outro lugar.
Porta do Listener
Especifica a porta que é usada para comunicação com clientes. Este valor é necessário para terminais remotos e deve corresponder ao valor usado quando o serviço de catálogo foi iniciado. A porta do listener é usada pelos clientes e contêineres se comunicarem com o serviço de catálogo.
Para obter os terminais remotos do WebSphere DataPower XC10 Appliance : Use o valor 2809 para os terminais remotos de dispositivo.
Tabela 5. Argumentos da Etapa addEndpoints
Argumento Descrição
name_of_endpoint Especifica o nome do terminal do serviço de catálogo.
  • Para servidores de aplicativos existentes: O nome do terminal deve estar no seguinte formato: cell_name\node_name\server_name
  • Para servidores remotos: Especifica o nome do host do servidor remoto. É possível usar o mesmo nome para diversos terminais, mas os valores da porta do listener devem ser exclusivos para cada terminal. Este valor deve ser um nome de domínio completo se estiver configurando um dispositivo.
custom_properties Especifica propriedades customizadas para o terminal do domínio do serviço de catálogo. Se não tiver nenhuma propriedade customizada, use um conjunto de aspas duplas ("") para este argumento.
endpoint_ports
Especifica os números de porta para o terminal do domínio do serviço de catálogo. Os terminais devem ser especificados na seguinte ordem: <client_port>,<listener_port>
Porta do Cliente
Especifica a porta que é usada para a comunicação entre os servidores de catálogos no domínio de serviço de catálogo. Este valor é necessário para os servidores de catálogos que estão em execução apenas nos processos do WebSphere Application Server e podem ser configurados para qualquer porta que não está sendo usada em outro lugar.
Porta do Listener
Especifica a porta que é usada para comunicação com clientes. Este valor é necessário para terminais remotos e deve corresponder ao valor usado quando o serviço de catálogo foi iniciado. A porta do listener é usada pelos clientes e contêineres se comunicarem com o serviço de catálogo.
Para obter os terminais remotos do WebSphere DataPower XC10 Appliance : Use o valor 2809 para os terminais remotos de dispositivo.
Tabela 6. Argumentos da Etapa removeEndpoints
Argumento Descrição
name_of_endpoint Especifica o nome do terminal do serviço de catálogo a excluir.

Valor de retorno:

Uso de exemplo do modo em lote
  • Usando Jacl:
    $AdminTask modifyXSDomain {-name TestDomain -default true -modifyEndpoints 
    {{xhost1.ibm.com "" ,2809}} -addEndpoints {{xhost2.ibm.com "" ,2809}}} 
    -removeEndpoints {{xhost3.ibm.com}}}
  • Usando a cadeia Jython:
    AdminTask.modifyXSDomain('[-name TestDomain  
    -default false -modifyEndpoints [[xhost1.ibm.com "" ,2809]] 
    -addEndpoints [[xhost3.ibm.com "" ,2809]] 
    -removeEndpoints [[xhost2.ibm.com]]]')
Uso de exemplo do modo interativo
  • Usando Jacl:
    $AdminTask modifyXSDomain {-interactive}
  • Usando a cadeia Jython:
    AdminTask.modifyXSDomain ('[-interactive]')

testXSDomainConnection

O comando testXSDomainConnection testa a conexão com um domínio do serviço de catálogo.

Parâmetros obrigatórios:
-name
Especifica o nome do domínio do serviço de catálogo para o qual testar a conexão.
Parâmetros Opcionais
-timeout
Especifica o período máximo de tempo a aguardar a conexão, em segundos.

Valor de retorno: Se uma conexão puder ser feita, retornará true, caso contrário, serão retornadas informações de erro de conexão.

Uso de exemplo do modo em lote
  • Usando Jacl:
    $Admintask testXSDomainConnection
  • Usando a cadeia Jython:
    AdminTask.testXSDomainConnection
Uso de exemplo do modo interativo
  • Usando Jacl:
    $AdminTask testXSDomainConnection {-interactive}
  • Usando a cadeia Jython:
    AdminTask.testXSDomainConnection ('[-interactive]')

testXSServerConnection

O comando testXSServerConnection testa a conexão com um servidor de catálogos. Este comando funciona para servidores independentes e para servidores que fazem parte de um domínio do serviço de catálogo.

Parâmetros obrigatórios:
host
Especifica o host no qual reside o servidor de catálogos.
listenerPort
Especifica a porta do listener para o servidor de catálogos.
Parâmetros Opcionais
timeout
Especifica o período máximo de tempo a aguardar uma conexão para o servidor de catálogos, em segundos.

Valor de retorno:

Uso de exemplo do modo em lote
  • Usando Jacl:
    $Admintask testXSServerConnection {-host xhost1.ibm.com -listenerPort 2809}
  • Usando a cadeia Jython:
    AdminTask.testXSServerConnection('[-host xshost3.ibm.com -listenerPort 2809]')
Uso de exemplo do modo interativo
  • Usando Jacl:
    $AdminTask testXSServerConnection {-interactive}
  • Usando a cadeia Jython:
    AdminTask.testXSServerConnection ('[-interactive]')