Referência do Utilitário xsadmin

É possível passar os argumentos para o utilitário xsadmin com dois métodos diferentes: com um argumento de linha de comandos ou com um arquivo de propriedades.

Argumentos xsadmin

É possível definir um arquivo de propriedades para o utilitário xsadmin com Versão 7.1 Fix 1 ou posterior. Ao criar um arquivo de propriedades, é possível salvar alguns dos argumentos usados frequentemente, como o nome do usuário. As propriedades que podem ser incluídas em um arquivo de propriedades na seguinte tabela. Se você especificar uma propriedade em um arquivo de propriedades e o argumento de linha de comandos equivalente, o valor do argumento de linha de comandos substituirá o valor do arquivo de propriedades.

Para obter informações adicionais sobre a definição de um arquivo de propriedades para o utilitário xsadmin, consulte Criando um perfil de configuração para o utilitário xsadmin.

Tabela 1. Argumentos para o Utilitário xsadmin
Argumento da Linha de Comandos Nome da Propriedade Equivalente no Arquivo de Propriedades Descrição e Valores Válidos
-bp n/d

Indica a porta do listener.

Padrão:2809

-ch n/d

Indica o nome do host JMX para o servidor de catálogos.

Padrão:localhost

-clear n/d

Limpa o mapa especificado.

Permite os seguintes filtros: -fm

-containers n/d Para cada grade de dados e conjunto de mapas, exibe uma lista de servidores de contêiner.

Permite os seguintes filtros: -fnp

-continuous n/d Especifique este sinalizador se desejar resultados do tamanho de mapa contínuos para monitorar a grade de dados. Quando este comando é executado ando com o argumento -mapsizes, o tamanho do mapa será exibido a cada 20 segundos.
-coregroups n/d Exibe todos os grupos principais para o servidor de catálogos. Esse argumento é usado para diagnóstico avançado.
-dismissLink <catalog_service_domain> n/d

Remove um link entre os 2 domínios de serviço de catálogo. Forneça o nome do domínio de serviço de catálogo estrangeiro ao qual se conectou anteriormente com o argumento -establishLink.

-dmgr n/d

Indica se você está se conectando a um serviço de catálogo hospedado WebSphere Application Server.

Padrão:false

-empties n/d Especifique este sinalizador se deseja mostrar os contêineres vazio na saída.
-establishLink <foreign_domain_name> <host1:port1,host2:port2...> n/d

Conecta o domínio de serviço de catálogo a um domínio de serviço de catálogo estrangeiro. Use o seguinte formato: -establishLink <foreign_domain_name> <host1:port1,host2:port2...>. foreign_domain_name é o nome do domínio de serviço de catálogo estrangeiro e host1:port1,host2:port2... é uma lista separada por vírgula de nomes do host do servidor de catálogos e portas Object Request Broker (ORB) que ficam em execução neste domínio de serviço de catálogo.

-fc n/d Filtro apenas para este contêiner.
Se estiver filtrando os servidores de contêiner em um ambiente do WebSphere Application Server Network Deployment, use o seguinte formato:
<cell_name>/<node_name>/<serverName_containerSuffix>

Use com os argumentos a seguir: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fh n/d Filtros para apenas este host.

Use com os argumentos a seguir: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-fm n/d Filtra apenas esse mapa.

Use com os seguintes argumentos: -clear, -mapsizes

-fnp n/d Filtra servidores que não possuem shards primários.

Use com os seguintes argumentos: -containers

-fp n/d Filtro para apenas esta partição.

Use com os argumentos a seguir: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-fs n/d Filtros para apenas este servidor.
Se estiver filtrando servidores de aplicativos em um ambiente WebSphere Application Server Network Deployment, utilize o seguinte formato:
<cell_name>/<node_name>/<server_name>

Use com os argumentos a seguir: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fst n/d Filtro para apenas este tipo de shard. Especifique P para shards primários apenas, A para shards de réplica assíncrona apenas e S para shards de réplica síncrona apenas.

Use com os argumentos a seguir: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fz n/d Filtros para apenas esta zona.

Use com os argumentos a seguir: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-force n/d Força a ação que está no comando, desativando qualquer prompt preventivo. Esse argumento é útil para executar comandos em lote.
-g n/d Especifica o nome ObjectGrid.
-getstatsspec n/d Exibe a especificação de estatísticas atual. É possível configurar a especificação das estatísticas com o argumento -setstatsspec.

Permite os filtros a seguir: -fst -fc -fz -fs -fh -fp

-getTraceSpec n/d Exibe a especificação de rastreio atual. É possível configurar a especificação de rastreio com o argumento -settracespec.

Permite os filtros a seguir: -fst -fc -fz -fs -fh -fp

-h n/d Exibe a ajuda para o utilitário xsadmin, que inclui uma lista de argumentos.
-hosts n/d Exibe todos os hosts na configuração.
-jmxUrl XSADMIN_JMX_URL Especifica o endereço de um servidor de conector JMX API no seguinte formato: service:jmx:protocol:sap. As definições de variável protocol e sap a seguir:
protocol
Especifica o protocolo de transporte a ser usado para se conectar ao servidor de conector.
sap
Especifica o endereço no qual o servidor conector está localizado.
Para obter mais informações sobre o formato da URL de serviço JMX, consulte Classe JMXServiceURL (SEJava 2 Platform 5.0).
-l n/d Exibe todas as grades de dados conhecidas e conjuntos de mapa.
-m n/d Especifica o nome do conjunto de mapas.
-mapsizes n/d Exibe o tamanho de cada mapa no servidor de catálogos para verificar se a distribuição de chave é uniforme sobre os shards.

Permite os seguintes filtros: -fm -fst -fc -fz -fs -fh -fp

-mbeanservers n/d Exibe uma lista de todos os terminais do servidor MBean.
-overridequorum n/d

Substitui a configuração de quorum para que os eventos do servidor de contêiner não sejam ignorados durante um cenário de falha do datacenter.

-password XSADMIN_PASSWORD Especifica a senha para efetuar login no utilitário xsadmin. Não especifique a senha no seu arquivo de propriedades se desejar que sua senha permaneça segura.
-p n/d

Indica a porta JMX para o host do servidor de catálogos.

Padrão: 1099 ou 9809 para um host WebSphere Application Server e 1099 para configurações independentes.

-placementStatus

n/d Exibe o posicionamento configurado e o posicionamento de tempo de execução da sua configuração. É possível realizar escopo da saída para uma combinação das grades de dados e dos conjuntos de mapa, ou para a configuração inteira:
  • Configuração Inteira:
    -placementStatus
  • Para uma grade de dados específica:
    -placementStatus -g my_grid
  • Para um conjunto de mapas específico:
    -placementStatus -m my_mapset
  • Para um conjunto de mapas e grade de dados específicos:
    -placementStatus  -g my_grid 
    -m my_mapset
-primaries n/d Exibe uma lista dos shards primários.
-profile n/d Especifica o caminho completo para o arquivo de propriedades para o utilitário xsadmin.
-quorumstatus n/d

Exibe o status de quorum para o serviço de catálogo.

-releaseShard <container_server_name> <objectgrid_name> <map_set_name> <partition_name> n/d Usado em conjunto com o argumento -reserveShard. O argumento -releaseShard deverá ser chamado depois que um shard for reservado e colocado. . O argumento -releaseShard chama o método ContainerMBean.release() .
-reserved n/d Usado com o argumento -containers para exibir apenas shards que foram reservados com o argumento -reserveShard.
-reserveShard <container_server_name> <objectgrid_name> <map_set_name> <partition_name> n/d Move o shard primário para o servidor de contêiner especificado. O método ContainerMBean.reserve() é chamado por esse argumento.

-resumeBalancing <objectgrid_name> <map_set_name>

n/d Tenta balancear as solicitações. Permite o rebalanceamento futuro no ObjectGrid e conjunto de mapas especificados.
-revisions n/d Exibe identificadores de revisão para um domínio de serviço de catálogo, incluindo: cada grade de dados, número de partição, tipo de partição (primário ou réplica), domínio de serviço de catálogo, ID e o número de revisões de dados para cada shard específico. Esse argumento pode ser usado para determinar se uma réplica assíncrona ou domínio vinculado é capturado. Esse argumento chama o método ObjectGridMBean.getKnownRevisions().

Permite os filtros a seguir: -fst -fc -fz -fs -fh -fp

-routetable n/d Exibe o estado atual da grade de dados a partir de uma perspectiva de servidor do cliente. A tabela de rotas é a informação que um servidor do cliente do ObjectGrid usa para se comunicar com a grade de dados. Use a tabela de rota como um auxílio de diagnóstico quando estiver tentando identificar problemas de conexão ou exceções TargetNotAvailable.

Argumentos obrigatórios: Em um ambiente independente, você deve especificar os parâmetros -bp e -p com esse argumento se não estiver usando os valores padrão para a porta listener de autoinicialização e a porta JMX para o host do servidor de catálogos.

Permite os seguintes filtros: -fz -fh -fp

-settracespec <trace_string> n/d
Ativa o rastreio nos servidores durante o tempo de execução. Consulte o seguinte exemplo:
-setTraceSpec "ObjectGridReplication=all=enabled"
Consulte Coletando Rastreio e Opções de Rastreio para obter informações adicionais sobre as sequências de rastreio que são possíveis de especificar.

Permite os filtros a seguir: -fst -fc -fz -fs -fh -fp

-swapShardWithPrimary <container_server_name> <objectgrid_name> <map_set_name> <partition_name>

n/d Troca o shard de réplica especificados a partir do servidor de contêiner especificado com o shard primário. Ao executar esse comando, é possível equilibrar manualmente os shards primários quando necessário.
-setstatsspec <stats_spec> n/d Ativa a reunião de estatísticas. Esse argumento chama os métodos DynamicServerMBean.setStatsSpec e DynamicServerMBean.getStatsSpec. Para obter mais informações, consulte Ativando as Estatísticas.

Permite os seguintes filtros: -fm -fst -fc -fz -fs -fh -fp

-suspendBalancing <objectgrid_name> <map_set_name>

n/d Evita que tentativas futuras equilibrem o ObjectGrid e o conjunto de mapas especificados.
-ssl n/d Indica que o Secure Sockets Layer (SSL) está ativado.
-teardown n/d

Para uma lista ou grupo de servidores de contêiner e catálogo.

Permite os filtros a seguir: -fst -fc -fz -fs -fh -fp

Formato para fornecer uma lista de servidores:
server_name_1,server_name_2 ...
Pare todos os servidores em uma zona, inclua o argumento -fz:
–fz <zone_name>
Pare todos os servidores em um host, inclua o argumento -fh:
–fh <host_name>
-triggerPlacement n/d Força o posicionamento de shard a ser executado, ignorando valor numInitialContainers configurado no arquivo XML de implementação. É possível usar este argumento quando estiver executando a manutenção em seu servidor para permitir que o posicionamento de shard continue em execução, mesmo se o valor numInitialContainers for menor que o valor configurado.
-trustPass XSADMIN_TRUST_PASS Especifica a senha para o truststore especificado.
-trustPath XSADMIN_TRUST_PATH Especifica um caminho para o arquivo de truststore.

Exemplo: etc/test/security/server.public

-trustType XSADMIN_TRUST_TYPE Especifica o tipo de truststore.

Valores válidos: JKS, JCEK, PKCS12, etc.

-unassigned n/d Exibe uma lista de shards que não podem ser colocados na grade de dados. Os shards não podem ser colocados quando o serviço de posicionamento tiver uma restrição que esteja evitando o posicionamento.
-username XSADMIN_USERNAME Especifica o nome de usuário para efetuar login no utilitário xsadmin.
-v n/d Ativa a ação da linha de comandos detalhada. Use este sinalizador se estiver usando variáveis de ambiente, um arquivo de propriedades ou ambos para especificar certos argumentos de linha de comandos e desejar visualizar seus valores. Consulte Opção Detalhada para o Utilitário xsadmin para obter informações adicionais.
-xml n/d Imprime a saída não filtrada a partir do método PlacementServiceMBean.listObjectGridPlacement(). Os outros Argumentos xsadmin filtram a saída deste método e organizam os dados em um formato mais consumível.