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 WebSphere eXtreme Scale Client 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.

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

Este argumento de linha de comandos não se aplica às configurações WebSphere DataPower XC10 Appliance.

-dmgr n/d

Este argumento de linha de comandos não se aplica às configurações WebSphere DataPower XC10 Appliance.

-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

Este argumento de linha de comandos não se aplica às configurações WebSphere DataPower XC10 Appliance.

-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

Este argumento de linha de comandos não se aplica às configurações WebSphere DataPower XC10 Appliance.

-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

Este argumento de linha de comandos não se aplica às configurações WebSphere DataPower XC10 Appliance.

  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

Este argumento de linha de comandos não se aplica às configurações WebSphere DataPower XC10 Appliance.

-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

Este argumento de linha de comandos não se aplica às configurações WebSphere DataPower XC10 Appliance. Consulte Trabalhando com os Arquivos de Log do WebSphere DataPower XC10 Appliance para obter informações adicionais sobre a configuração do rastreio no dispositivo.

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.

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

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>

Este argumento de linha de comandos não se aplica às configurações WebSphere DataPower XC10 Appliance.

  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.
-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.