Ejemplo: Programa de utilidad xsadmin

Con el programa de utilidad xsadmin, puede formatear y visualizar información textual sobre la topología de WebSphere eXtreme Scale. El programa de utilidad de ejemplo proporciona un método para analizar y descubrir los datos de despliegue actuales, y se puede utilizar como base para crear programas de utilidad personalizados.

Antes de empezar

Acerca de esta tarea

El programa de utilidad de ejemplo xsadmin utiliza una implementación de beans gestionados (MBeans). Esta aplicación de supervisión de ejemplo habilita prestaciones de supervisión integradas rápidamente que puede ampliar utilizando las interfaces del paquete com.ibm.websphere.objectgrid.management. Puede mirar el código fuente de la aplicación de ejemplo xsadmin en el archivo inicio_wxs/samples/xsadmin.jar de una instalación autónoma o en el archivo inicio_wxs/xsadmin.jar de una instalación de WebSphere Application Server.

Puede utilizar el programa de utilidad de ejemplo xsadmin para visualizar el diseño actual y estado específico de la cuadrícula de datos como, por ejemplo, contenido de la cuadrícula. En este ejemplo, el diseño de la cuadrícula de datos de esta tarea consta de una sola cuadrícula de datos ObjectGridA con una correlación MapA que pertenece al conjunto de correlaciones MapSetA. Este ejemplo muestra cómo puede visualizar todos los contenedores activos en una cuadrícula de datos e imprimir métricas filtradas relacionadas con el tamaño de correlación de la correlación MapA. Para ver todas las posibles opciones del mandato, ejecute el programa de utilidad xsadmin sin los argumentos o con la opción -help.

Procedimiento

  1. Vaya al directorio bin.
    cd inicio_wxs/bin
  2. Ejecute el programa de utilidad xsadmin.
    • Para visualizar la ayuda en línea, ejecute el mandato siguiente:
      [Unix]
      xsadmin.sh
      [Windows]
      xsadmin.bat

      Debe pasar sólo una de las opciones listadas para que el programa de utilidad funcione. Si no se especifica ninguna opción -g o -m, el programa de utilidad xsadmin muestra la información para cada una de las cuadrículas de la topología.

    • Para habilitar estadísticas para todos los servidores, ejecute el mandato siguiente:
      [Unix]
      xsadmin.sh -g ObjectGridA -setstatsspec ALL=enabled
      [Windows]
      xsadmin.bat -g ObjectGridA -setstatsspec ALL=enabled
    • Para visualizar todos los contenedores en línea para una cuadrícula, ejecute el mandato siguiente:
      [Unix]
      xsadmin.sh -g ObjectGridA -m MapSetA -containers
      [Windows]
      xsadmin.bat -g ObjectGridA -m MapSetA -containers

      Se visualiza toda la información de contenedores. A continuación se muestra un ejemplo de la salida:

      Conexión al servicio de catálogo en localhost:1099
      
      
      *** Mostrar todos los contenedores en línea para la cuadrícula - 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
      Atención: Para obtener esta información cuando Transport Layer Security/Secure Sockets Layer (TLS/SSL) está habilitado, debe iniciar los servidores de catálogo y contenedor con el puerto de servicio JMX establecido. Para establecer el puerto de servicio JMX, puede utilizar la opción -JMXServicePort en el script startOgServer o puede llamar al método setJMXServicePort en la interfaz ServerProperties.
    • Para conectarse al servicio de catálogo y visualizar información sobre MapA, ejecute el mandato siguiente:
      [Unix]
      xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA
      [Windows]
      xsadmin.bat -g ObjectGridA -m MapSetA -mapsizes -fm MapA

      Se muestra el tamaño de la correlación especificada. A continuación se muestra un ejemplo de la salida:

      Conexión al servicio de catálogo en localhost:1099
      
      ****Mostrando resultados para Grid - ObjectGridA, MapSet - MapSetA*****
      
      
      *** Listado de Maps para server1 ***
       Map Name Partition Map Size Used Bytes (B) Shard Type
       MapA     0         0        0              Primary
    • Para conectarse al servicio de catálogo utilizando un puerto JMX específico y visualizar información sobre la correlación MapA, ejecute el mandato siguiente:
      [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

      El programa de utilidad de ejemplo xsadmin se conecta al servidor MBean que se ejecuta en un servidor de catálogo. Un servidor de catálogo puede ejecutarse como proceso autónomo, WebSphere Application Server o incorporado en un proceso de aplicación personalizado. Utilice la opción -ch para especificar el nombre de host del servicio de catálogo, y la opción -p para especificar el puerto de denominación del servicio de catálogo.

      Se muestra el tamaño de la correlación especificada. A continuación se muestra un ejemplo de la salida:

      Conexión al servicio de catálogo en CatalogMachine:6645
      
      *****Mostrando resultados para Grid - ObjectGridA, MapSet - MapSetA*****
      
      
      *** Listado de Maps para server1 ***
      Map Name: MapA  Partition #: 0  Map Size: 0  Shard Type: Primary
      Server Total: 0
    • Para conectarse a un servicio de catálogo alojado en un proceso de WebSphere Application Server, realice los pasos siguientes:

      La opción -dmgr es necesaria al conectarse con un servicio de catálogo que alberga cualquier proceso o clúster de procesos de WebSphere Application Server. Utilice la opción -ch para especificar el nombre de host si no es localhost, y la opción -p para alterar temporalmente el puerto del programa de arranque del servicio de catálogo, que utilice el proceso BOOTSTRAP_ADDRESS. La opción -p solo es necesaria si BOOTSTRAP_ADDRESS no está establecido en el valor predeterminado de 9809.

      Nota: La versión autónoma de WebSphere eXtreme Scale no se puede utilizar para conectarse a un servicio de catálogo alojado por un proceso de WebSphere Application Server. Utilice el programa de utilidad xsadmin que es el script incluido en el directorio raíz_was/bin, disponible al instalar WebSphere eXtreme Scale en WebSphere Application Server o WebSphere Application Server Network Deployment.
      1. Desplácese al directorio bin de WebSphere Application Server:
        cd raíz_was/bin
      2. Inicie el programa de utilidad xsadmin mediante el siguiente mandato:
        [Unix]
         xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA -dmgr
        [Windows]
        xsadmin.bat -g ObjectGridA -m MapSetA -mapsizes -fm MapA -dmgr

      Se muestra el tamaño de la correlación especificada.

      Conexión al servicio de catálogo en localhost:9809
      
      ****Mostrando resultados para Grid - ObjectGridA, MapSet - MapSetA*****
      
      
      *** Listado de Maps para server1 ***
      Map Name: MapA  Partition #: 0  Map Size: 0  Shard Type: Primary
      Server Total: 0
    • Para visualizar la colocación configurada y de tiempo de ejecución de la configuración, ejecute uno de los mandatos siguientes:
      xsadmin -placementStatus
      xsadmin -placementStatus -g myOG -m myMapSet
      xsadmin -placementStatus -m myMapSet
      xsadmin -placementStatus -g myOG
      Puede hacer que el mandato visualice información de colocación para toda la configuración, una sola cuadrícula de datos, un único conjunto de correlaciones o una combinación de una cuadrícula de datos y un conjunto de correlaciones. A continuación se muestra un ejemplo de la salida:
      ***********Mostrar estado de colocación para 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>