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 3 installation. It also describes how to unconfigure Open ESB components from an application server domain, and also how to completely uninstall the Open ESB Components Add-on Installation JAR file.
Installing Additional Open ESB Components
The following procedure for installing additional Open ESB components assumes you have downloaded and installed
JavaTM EE 5 SDK Update 3 from the Java EE 5 SDK downloads page.
The additional Open ESB V2 Components are also available from the Java EE 5 SDK downloads page.
Note: The "Download With Tools" options from the Java EE 5 SDK downloads page
automatically installs additional Open ESB V2 Components.
This document assumes you did not install Open ESB V2 Preview 3 using the "Download With Tools" option.
You can also use the following procedure if you have downloaded and installed Sun Java System Application Server 9.1
(based on GlassFish V2).
When you installed Java EE 5 SDK Update 3, you also installed Sun Java System Application Server 9.1.
The application server contains the Open ESB V2 Preview 3 Runtime, the Java EE Service Engine, and the HTTP Binding Component.
The following procedure describes how to install the additional components.
To Install Additional Open ESB Components
Make sure you have already installed Sun Java System Application Server 9.1.
The application server must be stopped before proceeding. Use the following command to stop the application server:
asadmin stop-domain [domain-name]
-
Download the file open_esb_2_0-beta.zip from the Java EE 5 SDK downloads page.
The link to download this file is listed under the Download the Components Independently section.
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
Navigate to the <appserver-install-root> directory and run:
asadmin install-addon <appserver-install-root>/addons/jbi_components_installer.jar
Note: Be sure to enter the fully qualified path. Do not enter a relative path.
After installation is complete, you can view the Open ESB components at:
<appserver-install-root>/addons/jbi_components/
Start the application server domain:
asadmin start-domain [domain-name]
The components will be installed in the domain.
View the Open ESB components in:
<appserver-install-root>/domains/<domain-name>/jbi/components
For example:
<appserver-install-root>/domains/domain1/jbi/components
Note: This procedure assumes the following configuration for Sun Java Application Server 9.1:
- You have 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.
Unconfiguring Open ESB Components from an Application Server Domain
This 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
-
Stop the application server using the following command:
asadmin stop-domain [domain-name]
-
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
-
Start the application server domain:
asadmin start-domain [domain-name]
Uninstalling the Open ESB Add-On Installation JAR File
This following procedure describes how to remove the Open ESB Add-On Installation JAR file, which makes the Open ESB components no longer available for newly created application server domains.
To Uninstall the Open ESB Add-On Installation JAR File
