Amostra: Utilitário xsadmin

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

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

  1. Acesse o diretório bin.
    cd wxs_home/bin
  2. Execute o utilitário xsadmin.
    • Para exibir a ajuda online, execute o comando a seguir:
      [Unix]
      xsadmin.sh
      [Windows]
      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:
      [Unix]
      xsadmin.sh -g ObjectGridA -setstatsspec ALL=enabled
      [Windows]
      xsadmin.bat -g ObjectGridA -setstatsspec ALL=enabled
    • Para exibir todos os contêineres on-line para uma grade, execute o seguinte comando:
      [Unix]
      xsadmin.sh -g ObjectGridA -m MapSetA -containers
      [Windows]
      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:
      [Unix]
      xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA
      [Windows]
      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:
      [Unix]
      xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA 
      		-ch CatalogMachine -p 6645

      [Windows]
      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.
      1. Navegue até o diretório bin do WebSphere Application Server:
        cd was_root/bin
      2. Ative o utilitário xsadmin usando o seguinte comando:
        [Unix]
         xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA -dmgr
        [Windows]
        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>