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