You can use the ALSB MBeans in Java programs and WLST scripts to automate promotion of ALSB configurations from development environments through testing, staging, and finally to production environments. The ALSB MBeans you can use to programmatically perform deployment operations include:
The latter MBeans are interfaces in thepackage.
Numerous customization options can be applied during deployment. An extended list of environment variables allows you to preserve or tailor settings when moving from one environment to another.
This section contains the following topics:
|Tip:||ALSB APIs are documented in|
ALSB sessions allow different users to update discrete parts of configuration data without interfering with each other. A session is essentially a named sandbox, in which your changes are abstracted from other users, as well as from the core data (the data on which ALSB runs), until the changes are activated. In order to modify resources and ALSB configurations, you must create a session and perform changes in that session. The changes are only reflected in the core data when you activate the session. You can create multiple sessions as long as no two sessions have the same name. A session can only be activated using the instance of the
SessionManagementMBean that works on that session data.
Each MBean type, except for
SessionManagementMBean, has one instance per session. When a session is created, a new set of MBean instances (one for each MBean Type) is created automatically. One instance of each MBean Type operates on the core data that is saved to the ALSB data cache. MBean instances created for a session are destroyed when the session is discarded or activated. MBean instances that operate on core data, however, are never destroyed. MBean instances that work on core data do not support update operations.
ALSB sessions are created using the ALSB Console. The methods in the
SessionManagementMBean interface directly parallel the interactive features provided in the ALSB Console, and require execution in the same order as their GUI counterparts. The following table lists the methods available in the
SessionManagementMBean interface and the tasks they perform.
For reference material on the
SessionManagementMBean interface and Java usage examples, as well as sample code describing how to use MBeans from a Java client and in a script, see the in the
com.bea.wli.sb.management.configuration package in the ALSB Javadoc.
com.bea.wli.sb.management.configuration package in the ALSB javadoc includes example code illustrating how to create a session, how to obtain SessionManagementMBean for creating a session, and ALSBConfigurationMBean for operating on the session that is created and on core data, and so on.
ALSBConfigurationMBean allows you to programmatically query, export and import resources, obtain validation errors, get and set environment values, and in general manage resource configuration in an ALSB domain. ALSB configurations are packaged as simple JARs containing ALSB resources such as proxy services, WSDLs, and business services. These resources can span multiple projects, or contain only partial configuration information. For example, you can export only a subset of a project, a whole project, or subsets of resources from many projects.
The following sections describe how to use the
ALSBConfigurationMBean to perform these deployment activities from a Java client:
For reference material on the
ALSBConfigurationMBean interface, see the ALSBConfigurationMBean Interface in the
com.bea.wli.sb.management.configuration package in the ALSB .
ALSB configurations are created using the ALSB Console, and are stored through export in
.jar files. After a configuration
.jar file has been exported, you can promote the configuration by importing it into a different ALSB domain and changing the environment-specific values in the configuration to match those of the new environment.
The methods in the ALSBConfigurationMBean Interface allow you to manage resources in an ALSB domain, including tasks such as:
and so on. See the
The methods inand the allow you to update environment specific information. This includes.
and so on. See theand the for a comprehensive summary of methods. Import customizations are supported by the ALSBImportPlan—see the in the Javadoc.
You must update your security configuration and all other environment-specific settings interactively using the ALSB Console. For information on configuring security, seein the BEA AquaLogic Service Bus Console Online Help. For information on configuring other environment-specific settings, see Step 4. Deploy an ALSB Configuration.
The ALSBConfigurationMBean Interface in the
com.bea.wli.sb.management.configuration package in the ALSB javadoc includes example code illustrating how to import and export ALSB configurations, how to change environment values, how to query resources, and so on.
in the AquaLogic Service Bus User Guide.