This document describes how to use the Open ESB Components Add-on Installation JAR file to install Open ESB V2 components to an Open ESB V2 Preview 4 installation.

This document also describes how to unconfigure Open ESB components from an application server domain, and how to uninstall the Open ESB Components Add-on Installation JAR file.

Installing Additional Open ESB Components

The following procedure assumes that you have downloaded and installed Java^TM EE 5 SDK Update 4 from the Java EE downloads page. The additional Open ESB V2 Components are also available from the Java EE downloads page.

You can also use the following procedure if you have downloaded and installed Sun Java System Application Server 9.1 Update 1 (based on GlassFish V2).

When you installed Java EE 5 SDK Update 4, you also installed Sun Java System Application Server 9.1 Update 1. The application server contains the JBI Runtime, the Java EE Service Engine, and the HTTP Binding Component. This procedure describes how to install the additional components.

Note: This procedure assumes the following configuration for Sun Java System Application Server 9.1 Update 1:

• You accepted the default settings during installation of the application server.
• Your application server configuration stores the admin password in a file.

If your configuration differs from this configuration, you might have to modify the procedures accordingly.

To install additional Open ESB components

1. Make sure you have already installed Sun Java System Application Server 9.1 Update 1.
   
   The application server must be stopped before proceeding. Use the following command to stop the application server:
   
   asadmin stop-domain [domain-name]

2. Download the file open_esb_2_0-preview4.zip from the Java EE downloads page.

   The link to download this file is located in the Independent Component Downloads section.

3. Extract the file jbi_components_installer.jar from the zip file and copy it to the following location in your application server installation:
   
   <appserver-install-root>/addons

4. Navigate to the <appserver-install-root> directory and run the install-addon command:
   
   asadmin install-addon <appserver-install-root>/addons/jbi_components_installer.jar

   Note: You can enter the fully qualified path or a relative path.

5. After installation is complete, you can view the Open ESB components at the following directory:
   
   <appserver-install-root>/addons/jbi_components/

6. Start the application server domain:
   
   asadmin start-domain [domain-name]
   
   The components will be installed in the domain.

7. View the Open ESB components in:
   
   <appserver-install-root>/domains/<domain-name>/jbi/components
   
   For example:
   
   <appserver-install-root>/domains/domain1/jbi/components

Unconfiguring Open ESB Components from an Application Server Domain

The following procedure describes how to unconfigure Open ESB components that have been installed into an application server domain.

To unconfigure Open ESB components from an application server domain

1. Stop the application server domain:
   
   asadmin stop-domain [domain-name]

2. In the domain-registry file, set the configured property to false, as follows:
   
   In the <appserver-install-root>/domains/[domain-name]/config/domain-registry file, make the following edit:
   
   jbi_components_configurator.configured=false

3. Start the application server domain:
   
   asadmin start-domain [domain-name]

Uninstalling the Open ESB Add-On Installation JAR File

The following procedure describes how to remove the Open ESB Add-On Installation JAR file. This procedure makes the Open ESB components no longer available for newly created application server domains.

To uninstall the Open ESB Add-On Installation JAR file

• Run the uninstall-addon command:
  
  asadmin uninstall-addon jbi_components