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 que estén asociadas con los dominios del 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 puntos finales remotos de WebSphere DataPower XC10 Appliance: utilice el valor 2809 para los puntos finales remotos de dispositivo.

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
  • Uso de Jacl:
    $AdminTask createXSDomain {-interactive}
  • Uso de 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
  • Uso de Jacl:
    $AdminTask deleteXSDomain {-name TestDomain }
  • Uso de la serie de Jython:
    AdminTask.deleteXSDomain('[-name TestDomain ]')
Uso de ejemplo de modalidad interactiva
  • Uso de Jacl:
    $AdminTask deleteXSDomain {-interactive}
  • Uso de la serie de Jython:
    AdminTask.deleteXSDomain ('[-interactive]')

getDefaultXSDomain

El mandato getDefaultXSDomain devuelve el dominio de servicio de catálogo predeterminado a 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
  • Uso de Jacl:
    $AdminTask getDefaultXSDomain
  • Uso de la serie de Jython:
    AdminTask.getDefaultXSDomain
Uso de ejemplo de modalidad interactiva
  • Uso de Jacl:
    $AdminTask getDefaultXSDomain {-interactive}
  • Uso de 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 con todos los dominios de servicio de catálogo en la célula.

Uso de ejemplo de modalidad de proceso por lotes
  • Uso de Jacl:
    $AdminTask listXSDomains
  • Uso de la serie de Jython:
    AdminTask.listXSDomains
Uso de ejemplo de modalidad interactiva
  • Uso de Jacl:
    $AdminTask listXSDomains {-interactive}
  • Uso de 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 3. 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 predeterminado para la célula. (Booleano)
-properties Especifica las propiedades personalizadas del dominio de servicio de catálogo.
Tabla 4. 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. Este valor debe ser un nombre de dominio completo si está configurando un dispositivo.
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 puntos finales remotos de WebSphere DataPower XC10 Appliance: utilice el valor 2809 para los puntos finales remotos de dispositivo.
Tabla 5. 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. Este valor debe ser un nombre de dominio completo si está configurando un dispositivo.
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 puntos finales remotos de WebSphere DataPower XC10 Appliance: utilice el valor 2809 para los puntos finales remotos de dispositivo.
Tabla 6. 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.

Valor de retorno:

Uso de ejemplo de modalidad de proceso por lotes
  • Uso de Jacl:
    $AdminTask modifyXSDomain {-name TestDomain -default true -modifyEndpoints 
    {{xhost1.ibm.com "" ,2809}} -addEndpoints {{xhost2.ibm.com "" ,2809}}} 
    -removeEndpoints {{xhost3.ibm.com}}}
  • Uso de 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 ejemplo de modalidad interactiva
  • Uso de Jacl:
    $AdminTask modifyXSDomain {-interactive}
  • Uso de la serie de Jython:
    AdminTask.modifyXSDomain ('[-interactive]')

testXSDomainConnection

El mandato testXSDomainConnection prueba la conexión con 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
  • Uso de Jacl:
    $Admintask testXSDomainConnection
  • Uso de la serie de Jython:
    AdminTask.testXSDomainConnection
Uso de ejemplo de modalidad interactiva
  • Uso de Jacl:
    $AdminTask testXSDomainConnection {-interactive}
  • Uso de la serie de Jython:
    AdminTask.testXSDomainConnection ('[-interactive]')

testXSServerConnection

El mandato testXSServerConnection prueba la conexión con 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 cantidad máxima de tiempo de espera de una conexión con el servidor de catálogo, en segundos.

Valor de retorno:

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