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
- El programa de utilidad xsadmin se proporciona como un ejemplo de cómo puede crear propiedades personalizadas para el despliegue.
El programa de utilidad xscmd se proporciona como un programa de
utilidad soportado para supervisar y administrar el entorno. Para obtener más información, consulte Administering with the xscmd utility.
- Para que el programa de utilidad xsadmin visualice resultados, debe haber creado la topología de la cuadrícula de datos. Los servidores de catálogo y los servidores de contenedor deben estar iniciados.
Si desea más información, consulte Inicio y detención de los servidores autónomos.
- Verifique que la variable de entorno JAVA_HOME
esté establecida para utilizar el entorno de ejecución que se ha instalado con el producto. Si
está utilizando la versión de prueba del producto, debe establecer la variable de entorno
JAVA_HOME.
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
- Vaya al directorio bin.
cd inicio_wxs/bin
- Ejecute el programa de utilidad xsadmin.
- Para visualizar la ayuda en línea, ejecute el mandato siguiente:
xsadmin.sh
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:
xsadmin.sh -g ObjectGridA -setstatsspec ALL=enabled
xsadmin.bat -g ObjectGridA -setstatsspec ALL=enabled
- Para visualizar todos los contenedores en línea para una cuadrícula, ejecute el mandato
siguiente:
xsadmin.sh -g ObjectGridA -m MapSetA -containers
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:
xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA
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:
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
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.
- Desplácese al directorio bin de WebSphere Application Server:
cd raíz_was/bin
- Inicie el programa de utilidad xsadmin mediante el siguiente mandato:
xsadmin.sh -g ObjectGridA -m MapSetA -mapsizes -fm MapA -dmgr
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>