createSIBEngine command
Use the createSIBEngine command to create a messaging engine for a server or cluster bus member by using the wsadmin tool. When you add a server or a cluster as a member of a service integration bus, at least one messaging engine is created automatically. Use the createSIBEngine command to create an additional messaging engine for a cluster bus member.
Each server bus member has exactly one messaging engine, but cluster bus members can support additional engines. If you create an additional messaging engine for a cluster, and you use a data store for the message store, you must explicitly configure both the data store and the JDBC data source that the messaging engine uses to interact with the data store. You must create the data source at cluster scope, not node scope. For more information about creating messaging engines, see Configurando uma Origem de Dados para o Mecanismo do Sistema de Mensagens em um Cluster.
Para executar o comando, utilize o objeto AdminTask do cliente de script wsadmin.
O cliente de script wsadmin é executado do Qshell.
Para obter informações adicionais, consulte Configurando o Qshell para Executar Scripts do WebSphere Usando o Script wsadmin.
- Para obter uma lista dos comandos de barramento de integração de
serviços disponíveis no Jython e uma breve descrição de cada comando, digite o seguinte
comando no prompt wsadmin:
print AdminTask.help('SIBAdminCommands')
- Para obter ajuda de visão geral sobre um determinado comando, digite o seguinte comando no prompt wsadmin:
print AdminTask.help('command_name')
AdminConfig.save()
Purpose
The createSIBEngine command creates a new messaging engine for a server or cluster bus member. Use this command to create an additional messaging engine for a cluster bus member.
If the cluster has messaging engine policy assistance enabled and the scalability or scalability with high availability policy specified, the messaging engine settings are created automatically to conform with the specified policy.
After you use this command, if the cluster has messaging engine policy assistance enabled and the custom policy specified, you can create a core group policy for a messaging engine by using the createMissingSIBEnginePolicy command.
Target object
None.
Required parameters
- -bus bus_name
- The name of the service integration bus on which the bus member is configured. You can use the listSIBuses command to list the names of existing buses.
Conditional parameters
- -node node_name
- -server server_name
- To create a messaging engine for a server that is a bus member, specify both the name of the node on which the server runs, and the name of the server.
- -cluster cluster_name
- To create a messaging engine for a server cluster that is a bus member, specify the name of the cluster.
Optional parameters
- -description text
- An optional description for the messaging engine, for administrative purposes.
- -initialState STARTED | STOPPED
- The initial state determines whether the messaging engine is started
automatically when the server or server cluster is started.
- STARTED
- Quando o servidor de aplicativos associado é iniciado, o mecanismo do sistema de mensagens é iniciado e disponibilizada para processar mensagens.
- STOPPED
- Quando o servidor de aplicativos associado é iniciado, o mecanismo do sistema de mensagens é parado e não fica disponível para processar mensagens.
- -highMessageThreshold number
- The maximum total number of messages that the messaging engine
can place on its message points.
When the messaging engine is created, the high message threshold of the bus is used to set the default value for this property. When a message point is created on this messaging engine, the value of this property is used to set the default high message threshold for the message point.
- -failover TRUE | FALSE
- A parameter that specifies whether the messaging engine in the
cluster can fail over to another server in the cluster if the host
server for the messaging engine fails. This parameter has two possible
values:
- TRUE
- The messaging engine can fail over.
- FALSE
- The messaging engine cannot fail over.
The default value is FALSE. Use this parameter if the cluster has messaging engine policy assistance enabled and the custom policy specified. To do this, use the addSIBusMember or modifySIBusMemberPolicy commands.
- -failback TRUE | FALSE
- A parameter that specifies whether the messaging engine in the
cluster that has failed over can fail back to a more preferred server
in the preferred servers list if that server becomes available again.
This parameter has two possible values:
- TRUE
- The messaging engine can fail back. If you use this option, supply a -preferredServerList parameter.
- FALSE
- The messaging engine cannot fail back.
The default value is FALSE. Use this parameter if the cluster has messaging engine policy assistance enabled and the custom policy set. To do this, you use the addSIBusMember or modifySIBusMemberPolicy commands.
- -preferredServersOnly TRUE | FALSE
- A parameter that specifies whether the messaging engine in the
cluster can run only on servers in the preferred servers list, or
on any server in the cluster. This parameter has two possible values:
- TRUE
- The messaging engine can run only on servers in the preferred servers list. If you use this option, supply a -preferredServerList parameter.
- FALSE
- The messaging engine can run on any server in the cluster.
The default value is FALSE. Use this parameter if the cluster has messaging engine policy assistance enabled and the custom policy set. To do this, use the addSIBusMember or modifySIBusMemberPolicy commands.
- -preferredServerList {{node_name server_name}}
- The list of servers, in order of preference, on which the messaging engine in the cluster prefers to run. For each server in the list, specify both the name of the node on which the server runs, and the name of the server. There is no default value for this parameter. Use this parameter if the cluster has messaging engine policy assistance enabled and the custom policy set. To do this, use the addSIBusMember or modifySIBusMemberPolicy commands.
- -fileStore
- Create a file store to use as a message store for the messaging engine. Um armazém de arquivos é um tipo de armazenamento de mensagem que usa diretamente os arquivos em um sistema de arquivos por meio do sistema operacional. The alternative is to use a data store. For more information, see the related links.
- -logSize size
- The size of the log file in MB. Use this parameter if the -fileStore parameter is specified.
- -logDirectory directory_name
- The name of the log file directory if you do not want to use the default log directory. Use this parameter if the -fileStore parameter is specified.
- -minPermanentStoreSize size
- The minimum size of the permanent store file in MB. Use this parameter if the -fileStore parameter is specified.
- -minTemporaryStoreSize size
- The minimum size of the temporary store file in MB. Use this parameter if the -fileStore parameter is specified.
- -maxPermanentStoreSize size
- The maximum size of the permanent store file in MB. Use this parameter if the -fileStore parameter is specified.
- -maxTemporaryStoreSize size
- The maximum size of the temporary store file in MB. Use this parameter if the -fileStore parameter is specified.
- -unlimitedPermanentStoreSize TRUE | FALSE
- A parameter that specifies whether the permanent store size is
unlimited. This parameter has two possible values:
- TRUE
- The permanent store size is unlimited.
- FALSE
- The permanent store size is limited. If you use this option, supply a -maxPermanentStoreSize parameter.
Use this parameter if the -fileStore parameter is specified.
- -unlimitedTemporaryStoreSize TRUE | FALSE
- A parameter that specifies whether the temporary store size is
unlimited. This parameter has two possible values:
- TRUE
- The temporary store size is unlimited.
- FALSE
- The temporary store size is limited. If you use this option, supply a -maxTemporaryStoreSize parameter.
Use this parameter if the -fileStore parameter is specified.
- -permanentStoreDirectory directory_name
- The name of the permanent store directory if you do not want to use the default permanent store directory. Use this parameter if the -fileStore parameter is specified.
- -temporaryStoreDirectory directory_name
- The name of the temporary store directory if you do not want to use the default temporary store directory. Use this parameter if the -fileStore parameter is specified.
- -dataStore
- Create a data store to use as a message store for the messaging
engine.
Um armazém de dados consiste no conjunto de tabelas que um mecanismo do sistema de mensagens utiliza para armazenar dados persistentes em um banco de dados. Consulte Tabelas de Armazenamento de Dados para obter uma lista de tabelas que abrangem um armazém de dados. Todas as tabelas em um armazém de dados são mantidas no mesmo esquema do banco de dados. É possível criar múltiplos armazéns de dados no mesmo banco de dados, contanto que use um nome de esquema diferente para cada armazém de dados.
The alternative is to use file store (the default). For more information, see the related links. - -createDefaultDatasource TRUE | FALSE
- A parameter that specifies whether to create a default data source
when the messaging engine is created. This parameter has two possible
values:
- TRUE
- Create a default data source.
- FALSE
- Do not create a default data source.
Use this parameter if the -dataStore parameter is specified. Do not use this parameter if the -cluster parameter is specified.
- -datasourceJndiName jndi_name
- The JNDI name of the data source that the messaging engine uses to access the relational database management system (RDBMS) for the data store. Use this parameter if the -dataStore parameter is specified.
- -authAlias auth_alias
- The name of the authentication alias that the messaging engine uses to connect to the database in its data store. Use this parameter if the -dataStore parameter is specified.
- -createTables TRUE | FALSE
- A parameter that specifies whether to create the database tables
for the data source automatically. This parameter has two possible
values:
- TRUE
- Create the database tables for the data source.
- FALSE
Do not create the database tables for the data source. If you use this option, the database administrator must create the tables.
Do not create the database tables for the data source. For the z/OS operating system, you must use this option because you must not create tables.
Use this parameter if the -dataStore parameter is specified.
- -restrictLongDBLock TRUE | FALSE
- A parameter that specifies whether the active messaging engine
must retain long running locks on the SIBOWNER table in the database.
When this option is selected, the messaging engine establishes a lock
over the database only for short durations. In the event of the active
messaging engine not responding to the database, the standby messaging
engine will be able to take ownership of the database because the
active messaging engine only holds short duration locks. This parameter
has two possible values:
- TRUE
- Restrict long running locks on the database.
- FALSE
- Do not restrict long running locks on the database.
Use this parameter if the -dataStore parameter is specified.
Important: Although the property is selected, the property will not be effective until the database tables are upgraded using the sibDBUpgrade command for WebSphere® Application Server Versão 9.0 and later. - -schemaName schema_name
- The name of the database schema that contains the tables for the data store, if you do not want to use the default schema name. For details about the default schema, see Criando Usuários e Esquemas no Banco de Dados. Use this parameter if the -dataStore parameter is specified.
Depending on the choice of the message store and its attributes, you specify different combinations of the parameters. To avoid errors when you specify the message store for the messaging engine, see Evitando Erros ao Criar um Mecanismo do Sistema de Mensagens com um Armazenamento de Arquivos ou um Armazenamento de Dados Por Meio da Ferramenta wsadmin.
Examples
Create a messaging engine for cluster1 on bus1 that uses a default file store.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1]')
Create a messaging engine for cluster1 on bus1 that uses a file store with defaults.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -fileStore]')
Create a messaging engine for cluster1 on bus1 that uses a file store with options.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -fileStore
-logSize 3636363 -logDirectory C:\mylogdirectory]')
Create a messaging engine for cluster1 on bus1 that uses a data store with defaults.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -dataStore]')
Create a messaging engine for cluster1 on bus1 that uses a data store with options.
AdminTask.createSIBEngine ('[-bus bus1 -cluster cluster1 -dataStore
-createDefaultDatasource true -datasourceJndiName myjndi]')
Add a new messaging engine to cluster1 that is a member of bus1 and that uses a file store as the message store for the messaging engine.
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 ]')
Add a new messaging engine to cluster1 that is a member of bus1, where cluster1 has messaging engine policy assistance enabled and the custom messaging engine policy specified. Use a file store as the message store for the messaging engine. Set the messaging engine to fail over, not to fail back, and to run only on server1 and 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]]]')