Com o utilitário xsadmin, é possível formatar e exibir informações textuais sobre sua topologia do WebSphere eXtreme
Scale. O utilitário de
amostra fornece um método para analisar e descobrir dados de implementação
atuais e pode ser utilizado com uma base para criação de utilitários
customizados.
Antes de Iniciar
- O utilitário xsadmin é fornecido como uma amostra de como é possível criar utilitários customizados para sua implementação.
O utilitário xscmd é fornecido como um utilitário suportado
para monitorar e administrar seu ambiente. Para
obter informações adicionais, consulte
Administrando com o Utilitário xscmd.
- Para o utilitário xsadmin exibir os resultados, sua topologia da grade de dados deverá ter sido criada. Os servidores de catálogos
e servidores de contêiner devem ser iniciados. Consulte o Iniciando e Parando Servidores Independentes para obter informações adicionais.
- Verifique se a variável de ambiente JAVA_HOME
está configurada para usar o ambiente de tempo de execução que foi instalado com o produto.
Se estiver usando a versão de avaliação do produto, você deverá configurar a variável de ambiente
JAVA_HOME.
Sobre Esta Tarefa
O utilitário xsadmin de amostra usa uma implementação de beans gerenciados (MBeans). Este aplicativo de monitoramento de amostra
ativa rapidamente recursos de monitoramento integrados que podem ser estendidos
usando as interfaces no pacote com.ibm.websphere.objectgrid.management.
É possível examinar o código de origem do aplicativo xsadmin de amostra no arquivo wxs_home/samples/xsadmin.jar em uma instalação independente ou no arquivo wxs_home/xsadmin.jarem uma instalação do WebSphere Application Server.
É possível usar o utilitário xsadmin de amostra para visualizar o layout atual e o estado específico da grade de dados, como o conteúdo do mapa.
Neste exemplo, o layout da grade de dados nesta tarefa consiste
em uma única grade de dados ObjectGridA com um mapa MapA
que pertence ao conjunto de mapas MapSetA. Este exemplo
demonstra como é possível exibir todos os contêineres ativos dentro de uma grade de
dados e imprimir métricas filtradas referentes ao tamanho do mapa MapA.
Para visualizar todas as opções de comando possíveis, execute o utilitário xsadmin sem nenhum argumento ou com a opção -help.
Procedimento
- Acesse o diretório bin.
cd wxs_home/bin
- Execute o utilitário xsadmin.
- Para exibir a ajuda online, execute o comando
a seguir:
xsadmin.sh
xsadmin.bat
Você deve passar
somente uma das opções listadas para o utilitário funcionar. Se nenhuma opção -m ou -g for especificada, o utilitário xsadmin imprime as informações para cada grade na topologia.
- Para ativar as estatísticas de todos os servidores, execute o seguinte comando:
xsadmin.sh -g ObjectGridA -setstatsspec ALL=enabled
xsadmin.bat -g ObjectGridA -setstatsspec ALL=enabled
- Para exibir todos os contêineres on-line para uma grade, execute
o seguinte comando:
xsadmin.sh -g ObjectGridA -m MapSetA -containers
xsadmin.bat -g ObjectGridA -m MapSetA -containers
Todas as informações do contêiner
são exibidas. A seguir está um exemplo de saída:
Connecting to Catalog service at localhost:1099
*** Show all online containers for grid - ObjectGridA & mapset - MapSetA
Host: 192.168.0.186
Container: server1_C-0, Server:server1, Zone:DefaultZone
Partition Shard Type
0 Primary
Num containers matching = 1
Total known containers = 1
Total known hosts = 1
Atenção: Para obter essas informações quando o protocolo Segurança da Camada de Transporte/Secure Sockets Layer (TLS/SSL) estiver ativado, você deve iniciar os servidores de catálogos e de contêiner com o conjunto de portas do serviço JMX. Para configurar a porta de serviço JMX, é possível usar a opção -JMXServicePort no script startOgServer ou chamar o método setJMXServicePort na interface ServerProperties.
- Para conectar ao serviço de catálogo e exibir informações
sobre MapA, execute o seguinte comando:
xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA
xsadmin.bat -g ObjectGridA -m MapSetA -mapsizes -fm MapA
O tamanho do mapa especificado é
exibido. A seguir está um exemplo de saída:
Connecting to Catalog service at localhost:1099
****Displaying Results for Grid - ObjectGridA, MapSet - MapSetA*****
*** Listing Maps for server1 ***
Nome do Mapa Partição Tamanho do Mapa Bytes Usados (B) Tipo de Shard
MapA 0 0 0 Primário
- Para se conectar ao serviço de catálogo usando uma porta JMX específica e exibir informações sobre o mapa MapA, execute o seguinte comando:
xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA
-ch CatalogMachine -p 6645
xsadmin.bat -g ObjectGridA -m MapSetA -mapsizes -fm MapA
-ch CatalogMachine -p 6645
O utilitário xscmd de amostra se conecta ao servidor MBean que está em execução em um servidor de catálogos. Um servidor de catálogos pode ser executado como um processo independente, como um processo do WebSphere Application Server ou integrado em um processo de aplicativo customizado. Utilize a opção
-ch para especificar o nome do host do serviço
de catálogo e a opção -p para especificar a porta
de nomenclatura do serviço de catálogo.
O tamanho do mapa especificado é
exibido. A seguir está um exemplo de saída:
Connecting to Catalog service at CatalogMachine:6645
*****Displaying Results for Grid - ObjectGridA, MapSet - MapSetA*****
*** Listing Maps for server1 ***
Map Name: MapA Partition #: 0 Map Size: 0 Shard Type: Primary
Server Total: 0
- Para conectar-se a um serviço de catálogo hospedado em um processo do WebSphere Application Server, execute as etapas a seguir:
A opção -dmgr é necessária ao conectar-se
a um serviço de catálogo hospedado por qualquer processo do
WebSphere Application Server ou cluster de processos. Utilize
a opção -ch para especificar o nome do host se não
localhost e a opção -p para substituir
a porta de autoinicialização do serviço de catálogo, que utiliza o processo
BOOTSTRAP_ADDRESS. A opção -p será necessária apenas se o BOOTSTRAP_ADDRESS não estiver configurado com o padrão de 9809.
Nota: A
versão independente do
WebSphere eXtreme
Scale não pode
ser usada para se conectar a um serviço de catálogo hospedado por um processo do
WebSphere Application Server. Use o
xsadmin que é um script incluído no diretório
was_root/bin, que está disponível ao instalar o
WebSphere eXtreme
Scale no
WebSphere Application Server ou no
WebSphere Application Server Network Deployment.
- Navegue até o diretório bin do WebSphere Application Server:
cd was_root/bin
- Ative o utilitário xsadmin usando o seguinte comando:
xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA -dmgr
xsadmin.bat -g ObjectGridA -m MapSetA -mapsizes -fm MapA -dmgr
O tamanho do mapa especificado é
exibido.
Connecting to Catalog service at localhost:9809
****Displaying Results for Grid - ObjectGridA, MapSet - MapSetA*****
*** Listing Maps for server1 ***
Map Name: MapA Partition #: 0 Map Size: 0 Shard Type: Primary
Server Total: 0
- Para exibir o posicionamento configurado e de tempo de execução de sua configuração, execute um dos seguintes comandos:
xsadmin -placementStatus
xsadmin -placementStatus -g myOG -m myMapSet
xsadmin -placementStatus -m myMapSet
xsadmin -placementStatus -g myOG
É possível definir o escopo do comando para exibir informações de posicionamento para a configuração inteira, para uma grade de dados única, para um único conjunto de mapas ou para uma combinação de uma grade de dados e conjunto de mapas. A seguir está um exemplo de saída: ***********Printing Placement Status for Grid - Grid, MapSet - mapSet**************
<objectGrid name="Grid" mapSetName="mapSet">
<configuration>
<attribute name="placementStrategy" value="FIXED_PARTITIONS"/>
<attribute name="numInitialContainers" value="3"/>
<attribute name="minSyncReplicas" value="0"/>
<attribute name="developmentMode" value="true"/>
</configuration>
<runtime>
<attribute name="numContainers" value="3"/>
<attribute name="numMachines" value="1"/>
<attribute name="numOutstandingWorkItems" value="0"/>
</runtime>
</objectGrid>