Mandato createSIBEngine
Utilice el mandato createSIBEngine para crear un motor de mensajería para un miembro de bus de servidor o de clúster utilizando la herramienta wsadmin. Al añadir un servidor o clúster como un miembro de un bus de integración de servicios, como mínimo, se crea un motor de mensajería automáticamente. Utilice el mandato createSIBEngine para crear un motor de mensajería adicional para un miembro de bus de clúster.
Cada miembro de bus del servidor tiene exactamente un motor de mensajería, pero los miembros de bus del clúster pueden soportar motores adicionales. Si crea un motor de mensajería adicional para un clúster y utiliza un almacén de datos para el almacén de mensajes, debe configurar de forma explícita tanto el almacén de datos como el origen de datos JDBC que el motor de mensajería utiliza para interactuar con el almacén de datos. Debe crear el origen de datos en el ámbito del clúster, no en el ámbito del nodo. Para obtener más información sobre la creación de motores de mensajería, consulte Configuración de un origen de datos para un motor de mensajería que se ejecuta en un clúster.
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 createSIBEngine crea un nuevo motor de mensajería para un miembro de bus del servidor o clúster. Utilice este mandato para crear un motor de mensajería adicional para un miembro de bus del clúster.
Si el clúster tiene habilitada la asistencia para la política del motor de mensajería y se ha especificado la política de escalabilidad o de escalabilidad con alta disponibilidad, los valores del motor de mensajería se crean automáticamente de modo que se ajusten con la política especificada.
Después de utilizar este mandato, si el clúster tiene la asistencia para la política del motor de mensajería habilitada y la política personalizada especificada, puede crear una política de grupo principal para un motor de mensajería utilizando el mandato createMissingSIBEnginePolicy.
Objeto de destino
Ninguno.
Parámetros necesarios
- -bus nombre_bus
- El nombre del bus de integración de servicios en el que está configurado el miembro del bus. Puede utilizar el mandato listSIBuses para listar los nombres de los buses existentes.
Parámetros condicionales
- -node nombre_nodo
- -server nombre_servidor
- Para crear un motor de mensajería para un servidor que es un miembro del bus, especifique el nombre del nodo en el que se ejecuta el servidor y el nombre del servidor.
- -cluster nombre_clúster
- Para crear un motor de mensajería para un clúster de servidores que sea un miembro del bus, especifique el nombre del clúster.
Parámetros opcionales
- -description texto
- Descripción opcional del motor de mensajería, a efectos administrativos.
- -initialState STARTED | STOPPED
- El estado inicial determina si el motor de mensajería se inicia automáticamente cuando se inicia el servidor o el clúster de servidores.
- STARTED
- Cuando se inicia el servidor de aplicaciones asociado, el motor de mensajería se inicia y queda disponible para procesar mensajes.
- STOPPED
- Cuando se inicia el servidor de aplicaciones asociado, se detiene el motor de mensajería y deja de estar disponible para procesar mensajes.
- -highMessageThreshold número
- El número máximo total de mensajes que el motor de mensajería puede colocar en sus puntos de mensaje.
Cuando se crea el motor de mensajería, se utiliza el umbral alto de mensajes del bus para establecer el valor predeterminado para esta propiedad. Cuando se crea un punto de mensaje en este motor de mensajería, el valor de esta propiedad se utiliza para establecer el umbral alto de mensajes predeterminado para el punto de mensaje.
- -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 el clúster tiene habilitada la asistencia para la política del motor de mensajería y se ha especificado la política personalizada. Para hacerlo, utilice los mandatos addSIBusMember o modifySIBusMemberPolicy.
- -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 el clúster tiene habilitada la asistencia para la política del motor de mensajería y se ha establecido la política personalizada. Para hacerlo, utilice los mandatos addSIBusMember o modifySIBusMemberPolicy.
- -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 el clúster tiene habilitada la asistencia para la política del motor de mensajería y se ha establecido la política personalizada. Para hacerlo, utilice los mandatos addSIBusMember o modifySIBusMemberPolicy.
- -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 el clúster tiene habilitada la asistencia para la política del motor de mensajería y se ha establecido la política personalizada. Para hacerlo, utilice los mandatos addSIBusMember o modifySIBusMemberPolicy.
- -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
- El tamaño del archivo de registro en MB. Utilice este parámetro si se especifica el parámetro -fileStore.
- -logDirectory nombre_directorio
- 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
- 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
- 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
- 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
- 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
- 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
- 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_autorización
- 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 TRUE | FALSE
- Un parámetro que especifica si se han de crear automáticamente las tablas de base de datos para el origen de datos. Este parámetro tiene dos valores posibles:
- TRUE
- Crear las tablas de base de datos para el origen de datos.
- FALSE
No crear las tablas de base de datos para el origen de datos. Si utiliza esta opción, el administrador de base de datos deberá crear las tablas.
No crear las tablas de base de datos para el origen de datos. Para el sistema operativo z/OS, debe utilizar esta opción porque no 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.
Dependiendo de las opciones del almacén de mensajes y sus atributos, especifique diferentes combinaciones de los parámetros. Para evitar errores cuando especifique el almacén de mensajes para el motor de mensajería, consulte Cómo evitar que se produzcan errores al crear un motor de mensajería con un almacén de archivos o un almacén de datos utilizando la herramienta wsadmin.
Ejemplos
Cree un motor de mensajería para el cluster1 en el bus1 que utiliza un almacén de archivos predeterminado.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1]')
Cree un motor de mensajería para el cluster1 en el bus1 que utiliza un almacén de archivos con los valores predeterminados.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -fileStore]')
Cree un motor de mensajería para el cluster1 en el bus1 que utiliza un almacén de archivos con opciones.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -fileStore
-logSize 3636363 -logDirectory C:\mylogdirectory]')
Cree un motor de mensajería para el cluster1 en el bus1 que utiliza un almacén de datos con los valores predeterminados.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -dataStore]')
Cree un motor de mensajería para el cluster1 en el bus1 que utiliza un almacén de datos con opciones.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -dataStore
-createDefaultDatasource true -datasourceJndiName myjndi]')
Añadir un nuevo motor de mensajería a cluster1 que es miembro de bus1 y que utiliza un almacén de archivos como almacén de mensajes para el motor de mensajería.
AdminTask.createSIBEngine('[-bus bus1 -cluster cluster1 -fileStore true
-logSize 100 -minPermanentStoreSize 200 -maxPermanentStoreSize 500
-unlimitedPermanentStoreSize false -permanentStoreDirectory C:\myfilestore
-minTemporaryStoreSize 200 -maxTemporaryStoreSize 500
-unlimitedTemporaryStoreSize false -temporaryStoreDirectory C:\myfilestore
-logDirectory C:\myfilestore ]')
Añada un nuevo motor de mensajería en el cluster1 que es miembro del bus1, donde el cluster1 tiene la asistencia para la política del motor de mensajería habilitada y la política personalizada del motor de mensajería especificada. 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.createSIBEngine('[-bus bus1 -cluster cluster1 -fileStore true
-logSize 100 -minPermanentStoreSize 200 -maxPermanentStoreSize 500
-unlimitedPermanentStoreSize false -permanentStoreDirectory C:\myfilestore
-minTemporaryStoreSize 200 -maxTemporaryStoreSize 500
-unlimitedTemporaryStoreSize false -temporaryStoreDirectory C:\myfilestore
-logDirectory C:\myfilestore -failover true -failback false
-preferredServersOnly true -preferredServerList [[node1 server1] [node2 server2]]]')