Mandato addSIBusMember
Utilice el mandato addSIBusMember para añadir un miembro a un bus de integración de servicios utilizando la herramienta wsadmin. Un miembro de bus puede ser un servidor de aplicaciones, un servidor WebSphere MQ o un clúster de servidores.
Para ejecutar el mandato, utilice el objeto AdminTask del cliente de scripts wsadmin.
El cliente de scripts wsadmin
se ejecuta desde Qshell.
Para obtener más información, consulte Configuración de Qshell para ejecutar scripts de WebSphere mediante el script wsadmin.
- Si desea una lista de los mandatos disponibles del bus de integración de servicios en Jyton y una breve descripción de cada mandato, especifique el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('SIBAdminCommands')
- Si desea ayuda general sobre un mandato determinado,
especifique el mandato siguiente en el indicador de wsadmin:
print AdminTask.help('nombre_mandato')
AdminConfig.save()
Objetivo
El mandato addSIBusMember añade un nuevo miembro a un bus de integración de servicios. Cuando un servidor de aplicaciones se añade como miembro de un bus, se crea automáticamente un motor de mensajería con los valores predeterminados.
Cuando un clúster se añade como miembro de un bus, si la asistencia para la política del motor de mensajería no está habilitada, se crea automáticamente un motor de mensajería con los valores predeterminados. Para crear un motor de mensajería adicional para un miembro del bus, utilice el mandato createSIBEngine.
Cuando un clúster se añade a un bus, si la asistencia para la política del motor de mensajería está habilitada y se especifica el tipo de política de motor de mensajería de alta disponibilidad, se crea automáticamente un motor de mensajería con valores que dan soporte a la política de alta disponibilidad.
Cuando un clúster se añade a un bus, si se especifica la asistencia para la política del motor de mensajería está habilitada y la escalabilidad o escalabilidad con alta disponibilidad, tipo de política de motor de mensajería, se crea automáticamente un motor de mensajería con valores que dan soporte a la política seleccionada. Entonces deberá utilizar el mandato createSIBEngine para crear motores de mensajería adicionales (uno para cada servidor de aplicaciones del clúster). Para cada nuevo motor de mensajería, se crean automáticamente los valores que dan soporte a la política seleccionada.
Si utiliza el mandato addSIBusMember con la asistencia para la política del motor de mensajería habilitada y se ha especificado el tipo de política de motor de mensajería personalizado, puede establecer el comportamiento para el primer motor de mensajería y, a continuación, utilice el mandato createSIBEngine para crear motores de mensajería adicionales.
Cuando se añade un servidor WebSphere MQ como un miembro de un bus, se crea un servidor proxy que puede alterar temporalmente las propiedades de la conexión padre (host, puerto, canal y alias de configuración de seguridad SSL) definidas en el servidor WebSphere MQ. Gracias a ello se podrá asignar un conjunto diferente de propiedades de conexión a cada miembro del bus.
Objeto de destino
Ninguno.
Se crea un objeto de miembro de bus. Si el miembro de bus es un servidor o un clúster de servidores, también se crea un motor de mensajería.
Parámetros necesarios
- -bus nombre_bus
- El nombre mediante el que se conoce el bus de integración de servicios. Puede utilizar el mandato listSIBuses para listar los nombres de los buses existentes.
Parámetros condicionales
- -node nombre_nodo
- -server nombre_servidor
- Para añadir un servidor de aplicaciones como miembro de bus, especifique el nombre y el nodo en el que se ejecuta el servidor, y el nombre del servidor.
Si especifica estos parámetros, no especifique los parámetros -cluster o -wmqServer.
- -cluster nombre_clúster
- Para añadir un clúster de servidor como miembro de bus, especifique el nombre del clúster.
Si especifica estos parámetros, no especifique los parámetros -node, -server, o -wmqServer.
- -wmqServer
- Para añadir un servidor WebSphere MQ
como un miembro de bus, especifique el nombre del servidor WebSphere MQ. Éste es el nombre que se ha especificado en el parámetro -name cuando se ha creado el servidor WebSphere MQ.
Si especifica este parámetro, no especifique los parámetros -cluster, -node o -server.
Parámetros opcionales
- -description texto
- Una descripción opcional del miembro de bus, para fines administrativos.
- -virtualQueueManagerName
- El valor de alteración temporal para el nombre del gestor de colas virtual del servidor WebSphere MQ. Cuando se envían mensajes a IBM MQ, el gestor de cola de pasarela
IBM MQ ve el bus como un gestor de colas remoto. El nombre del gestor de colas virtual es el nombre que se pasa a
IBM MQ
como nombre de ese gestor de colas remoto. El valor predeterminado es el nombre de bus. Si este valor no es un nombre
válido para un gestor de colas
IBM MQ o si ya existe otro gestor de colas
IBM MQ con el mismo nombre,
sustituya el valor predeterminado por otro valor que sea un nombres exclusivo y válido para un gestor de colas
IBM MQ. Para que sea válido, el nombre debe cumplir los criterios siguientes:
- Debe contener entre 1 y 48 caracteres.
- Debe cumplir con las reglas de denominación de colas de IBM MQ (consulte el tema Reglas para la denominación de objetos de IBM MQ en el centro de información de IBM MQ).
- -host
- El valor de alteración temporal para el atributo del host del miembro de bus del servidor WebSphere MQ. Este valor es el nombre de host o la dirección IP del host con el que se establece una conexión para la comunicación con un gestor de colas o un grupo de compartición de colas. Utilice este parámetro si se especifica el parámetro -wmqServer.
- -port
- El valor de alteración temporal para el atributo del puerto del miembro de bus del servidor WebSphere MQ. El número del puerto que es supervisado por un escucha del gestor de colas o un escucha del grupo que comparte colas, que está a la escucha de las conexiones. El valor predeterminado es 1414. Utilice este parámetro si se especifica el parámetro -wmqServer.
- -channel
- El valor de alteración temporal para el atributo del canal del miembro de bus del servidor WebSphere MQ. Éste es el nombre del canal de conexión del servidor utilizado para establecer una conexión con el gestor de colas IBM MQ o el grupo de compartimiento de colas IBM MQ for z/OS. El valor predeterminado es SYSTEM.DEF.SVRCONN. Utilice este parámetro si se especifica el parámetro -wmqServer.
- -securityAuthAlias
- El valor de alteración temporal para el atributo securityAuthAlias del miembro de bus del servidor WebSphere MQ. Éste es el alias de autenticación proporcionado al conectarse al servidor WebSphere MQ. Este parámetro no tiene ningún valor predeterminado. Utilice este parámetro si se especifica el parámetro -wmqServer.
- -transportChain
- El valor de alteración temporal para el atributo transportChain del miembro de bus del servidor WebSphere MQ. Éste es el nombre de la cadena de transporte que se debe utilizar al comunicarse con IBM MQ. El valor predeterminado es OutboundBasicWMQClient. Utilice este parámetro si se especifica el parámetro -wmqServer.
- -trustUserIds TRUE | FALSE
- El valor de alteración temporal para el atributo trustUserIds del miembro de bus del servidor WebSphere MQ. Esto determina si los ID de usuario que se reciben en los mensajes procedentes de IBM MQ se propagan en los mensajes. El ID de usuario de aplicación se establece siempre a partir del valor RFH2 de jsAppUserId. Si no está presente (ya sea porque el par clave/valor no está presente en la carpeta <sib> de la cabecera RFH2 o bien porque el mensaje no tiene una cabecera RFH2), este campo no se establecerá. Este parámetro tiene dos valores posibles:
- TRUE
- Los ID usuario se propagan en los mensajes.
- FALSE
- Los ID usuario no se propagan en los mensajes.
El valor predeterminado es TRUE. Utilice este parámetro si se especifica el parámetro -wmqServer.
- -enableAssistance TRUE | FALSE
- Un parámetro que especifica si se debe habilitar la asistencia para la política del motor de mensajería. Este parámetro tiene dos valores posibles:
- TRUE
- La asistencia para la política del motor de mensajería está habilitada. Debe proporcionar un parámetro -policyName.
- FALSE
- La asistencia para la política del motor de mensajería no está habilitada. Éste es valor predeterminado. Utilice este parámetro si se especifica el parámetro -cluster.
- -policyName HA | SCALABILITY | SCALABILITY_HA | CUSTOM
- El tipo de política de motor de mensajería que se debe aplicar en el clúster. Este parámetro tiene cuatro valores posibles:
- HA
- Aplicar la política del motor de mensajería de alta disponibilidad en el clúster.
- SCALABILITY
- Aplicar la política del motor de mensajería de escalabilidad en el clúster.
- SCALABILITY_HA
- Aplicar la escalabilidad con la política del motor de mensajería de alta disponibilidad en el clúster.
- CUSTOM
- Aplicar la política de motor de mensajería personalizado en el clúster.
Este parámetro no tiene ningún valor predeterminado. Utilice este parámetro si se especifica el parámetro -cluster y el parámetro -enableAssistance se ha establecido en TRUE.
- -failover TRUE | FALSE
- Un parámetro que especifica si el motor de mensajería del clúster puede realizar una migración tras error en otro servidor del clúster, si el servidor del host para el motor de mensajería falla. Este parámetro tiene dos valores posibles:
- TRUE
- El motor de mensajería realizará la migración tras error.
- FALSE
- El motor de mensajería no puede realizar la migración tras error.
El valor predeterminado es FALSE. Utilice este parámetro si se ha especificado el parámetro -cluster y si se ha establecido el parámetro -enableAssistance en TRUE y el parámetro -policyName en CUSTOM.
- -failback TRUE | FALSE
- Un parámetro que especifica si el motor de mensajería del clúster que ha realizado una migración tras error puede invertir este proceso en otro servidor con mayor preferencia de la lista de servidores preferidos si dicho servidor vuelve a estar disponible.
Este parámetro tiene dos valores posibles:
- TRUE
- El motor de mensajería puede invertir la migración. Si utiliza esta opción, proporcione un parámetro -preferredServerList.
- FALSE
- El motor de mensajería no puede invertir la migración.
El valor predeterminado es FALSE. Utilice este parámetro si se ha especificado el parámetro -cluster y si se ha establecido el parámetro -enableAssistance en TRUE y el parámetro -policyName en CUSTOM.
- -preferredServersOnly TRUE | FALSE
- Un parámetro que especifica si el motor de mensajería del clúster sólo se debe ejecutar en servidores de la lista de servidores preferidos, o en cualquier servidor del clúster. Este parámetro tiene dos valores posibles:
- TRUE
- El motor de mensajería sólo puede ejecutarse en servidores de la lista de servidores preferidos. Si utiliza esta opción, proporcione un parámetro -preferredServerList.
- FALSE
- El motor de mensajería se puede ejecutar en cualquier servidor del clúster.
El valor predeterminado es FALSE. Utilice este parámetro si se ha especificado el parámetro -cluster y si se ha establecido el parámetro -enableAssistance en TRUE y el parámetro -policyName en CUSTOM.
- -preferredServerList {{nombre_nodo nombre_servidor}}
- La lista de servidores, en orden de prioridad, en los que prefiere ejecutarse el motor de mensajería del clúster. Para cada servidor de la lista, especifique el nombre del nodo en el que se ejecuta el servidor y el nombre del servidor. No hay ningún valor predeterminado para este parámetro. Utilice este parámetro si se ha especificado el parámetro -cluster y si se ha establecido el parámetro -enableAssistance en TRUE y el parámetro -policyName en CUSTOM.
- -fileStore
- Cree un almacén de archivos para utilizarlo como un almacén de mensajes para el motor de mensajería. Un almacén de archivos es un tipo de almacén de mensajes que utiliza directamente archivos de un sistema de archivos a través del sistema operativo. la alternativa es utilizar un almacén de datos. Para obtener más información, consulte los enlaces relacionados.
- -logSize tamaño_anotación
- El tamaño del archivo de registro en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
- -logDirectory nombre_directorio_registro
- El nombre del directorio de archivos de registro, en caso de que no desee utilizar el directorio de registro predeterminado. Utilice este parámetro si se especifica el parámetro -fileStore.
- -minPermanentStoreSize tamaño_mínimo_almacén_permanente
- El tamaño mínimo del archivo del almacén permanente en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
- -minTemporaryStoreSize tamaño_mínimo_almacén_temporal
- El tamaño mínimo del archivo del almacén temporal en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
- -maxPermanentStoreSize tamaño_máximo_almacén_permanente
- El tamaño máximo del archivo del almacén permanente en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
- -maxTemporaryStoreSize tamaño_máximo_almacén_temporal
- El tamaño máximo del archivo del almacén temporal en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
- -unlimitedPermanentStoreSize TRUE | FALSE
- Un parámetro que especifica si el tamaño del almacén permanente es ilimitado. Este parámetro tiene dos valores posibles:
- TRUE
- El tamaño del almacén permanente es ilimitado.
- FALSE
- El tamaño del almacén permanente es limitado. Si utiliza esta opción, proporcione un parámetro -maxPermanentStoreSize.
Utilice este parámetro si se especifica el parámetro -fileStore.
- -unlimitedTemporaryStoreSize TRUE | FALSE
- Un parámetro que especifica si el tamaño del almacén temporal es ilimitado. Este parámetro tiene dos valores posibles:
- TRUE
- El tamaño del almacén temporal es ilimitado.
- FALSE
- El tamaño del almacén temporal es limitado. Si utiliza esta opción, proporcione un parámetro -maxTemporaryStoreSize.
Utilice este parámetro si se especifica el parámetro -fileStore.
- -permanentStoreDirectory nombre_directorio_almacén_permanente
- El nombre del directorio del almacén permanente si no desea utilizar el directorio del almacén permanente predeterminado. Utilice este parámetro si se especifica el parámetro -fileStore.
- -temporaryStoreDirectory nombre_directorio_almacén_temporal
- El nombre del directorio del almacén temporal si no desea utilizar el directorio del almacén temporal predeterminado. Utilice este parámetro si se especifica el parámetro -fileStore.
- -dataStore
- Cree un almacén de datos para utilizarlo como un almacén de mensajes para el motor de mensajería.
Un almacén de datos consta de un conjunto de tablas que un motor de mensajería utiliza para almacenar datos persistentes en una base de datos.Consulte Tablas de almacén de datos para obtener una lista de las tablas que forman un almacén de datos. Todas las tablas de un almacén de datos se conservan en el mismo esquema de base de datos. Puede crear varios almacenes de datos en la misma base de datos, siempre que utilice un nombre de esquema diferente para cada almacén de datos.
La alternativa es utilizar un almacén de archivos (el valor predeterminado). Para obtener más información, consulte los enlaces relacionados. - -createDefaultDatasource TRUE | FALSE
- Un parámetro que especifica si se debe crear un origen de datos predeterminado cuando se crea el motor de mensajería. Este parámetro tiene dos valores posibles:
- TRUE
- Crear un origen de datos predeterminado.
- FALSE
- No crear un origen de datos predeterminado.
Utilice este parámetro si se especifica el parámetro -dataStore. No utilice este parámetro si se especifica el parámetro -cluster.
- -datasourceJndiName nombre_jndi
- El nombre JNDI del origen de datos que utiliza el motor de mensajería para acceder al sistema de gestión de bases de datos relacionales (RDBMS) del almacén de datos. Utilice este parámetro si se especifica el parámetro -dataStore.
- -authAlias alias_auten
- El nombre del alias de autenticación que el motor de mensajería utiliza para conectarse a la base de datos de su almacén de datos. Utilice este parámetro si se especifica el parámetro -dataStore.
- -createTables origen_datos
- Crear automáticamente las tablas de base de datos para el origen de datos especificado. Si esta opción no se especifica, el administrador de base de datos debe crear las tablas. Utilice este parámetro si se especifica el parámetro -dataStore.
- -restrictLongDBLock TRUE | FALSE
- Parámetro que especifica si el motor de mensajería debe mantener bloqueos de larga ejecución
en la tabla SIBOWNER de la base de datos. Cuando se selecciona esta opción, el motor de mensajería
establece un bloqueo en la base de datos sólo por períodos breves. En el caso de que el motor de mensajería
activo no responda a la base de datos, estará disponible el motor de mensajería en espera
para hacerse con la base de datos porque el motor de mensajería activo
solo mantiene bloqueos de breve duración. Este parámetro tiene dos valores posibles:
- TRUE
- Restrinja los bloqueos de larga ejecución en la base de datos.
- FALSE
- No restrinja los bloqueos de larga ejecución en la base de datos.
Utilice este parámetro si se especifica el parámetro -dataStore.
Importante: Aunque la propiedad está seleccionada, la propiedad no entrará en vigor hasta que las tablas de base de datos se actualicen utilizando el mandato sibDBUpgrade para WebSphere Application Server Versión 9.0 y posteriores. - -schemaName nombre_esquema
- El nombre del esquema de base de datos que contiene las tablas para el almacén de datos, si no desea utilizar el nombre de esquema predeterminado. Si desea detalles sobre el esquema predeterminado, consulte Creación de usuarios y esquemas de la base de datos. Utilice este parámetro si se especifica el parámetro -dataStore.
- -initialHeapSize tamaño
- El tamaño del almacenamiento dinámico inicial de la máquina virtual Java™ (JVM), en megabytes, del servidor o de cada uno de los servidores del clúster.
No hay ningún valor predeterminado. Si no se especifica este parámetro, no se realiza ningún cambio. Si se especifica este parámetro, el valor proporcionado debe ser mayor o igual que cero y menor o igual que 2048.
Si el parámetro se proporciona sin ningún valor, se genera un mensaje de error.
Nota: Este parámetro se ignora si el servidor que es el sujeto del mandato addSIBusMember se ejecuta en z/OS, o si el sujeto es un clúster, cualquier servidor del clúster se ejecuta en z/OS.
- -maxHeapSize tamaño
- El tamaño de almacenamiento dinámico máximo de la JVM, en megabytes, del servidor o de cada uno de los servidores de un clúster. No hay ningún valor predeterminado. Si no se especifica este parámetro, no se realiza ningún cambio. Si se especifica este parámetro, el valor proporcionado debe ser mayor o igual que cero y menor o igual que 2048. Si el parámetro se proporciona sin ningún valor, se genera un mensaje de error.
Nota: Este parámetro se ignora si el servidor que es el sujeto del mandato addSIBusMember se ejecuta en z/OS, o si el sujeto es un clúster, cualquier servidor del clúster se ejecuta en z/OS.
Ejemplos
Añada un server1 en node1 como miembro de bus1 con un almacén de archivos predeterminado.
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 ]')
Añada el server1 como miembro de bus1, y utilice un almacén de archivos para guardar los mensajes.
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore ]')
Añada el server1 como miembro de bus1, y utilice un almacén de archivos para guardar los mensajes, con opciones.
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -fileStore
-logSize 100 -logDirectory C:\\filestore1 ]')
Añada el server1 como miembro de bus1, y utilice un almacén de datos para guardar los mensajes.
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore ]')
Añada el server1 como miembro de bus1, y utilice un almacén de datos para guardar los mensajes, con opciones.
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1 -dataStore
-createDefaultDatasource true -datasourceJndiName myjndi]')
Añada el cluster1 a bus1 sin utilizar la asistencia para la política del motor de mensajería y utilice un almacén de archivos para el motor de mensajería.
AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -fileStore true
-logDirectory C:\\filestore1 -permanentStoreDirectory C:\\filestore2
-temporaryStoreDirectory C:\\filestore3]')
Añada el cluster1 a bus1 y utilice la asistencia para la política del motor de mensajería y la política del motor de mensajería de alta disponibilidad. Utilice un almacén de archivos como almacén de mensajes para el motor de mensajería.
AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -enableAssistance true
-policyName HA -fileStore -permanentStoreDirectory C:\\filestore1
-temporaryStoreDirectory C:\\filestore1 -logDirectory C:\\filestore1 ]')
Añada el cluster1 a bus1 y utilice la asistencia para la política del motor de mensajería y la política del motor de mensajería personalizado. Utilice un almacén de archivos como almacén de mensajes para el motor de mensajería. Establezca el motor de mensajería de modo que pueda realizar la migración tras error, no invertirla, y que sólo se ejecute en server1 y server2.
AdminTask.addSIBusMember('[-bus bus1 -cluster cluster1 -enableAssistance true
-policyName CUSTOM -fileStore -permanentStoreDirectory C:\\filestore1
-temporaryStoreDirectory C:\\filestore1 -logDirectory C:\\temp\filestore
-failover true -failback false -preferredServersOnly true
-preferredServerList [[node1 server1] [node2 server2]]]')
Cambie el tamaño inicial del almacenamiento dinámico de JVM a 256 y el tamaño máximo del almacenamiento dinámico de JVM a 512.
![[AIX Solaris HP-UX Linux Windows]](../images/dist.gif)
![[IBM i]](../images/iseries.gif)
AdminTask.addSIBusMember('[-bus bus1 -node node1 -server server1
-initialHeapSize 256 -maxHeapSize 512]')