Add a cluster to a bus with a custom configuration
We can add a cluster as a member of a bus and use messaging engine policy assistance and the custom messaging engine policy. In this situation, messaging engine policy assistance helps create and configure messaging engines in a cluster that is a member of a bus when the predefined messaging engine policy types do not meet our needs. We can configure the messaging engine behavior, and the appropriate messaging engine policies are created automatically.
Ensure that we have defined the resources listed in Add a cluster as a member of a bus.
When we use the custom messaging engine policy, we can create any number of messaging engines for the cluster. For each messaging engine, specify the behavior that you require, such as whether it can fail over and whether it uses preferred servers. The core group policies and match criteria for each messaging engine are automatically created. Use this option when the other options of High availability, Scalability, or Scalability with high availability do not provide the messaging engine behavior you require, and we are familiar with creating messaging engines and configuring messaging engine policy settings.
We can optionally tune the initial and maximum JVM heap sizes. Tuning the heap sizes helps to ensure that application servers hosting one or more messaging engines are provided with an appropriate amount of memory for the message throughput you require.
If we are working in a mixed-version cell, a service integration bus running in this version of the product can only include WebSphere Application Server v6 bus members running in the following versions of the product:
- 6.0.2 (Fix Pack 23 or later)
- 6.1.0 (Fix Pack 13 or later)
If security is enabled, and the bus has mixed-version bus members, the bus members establish trust using an inter-engine authentication alias. If we add a server cluster as a bus member at WAS v6, and it is the first bus member at this level, select or create an authentication alias during this task. This action sets the inter-engine authentication alias.
Tasks
- In the navigation pane, click Service integration -> Buses -> bus_name -> [Topology] Bus members.
- Click Add to start the Add a new bus member wizard.
- In the first pane, select Cluster, and, from the drop-down list, select the cluster to make a member of the bus.
- In the Messaging engine policy assistance settings pane, ensure that the Enable messaging engine policy assistance check box is selected, and select Custom.
- Select the type of message store that we have already defined.
- In the Configure messaging engines pane, click Add to add and configure at least one messaging engine.
- In the Configure the messaging engine policy pane, use the options and the preferred servers list to set the messaging engine behavior you require. The messaging engine name is automatically generated, in the format cluster_name.nnn-bus_name.
- Enter details for the message store.
- If we use a file store, specify the directory paths for the log files, the permanent file store, and the temporary file store. Do not use the default path, and ensure that we use a unique path for each messaging engine.
- If we use a data store, specify the JNDI name of the data source that provides access to the database that holds the data store.
- Optional: In the Tune performance parameters pane, we can view the current settings of the initial and maximum Java Virtual Machine (JVM) heap sizes. To tune performance by changing the current settings, select the Change heap sizes check box and enter the required changes in the Proposed heap sizes fields.
- If security is enabled, and adding this cluster bus member creates a mixed-version bus, the wizard prompts for an authentication alias. Do one of the following:
- Select an existing authentication alias.
- Create a new authentication alias. Specify a unique alias name and password.
This action sets the inter-engine authentication alias.
- Optional: Repeat the steps to add and configure further messaging engines for the cluster.
- When the Add a new bus member wizard is finished, save our changes to the master configuration.
We have created a cluster bus member and at least one messaging engine, named cluster_name.nnn-bus_name. For each messaging engine, there is a core group policy named messaging_engine_name-numberPolicy. This core group policy is configured with the behavior we chose for the messaging engine policy, and is associated with the messaging engine through its match criteria.
What to do next
To see a diagram of the cluster and the messaging engine configuration we have created, click the bus member name in the Bus members collection pane.
Related:
Custom messaging engine policy Add a cluster to a bus for high availability or scalability Add a cluster to a bus without using messaging engine policy assistance Secure links between messaging engines Tune messaging performance with service integration Messaging engine policy maintenance [Collection]