Referencia del programa de utilidad xsadmin

Puede pasar argumentos al programa de utilidad xsadmin con dos métodos distintos: con un argumento de línea de mandatos o con un archivo de propiedades.

Argumentos de xsadmin

Puede definir un archivo de propiedades para el programa de utilidad xsadmin con WebSphere eXtreme Scale Client versión 7.1 Fix 1 o posterior. Al crear un archivo de propiedades puede ahorrarse algunos de los argumentos utilizados con frecuencia, como por ejemplo el nombre de usuario. En la tabla siguiente se indican las propiedades que puede añadir a un archivo de propiedades. Si especifica tanto una propiedad en un archivo de propiedades como el argumento de línea de mandatos equivalente, este último sobrescribe el valor del archivo de propiedades.

Tabla 1. Argumentos del programa de utilidad xsadmin
Argumento de línea de mandatos Nombre de la propiedad equivalente en el archivo de propiedades Descripción y valores válidos
-bp n/a

Indica el puerto de escucha.

Valor predeterminado:2809

-ch n/a

Indica el nombre de host JMX para el servidor de catálogo.

Valor predeterminado:localhost

-clear n/a

Borra la correlación especificada.

Permite los filtros siguientes: -fm

-containers n/a Para cada cuadrícula de datos y conjunto de correlaciones, muestra una lista de servidores de contenedores.

Permite los filtros siguientes: -fnp

-continuous n/a Especifique este distintivo si desea resultados de tamaño de correlación continuos para supervisar la cuadrícula de datos. Al ejecutar este mandato con el argumento -mapsizes, el tamaño de la correlación se visualiza cada 20 segundos.
-coregroups n/a Muestra todos los grupos principales del servidor de catálogo. Este argumento se utiliza para diagnósticos avanzados.
-dismissLink <dominio_servicio_catálogo> n/a

Este argumento de línea de mandatos no se aplica en configuraciones de WebSphere DataPower XC10 Appliance.

-dmgr n/a

Este argumento de línea de mandatos no se aplica en configuraciones de WebSphere DataPower XC10 Appliance.

-empties n/a Especifique este distintivo si desea que se muestren los contenedores vacíos en la salida.
-establishLink <nombre_dominio_foráneo> <host1:puerto1,host2:puerto2...> n/a

Este argumento de línea de mandatos no se aplica en configuraciones de WebSphere DataPower XC10 Appliance.

-fc n/a Filtra únicamente para este contenedor.
Si está filtrando servidores de contenedor en un entorno de WebSphere Application Server Network Deployment, utilice el siguiente formato:
<nombre_célula>/<nombre_nodo>/<nombreServidor_sufijoContenedor>

Utilícelo con los argumentos siguientes: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fh n/a Filtra únicamente para este host.

Utilícelo con los argumentos siguientes: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-fm n/a Filtra solo para esta correlación.

Utilícelo con los argumentos siguientes: -clear, -mapsizes

-fnp n/a Filtra los servidores que no tienen fragmentos primarios.

Utilícelo con los argumentos siguientes: -containers

-fp n/a Filtra únicamente para esta partición.

Utilícelo con los argumentos siguientes: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-fs n/a Filtra únicamente para este servidor.
Si está filtrando servidores de aplicaciones en un entorno de WebSphere Application Server Network Deployment, utilice el formato siguiente:
<nombre_célula>/<nobre_nodo>/<nombre_servidor>

Utilícelo con los argumentos siguientes: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fst n/a Filtra únicamente para este tipo de fragmento. Especifique P únicamente para fragmentos primarios, A únicamente para fragmentos de réplicas asíncronas, y S únicamente para fragmentos de réplicas síncronas.

Utilícelo con los argumentos siguientes: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec

-fz n/a Filtra únicamente para esta zona.

Utilícelo con los argumentos siguientes: -mapsizes, -teardown,-revisions,-getTraceSpec,-setTraceSpec,-getStatsSpec,-setStatsSpec,-routetable

-force n/a Fuerza la acción que indica el mandato, inhabilitando las posibles solicitudes preventivas. Este argumento es útil para la ejecución de mandatos por lotes.
-g n/a Especifica el nombre de ObjectGrid.
-getstatsspec n/a Visualiza la información de estadísticas actual. Puede establecer la especificación de estadísticas con el argumento -setstatsspec.

Permite los filtros siguientes: -fst -fc -fz -fs -fh -fp

-getTraceSpec n/a Visualiza la especificación de rastreo actual. Puede establecer la especificación de rastreo con el argumento -settracespec.

Permite los filtros siguientes: -fst -fc -fz -fs -fh -fp

-h n/a Visualiza la ayuda del programa de utilidad xsadmin, que incluye una lista de argumentos.
-hosts n/a Muestra todos los hosts de la configuración.
-jmxUrl XSADMIN_JMX_URL Especifica la direccionar de un servidor conector JMX API en el formato siguiente: service:jmx:protocolo:sap. A continuación se indican las definiciones de las variables protocolo sap:
protocolo
Especifica el protocolo de transporte a utilizar para establecer conexión con el servidor conector.
sap
Especifica la dirección en la que se encuentre el servidor conector.
Para obtener más información sobre el formato del URL del servicio JMX, consulte Class JMXServiceURL (Java™ 2 Platform SE 5.0).
-l n/a Muestra todas las cuadrículas de datos y conjuntos de correlaciones conocidos.
-m n/a Especifica el nombre del conjunto de correlaciones.
-mapsizes n/a Muestra el tamaño de cada correlación del servidor de catálogo para verificar que la distribución de claves es uniforme en los distintos fragmentos.

Permite los filtros siguientes: -fm -fst -fc -fz -fs -fh -fp

-mbeanservers n/a Muestra una lista de todos los puntos finales de servidor MBean.
-overridequorum n/a

Este argumento de línea de mandatos no se aplica en configuraciones de WebSphere DataPower XC10 Appliance.

-password XSADMIN_PASSWORD Especifica la contraseña utilizada para iniciar sesión en el programa de utilidad xsadmin. No especifique la contraseña en el archivo de propiedades si desea que la contraseña se mantenga segura.
-p n/a

Este argumento de línea de mandatos no se aplica en configuraciones de WebSphere DataPower XC10 Appliance.

  n/a Muestra la colocación configurada y la colocación en tiempo de ejecución de la configuración. Puede definir el ámbito de la salida en una combinación de cuadrículas de datos y conjuntos de correlaciones o para la configuración completa:
  • Configuración completa
    -placementStatus
  • Para una cuadrícula de datos: específica:
    -placementStatus -g mi_cuadrícula
  • Para un conjunto de correlaciones específico:
    -placementStatus -m mi_conjunto_correlaciones
  • Para una cuadrícula de datos y un conjunto de correlaciones específicos:
    -placementStatus  -g mi_cuadrícula
    -m mi_conjunto_correlaciones
-primaries n/a Muestra una lista de los fragmentos primarios.
-profile n/a Especifica una vía de acceso completa al archivo de propiedades del programa de utilidad xsadmin.
-quorumstatus n/a

Este argumento de línea de mandatos no se aplica en configuraciones de WebSphere DataPower XC10 Appliance.

-releaseShard <nombre_servidor_contenedor> <nombre_cuadrícula_objetos> <nombre_conjunto_correlaciones> <nombre_partición> n/a Se utiliza junto con el argumento -reserveShard. Se debe invocar el argumento -releaseShard después de que se haya reservado y colocado un fragmento. El argumento -releaseShard invoca el método ContainerMBean.release().
-reserved n/a Se utiliza con el argumento -containers para visualizar solo fragmentos que se han reservado con el argumento -reserveShard.
-reserveShard <nombre_servidor_contenedor> <nombre_cuadrícula_objetos> <nombre_conjunto_correlaciones> <nombre_partición> n/a Mueve un fragmento primario al servidor de contenedor especificado. Este argumento invoca el método ContainerMBean.reserve().

-resumeBalancing <nombre_objectgrid> <nombre_conjunto_correlaciones>

n/a Intentos para equilibrar solicitudes. Habilita futuros intentos de reequilibrado en el ObjectGrid y conjunto de correlaciones especificados.
-revisions n/a Visualiza identificadores de revisión de un dominio de servicio de catálogo, que incluyen: cada cuadrícula de datos, número de partición, tipo de partición (primaria o de réplica), dominio de servicio de catálogo, ID de tiempo de vida y número de revisiones de datos para cada fragmento específico. Puede utilizar este argumento para determinar si se detecta una réplica asíncrona o un dominio enlazado. Este argumento invoca el método ObjectGridMBean.getKnownRevisions().

Permite los filtros siguientes: -fst -fc -fz -fs -fh -fp

-routetable n/a Muestra el estado actual de la cuadrícula de datos desde una perspectiva de cliente-servidor. La tabla de direccionamiento es la información que un cliente-servidor de ObjectGrid utiliza para la comunicación con la cuadrícula de datos. Utilice la tabla de direccionamiento como una ayuda para el diagnóstico cuando intente identificar problemas de conexiones o excepciones TargetNotAvailable.

Argumentos necesarios: en un entorno autónomo, debe especificar los parámetros -bp y -p con este argumento si no está utilizando los valores predeterminados para el puerto de escucha del programa de arranque y el puerto JMX para el host de servidor de catálogo.

Permite los filtros siguientes: -fz -fh -fp

-settracespec <serie_rastreo> n/a

Este argumento de línea de mandatos no se aplica en configuraciones de WebSphere DataPower XC10 Appliance. Consulte el apartado Cómo trabajar con archivos de registro de WebSphere DataPower XC10 Appliance para obtener más información cómo configurar el rastreo en el dispositivo.

Permite los filtros siguientes: -fst -fc -fz -fs -fh -fp

-swapShardWithPrimary <nombre_servidor_contenedor> <nombre_objectgrid> <nombre_conjunto_correlaciones> <nombre_partición>

n/a Intercambia el fragmento de réplica especificado del servidor de contenedor especificado con el fragmento primario. Mediante la ejecución de este mandato puede equilibrar manualmente los fragmentos primarios cuando sea necesario.
-setstatsspec <espec_estad> n/a Habilita la recopilación de estadísticas. Este argumento invoca los métodos DynamicServerMBean.setStatsSpec y DynamicServerMBean.getStatsSpec.

Permite los filtros siguientes: -fm -fst -fc -fz -fs -fh -fp

-suspendBalancing <nombre_objectgrid> <nombre_conjunto_correlaciones>

n/a Evita intentos futuros de equilibrar el ObjectGrid y el conjunto de correlaciones especificados.
-ssl n/a Indica que la Capa de sockets seguros (SSL- Secure Sockets Layer) está habilitada.
-teardown n/a

Permite los filtros siguientes: -fst -fc -fz -fs -fh -fp

Formato para proporcionar una lista de servidores:
nombre_servidor_1,nombre_servidor_2 ...
Para detener todos los servidores de una zona, incluya el argumento -fz:
–fz <nombre_zona>
Para detener todos los servidores de un host, incluya el argumento -fh:
–fh <nombre_host>

Este argumento de línea de mandatos no se aplica en configuraciones de WebSphere DataPower XC10 Appliance.

  n/a Fuerza la ejecución de la colocación de fragmentos, ignorando el valor numInitialContainers configurado en el archivo XML de despliegue. Puede utilizar este argumento cuando realice mantenimiento en los servidores para permitir que la colocación de fragmentos se continúe ejecutando, aunque el valor numInitialContainers sea inferior al valor configurado.
-trustPass XSADMIN_TRUST_PASS Especifica la contraseña del almacén de confianza especificado.
-trustPath XSADMIN_TRUST_PATH Especifica una vía de acceso al archivo de almacén de confianza.

Ejemplo: etc/test/security/server.public

-trustType XSADMIN_TRUST_TYPE Especifica el tipo de almacén de confianza.

Valores válidos: JKS, JCEK, PKCS12, etc.

-unassigned n/a Muestra una lista de fragmentos que no se pueden colocar en la cuadrícula de datos. Los fragmentos no se pueden colocar cuando el servicio de colocación tiene una restricción que evita la colocación.
-username XSADMIN_USERNAME Especifica el nombre de usuario para iniciar sesión en el programa de utilidad xsadmin.
-v n/a Habilita la acción de línea de mandatos detallada. Utilice este distintivo si utiliza variables de entorno, un archivo de propiedades o ambas cosas para especificar ciertos argumentos de línea de mandatos y desea ver sus valores.
-xml n/a Visualiza la salida no filtrada del método PlacementServiceMBean.listObjectGridPlacement(). Los otros argumentos xsadmin filtran la salida de este método y organizan los datos en un formato más consumible.