Tareas administrativas del dominio de servicio de catálogo

Puede utilizar los lenguajes de script Jacl o Jython para gestionar dominios de servicio de catálogo en la configuración de WebSphere Application Server.

Requisitos

Debe haber instalado WebSphere eXtreme Scale Client en el entorno de WebSphere Application Server.

Lista de todas las tareas administrativas

Para obtener una lista de todas las tareas administrativas asociadas con los dominios de servicio de catálogo, ejecute el siguiente mandato con wsadmin:
wsadmin>$AdminTask help XSDomainManagement 

Mandatos

Las tareas administrativas para dominios de servicio de catálogo incluyen los siguientes mandatos:

createXSDomain

El mandato createXSDomain registra un nuevo dominio de servicio de catálogo.
Tabla 1. Argumentos del mandato createXSDomain
Argumento Descripción
-name (necesario) Especifica el nombre del dominio de servicio de catálogo que el usuario desea crear.
-default Especifica si el dominio de servicio de catálogo es el predeterminado para la célula. El valor predeterminado es true. (Booleano: establecido en true ofalse)
-properties Especifica las propiedades personalizadas del dominio de servicio de catálogo.
Tabla 2. Argumentos del paso defineDomainServers
Argumento Descripción
nombre_de_punto_final Especifica el nombre del punto final de servicio de catálogo.
  • Para los servidores de aplicación existentes: el nombre del punto final debe tener el formato siguiente: nombre_de_célula\nombre_de_nodo\nombre_de_servidor
  • Para los servidores remotos: especifica el nombre de host del servidor remoto. Puede tener el mismo nombre para varios puntos finales pero los valores de puerto de cliente deben ser exclusivos para cada punto final.
propiedades_personalizadas Especifica las propiedades personalizadas del punto final del dominio de servicio de catálogo. Si no tiene propiedades personalizadas, utilice un juego de comillas ("") para este argumento.
puertos_de_punto_final
Especifica los números de puerto para el punto final del dominio de servicio de catálogo. Los puertos se deben especificar por el orden siguiente: <puerto_de_cliente>,<puerto_de_escucha>
Puerto de cliente
Especifica el puerto que se utiliza para la comunicación entre los servidores de catálogo en el dominio de servicio de catálogo. Este valor es necesario para los servidores de catálogo que se están ejecutando sólo en procesos de WebSphere Application Server y se puede establecer en cualquier puerto que no se esté utilizando en otro sitio.
Puerto de escucha
Especifica el puerto que se utiliza para la comunicación con clientes. Este valor es necesario para los puntos finales remotos y debe coincidir con el valor utilizado cuando se inició el servicio de catálogo. El puerto de escucha lo utilizan los clientes y los contenedores para comunicarse con el servicio de catálogo.
Para los puntos finales remotos de WebSphere eXtreme Scale: define el puerto de escucha de intermediario para solicitudes de objetos (ORB) para que los contenedores y clientes se comuniquen con el servicio de catálogo a través del ORB. Para puntos finales de WebSphere Application Server, el valor de puerto de escucha es opcional porque el valor se hereda de la configuración del puerto BOOTSTRAP_ADDRESS.
Tabla 3. Argumentos del paso configureClientSecurity
Argumento Descripción
-securityEnabled Especifica que está habilitada la seguridad de cliente para el servidor de catálogo. El archivo de propiedades del servidor que está asociado al servidor de catálogo seleccionado debe tener un valor securityEnabled coincidente en el archivo de propiedades del servidor. Si estos valores no coinciden, se produce una excepción. (Booleano: establecido en true ofalse)
-credentialAuthentication (opcional) Indica si se fuerza o si se da soporte a la autenticación de credenciales.
Nunca

No se fuerza la autenticación de certificados.

Necesario
La autenticación de credenciales se fuerza siempre. Si el servidor no da soporte a la autenticación de credenciales, el cliente no puede establecer conexión con el servidor.
Soportado
(Valor predeterminado) Sólo se fuerza la autenticación de credenciales si tanto el cliente como el servidor dan soporte a la misma.
-authenticationRetryCount (opcional) Especifica el número de veces que se vuelve a intentar la autenticación si la credencial ha caducado.

Si no desea volver a intentar la autenticación, establezca el valor a 0. El valor predeterminado es 0.

-credentialGeneratorClass Indica la clase com.ibm.websphere.objectgrid.security.plugins.builtins. Clase de implementación WSTokenCredentialGenerator, de modo que el cliente recupera las señales de seguridad de la hebra.
-credentialGeneratorProps Especifica las propiedades para la clase de implementación CredentialGenerator. Las propiedades se envían al objeto con el método setProperties(String). El valor propiedades del generador de credenciales se utiliza únicamente cuando se especifica un valor en el campo Clase del generador de credenciales.

Valor de retorno:

Uso de ejemplo de modalidad de proceso por lotes

La modalidad de proceso necesita un formato correcto de la entrada de mandatos. Puede utilizar la modalidad interactiva para asegurarse de que los valores especificados se procesan correctamente. Cuando utiliza la modalidad de proceso por lotes, debe definir los argumentos de paso de -defineDomainServers mediante una matriz de propiedades específica. Esta matriz de propiedades tiene el formato nombre_de_punto_final propiedades_personalizadas puertos_de_punto_final. El valor puertos_de_punto_final es una lista de puertos que se deben especificar por el orden siguiente: <puerto_de_cliente>,<puerto_de_escucha>.

Uso de ejemplo de modalidad interactiva
  • Utilizando Jacl:
    $AdminTask createXSDomain {-interactive}
  • Utilizando la serie de Jython:
    AdminTask.createXSDomain ('[-interactive]')

deleteXSDomain

El mandato deleteXSDomain suprime un dominio de servicio de catálogo.

Parámetros necesarios:
-name
Especifica el nombre del dominio de servicio de catálogo que debe suprimirse.

Valor de retorno:

Uso de ejemplo de modalidad de proceso por lotes
  • Utilizando Jacl:
    $AdminTask deleteXSDomain {-name TestDomain }
  • Utilizando la serie de Jython:
    AdminTask.deleteXSDomain('[-name TestDomain ]')
Uso de ejemplo de modalidad interactiva
  • Utilizando Jacl:
    $AdminTask deleteXSDomain {-interactive}
  • Utilizando la serie de Jython:
    AdminTask.deleteXSDomain ('[-interactive]')

getDefaultXSDomain

El mandato getDefaultXSDomain devuelve el dominio de servicio de catálogo de la célula.

Parámetros necesarios: ninguno

Valor de retorno: el nombre del dominio de servicio de catálogo predeterminado.

Uso de ejemplo de modalidad de proceso por lotes
  • Utilizando Jacl:
    $AdminTask getDefaultXSDomain
  • Utilizando la serie de Jython:
    AdminTask.getDefaultXSDomain
Uso de ejemplo de modalidad interactiva
  • Utilizando Jacl:
    $AdminTask getDefaultXSDomain {-interactive}
  • Utilizando la serie de Jython:
    AdminTask.getDefaultXSDomain ('[-interactive]')

listXSDomains

El mandato listXSDomains devuelve una lista de los dominios de servicio de catálogo existentes.

Parámetros necesarios: ninguno

Valor de retorno: una lista de todos los dominios de servicio de catálogo de la célula.

Uso de ejemplo de modalidad de proceso por lotes
  • Utilizando Jacl:
    $AdminTask listXSDomains
  • Utilizando la serie de Jython:
    AdminTask.listXSDomains
Uso de ejemplo de modalidad interactiva
  • Utilizando Jacl:
    $AdminTask listXSDomains {-interactive}
  • Utilizando la serie de Jython:
    AdminTask.listXSDomains ('[-interactive]')

modifyXSDomain

El mandato modifyXSDomain modifica un dominio de servicio de catálogo existente.

La modalidad de proceso necesita un formato correcto de la entrada de mandatos. Puede utilizar la modalidad interactiva para asegurarse de que los valores especificados se procesan correctamente. Cuando utiliza la modalidad de proceso por lotes, debe definir los argumentos de paso de -modifyEndpoints, -addEndpoints y -removeEndpoints mediante una matriz de propiedades específica. Esta matriz de propiedades tiene el formato nombre_de_punto_final nombre_de_host propiedades_personalizadas puertos_de_punto_final. El valor puertos_de_punto_final es una lista de puertos que se deben especificar por el orden siguiente: <puerto_de_cliente>,<puerto_de_escucha>.

Tabla 4. Argumentos del mandato modifyXSDomain
Argumento Descripción
-name (necesario) Especifica el nombre del dominio de servicio de catálogo que el usuario desea editar.
-default Si se establece en true, especifica que el dominio de servicio de catálogo seleccionado es el valor predeterminado de la célula. (Booleano)
-properties Especifica las propiedades personalizadas del dominio de servicio de catálogo.
Tabla 5. Argumentos del paso modifyEndpoints
Argumento Descripción
nombre_de_punto_final Especifica el nombre del punto final de servicio de catálogo.
  • Para los servidores de aplicación existentes: el nombre del punto final debe tener el formato siguiente: nombre_de_célula\nombre_de_nodo\nombre_de_servidor
  • Para los servidores remotos: especifica el nombre de host del servidor remoto. Puede tener el mismo nombre para varios puntos finales pero los valores de puerto de escucha deben ser exclusivos para cada punto final.
puertos_de_punto_final
Especifica los números de puerto para el punto final del dominio de servicio de catálogo. Los puntos finales se deben especificar por el orden siguiente: <puerto_de_cliente>,<puerto_de_escucha>
Puerto de cliente
Especifica el puerto que se utiliza para la comunicación entre los servidores de catálogo en el dominio de servicio de catálogo. Este valor es necesario para los servidores de catálogo que se están ejecutando sólo en procesos de WebSphere Application Server y se puede establecer en cualquier puerto que no se esté utilizando en otro sitio.
Puerto de escucha
Especifica el puerto que se utiliza para la comunicación con clientes. Este valor es necesario para los puntos finales remotos y debe coincidir con el valor utilizado cuando se inició el servicio de catálogo. El puerto de escucha lo utilizan los clientes y los contenedores para comunicarse con el servicio de catálogo.
Para los puntos finales remotos de WebSphere eXtreme Scale: define el puerto de escucha de intermediario para solicitudes de objetos (ORB) para que los contenedores y clientes se comuniquen con el servicio de catálogo a través del ORB. Para puntos finales de WebSphere Application Server, la especificación del valor de puerto de escucha es opcional porque el valor se hereda de la configuración del puerto BOOTSTRAP_ADDRESS.
Tabla 6. Argumentos del paso addEndpoints
Argumento Descripción
nombre_de_punto_final Especifica el nombre del punto final de servicio de catálogo.
  • Para los servidores de aplicación existentes: el nombre del punto final debe tener el formato siguiente: nombre_de_célula\nombre_de_nodo\nombre_de_servidor
  • Para los servidores remotos: especifica el nombre de host del servidor remoto. Puede tener el mismo nombre para varios puntos finales pero los valores de puerto de escucha deben ser exclusivos para cada punto final.
propiedades_personalizadas Especifica las propiedades personalizadas del punto final del dominio de servicio de catálogo. Si no tiene propiedades personalizadas, utilice un juego de comillas ("") para este argumento.
puertos_de_punto_final
Especifica los números de puerto para el punto final del dominio de servicio de catálogo. Los puntos finales se deben especificar por el orden siguiente: <puerto_de_cliente>,<puerto_de_escucha>
Puerto de cliente
Especifica el puerto que se utiliza para la comunicación entre los servidores de catálogo en el dominio de servicio de catálogo. Este valor es necesario para los servidores de catálogo que se están ejecutando sólo en procesos de WebSphere Application Server y se puede establecer en cualquier puerto que no se esté utilizando en otro sitio.
Puerto de escucha
Especifica el puerto que se utiliza para la comunicación con clientes. Este valor es necesario para los puntos finales remotos y debe coincidir con el valor utilizado cuando se inició el servicio de catálogo. El puerto de escucha lo utilizan los clientes y los contenedores para comunicarse con el servicio de catálogo.
Para los puntos finales remotos de WebSphere eXtreme Scale: define el puerto de escucha de intermediario para solicitudes de objetos (ORB) para que los contenedores y clientes se comuniquen con el servicio de catálogo a través del ORB. Para puntos finales de WebSphere Application Server, la especificación del valor de puerto de escucha es opcional porque el valor se hereda de la configuración del puerto BOOTSTRAP_ADDRESS.
Tabla 7. Argumentos del paso removeEndpoints
Argumento Descripción
nombre_de_punto_final Especifica el nombre del punto final de servicio de catálogo que debe suprimirse.
Tabla 8. Argumentos del paso configureClientSecurity
Argumento Descripción
-securityEnabled Especifica que está habilitada la seguridad de cliente para el servidor de catálogo. El archivo de propiedades del servidor que está asociado al servidor de catálogo seleccionado debe tener un valor securityEnabled coincidente en el archivo de propiedades del servidor. Si estos valores no coinciden, se produce una excepción. (Booleano: establecido en true ofalse)
-credentialAuthentication (opcional) Indica si se fuerza o si se da soporte a la autenticación de credenciales.
Nunca

No se fuerza la autenticación de certificados.

Necesario
La autenticación de credenciales se fuerza siempre. Si el servidor no da soporte a la autenticación de credenciales, el cliente no puede establecer conexión con el servidor.
Soportado
(Valor predeterminado) Sólo se fuerza la autenticación de credenciales si tanto el cliente como el servidor dan soporte a la misma.
-authenticationRetryCount (opcional) Especifica el número de veces que se vuelve a intentar la autenticación si la credencial ha caducado.

Si no desea volver a intentar la autenticación, establezca el valor a 0. El valor predeterminado es 0.

-credentialGeneratorClass Indica la clase com.ibm.websphere.objectgrid.security.plugins.builtins. Clase de implementación WSTokenCredentialGenerator, de modo que el cliente recupera las señales de seguridad de la hebra.
-credentialGeneratorProps Especifica las propiedades para la clase de implementación CredentialGenerator. Las propiedades se envían al objeto con el método setProperties(String). El valor propiedades del generador de credenciales se utiliza únicamente cuando se especifica un valor en el campo Clase del generador de credenciales.

Valor de retorno:

Uso de ejemplo de modalidad de proceso por lotes
  • Utilizando Jacl:
    $AdminTask modifyXSDomain {-name TestDomain -default true -modifyEndpoints 
    {{xhost1.ibm.com "" ,2809}} -addEndpoints {{xhost2.ibm.com "" ,2809}}} 
    -removeEndpoints {{xhost3.ibm.com}}}
  • Utilizando la serie de Jython:
    AdminTask.modifyXSDomain('[-name TestDomain  
    -default false -modifyEndpoints [[xhost1.ibm.com "" ,2809]] 
    -addEndpoints [[xhost3.ibm.com "" ,2809]] 
    -removeEndpoints [[xhost2.ibm.com]]]')
  • Uso de la especificación de la seguridad de cliente durante el mandato modify:
    $AdminTask modifyXSDomain {-name myDomain -default false 
    -configureClientSecurity {-securityEnabled true - 
    Supported -authenticationRetryCount 1 -credentialGeneratorClass 
    com.ibm.websphere.objectgrid.security.plugins.builtins.UserPasswordCredentialGenerator  
    -credentialGeneratorProps "manager manager1"}}
Uso de ejemplo de modalidad interactiva
  • Utilizando Jacl:
    $AdminTask modifyXSDomain {-interactive}
  • Utilizando la serie de Jython:
    AdminTask.modifyXSDomain ('[-interactive]')

testXSDomainConnection

El mandato testXSDomainConnection prueba la conexión a un dominio de servicio de catálogo.

Parámetros necesarios:
-name
Especifica el nombre del dominio de servicio de catálogo para el que debe probarse la conexión.
Parámetros opcionales
-timeout
Especifica la cantidad máxima de tiempo que debe esperarse para que se establezca la conexión en segundos.

Valor de retorno: si se puede establecer una conexión, devuelve true y, si no se puede, devuelve información sobre el error de conexión.

Uso de ejemplo de modalidad de proceso por lotes
  • Utilizando Jacl:
    $Admintask testXSDomainConnection
  • Utilizando la serie de Jython:
    AdminTask.testXSDomainConnection
Uso de ejemplo de modalidad interactiva
  • Utilizando Jacl:
    $AdminTask testXSDomainConnection {-interactive}
  • Utilizando la serie de Jython:
    AdminTask.testXSDomainConnection ('[-interactive]')

testXSServerConnection

El mandato testXSServerConnection prueba la conexión a un servidor de catálogo. Este mandato funciona tanto para servidores autónomos como para servidores que forman parte de un dominio de servicio de catálogo.

Parámetros necesarios:
host
Especifica el host en el que reside el servidor de catálogo.
listenerPort
Especifica el puerto de escucha del servidor de catálogo.
Parámetros opcionales
tiempo de espera
Especifica la duración máxima de tiempo que se va a esperar para una conexión al servidor de catálogo, en segundos.
domain
Especifica el nombre de un dominio de servicio de catálogo. Si define un valor para este parámetro, se utilizan las propiedades de la seguridad de cliente del dominio de servicio de catálogo especificado para probar la conexión. De lo contrario, se produce una búsqueda para encontrar el dominio de servicio de catálogo para el host y el puerto de escucha especificados. Si se encuentra un dominio de servicio de catálogo, se utilizan las propiedades de seguridad de cliente definidas para ese dominio de servicio de catálogo para probar el servidor. De lo contrario no se utilizan propiedades de seguridad de cliente durante la prueba.

Valor de retorno:

Uso de ejemplo de modalidad de proceso por lotes
  • Utilizando Jacl:
    $Admintask testXSServerConnection {-host xhost1.ibm.com -listenerPort 2809}
  • Utilizando la serie de Jython:
    AdminTask.testXSServerConnection('[-host xshost3.ibm.com -listenerPort 2809]')
Uso de ejemplo de modalidad interactiva
  • Utilizando Jacl:
    $AdminTask testXSServerConnection {-interactive}
  • Utilizando la serie de Jython:
    AdminTask.testXSServerConnection ('[-interactive]')