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 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 5 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^TM System Application Server 9.1 Update 2 (based on GlassFish v2).

When you installed Java EE 5 SDK Update 5, you also installed Sun Java System Application Server 9.1 Update 2. 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 2:

• 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 need to modify the procedures accordingly.

To install additional Open ESB components

1. If the application server domain is running, then stop the application server domain:
   
   asadmin stop-domain [domain-name]

2. Download the open_esb-v2.zip file from the Java EE downloads page.

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

3. Extract the jbi_components_installer.jar file 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 the following directory:
   
   <appserver-install-root>/domains/<domain-name>/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. If the application server domain is running, then stop the application server domain:
   
   asadmin stop-domain [domain-name]

2. In the <appserver-install-root>/domains/[domain-name]/config/domain-registry file, set the configured property to false:
   
   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