Modifying Server Properties for Java CAPS JBI Components in a Cluster

Once you have added a Java CAPS JBI component to a cluster, you can update the runtime properties, update the application configuration (including adding variables), view the component descriptor, set logging levels, and monitor the component. You must perform these tasks on the GlassFish Admin Console, and you need to update the configuration for each instance of that component in the cluster. Configuring runtime properties in NetBeans will not work for the cluster.

Each time you add a new instance to a cluster, you need to configure the server properties of all components on the cluster for the new instance. If you uninstall and reinstall a component or drop it from the cluster and add it back in, you need to reconfigure the component as well.

Before you perform any of these tasks, make sure the component is enabled on the cluster. Do the following to enable the cluster:

1. On the GlassFish Admin Console, expand JBI and then expand Components.

2. Select the name of the service engine or binding component to modify. For example, to modify the IEP SE runtime properties, select sun-iep-engine.

3. Click the Targets tab.

4. In the Targets list, select the check box next to the cluster and then click Start.

To Modify Runtime Properties for a Component in a Cluster

1. On the GlassFish Admin Console, expand JBI and then expand Components.

2. Select the name of the component to configure.

3. Click the Configuration tab.

4. In the View/Update Instance field, select the first instance to configure.

5. Modify any of the runtime properties.

   The runtime properties for each component are described in that component's user guide.

6. Click Save.

7. Repeat the above steps for each instance in the cluster, selecting a different instance each time until all instances are configured.

   ---

   Caution –

   When updating properties for a component that uses a persistence database, such as the BPEL SE, IEP SE, or Database BC, be sure that all instances of that component point to the JDBC resource for the same persistence database.

   ---

To Create Application Configurations and Variables for a Component in a Cluster

Not all components support application configurations or application variables. For example, the Data Mashup SE is the only service engine that supports configurations and variables.

1. On the GlassFish Admin Console, expand JBI and then expand Components.

2. Select the name of the component to configure.

3. Click the Application tab.

4. To add a new configuration definition, do the following:

   1. In the View/Update Instance field, select the first instance to configure.

   2. Click Add Configuration.

   3. In the Identification section, enter a name for the configuration.

   4. Enter values for any of the displayed properties.

   5. Click Save.

   6. Repeat the above steps for each instance in the cluster, selecting a different instance each time until all instances are configured.

      ---

      Caution –

      When updating properties for a component that uses a persistence database, such as the BPEL SE, IEP SE, or Database BC, be sure that all instances of that component point to the JDBC resource for the same persistence database.

      ---

5. To add a variable, do the following:

   1. Click the Variables sub-tab.

   2. In the View/update Instance field, select the first instance to configure.

   3. Click Add Variable.

   4. Enter a Name, Type, and Value for the variable.

   5. Click Save.

   6. Repeat the above steps for each instance in the cluster, selecting a different instance each time until all instances are configured.

To View the Descriptor for a Component in a Cluster

1. On the GlassFish Admin Console, expand JBI and then expand Components.

2. Select the name of the component to configure.

3. Click the Descriptor tab.

4. Review the displayed information.

To Set Logging Properties for a Component in a Cluster

1. On the GlassFish Admin Console, expand JBI and then expand Components.

2. Select the name of the component to configure.

3. Click the Loggers tab.

4. In the View/Update Instance field, select the first instance to configure.

5. Select a new logging level for any of the displayed component loggers.

6. Click Save.

7. Repeat the above steps for each instance in the cluster, selecting a different instance each time until all instances are configured.

To Monitor a Component in a Cluster

1. On the GlassFish Admin Console, expand JBI and then expand Components.

2. Select the name of the component to Monitor.

3. Click the Monitoring tab.

4. In the View Instance field, select the instance to monitor.

5. View the statistics displayed for the component.

6. To view statistics for a different instance, select the instance from the View Instance field.