This section describes the installation procedure for the Overlord CDL based governance capabilities. These capabilities are:
- Conversation aware ESB Actions with conformance checking against a Choreography Description
- ESB Service validation against a Choreography Description
- JBossAS (version 4.2.2.GA or higher), available from http://www.jboss.org/jbossas
- JBossESB (version 4.4.GA or higher), should download the jbossesb-4.4.GA.zip, available from http://www.jboss.org/jbossesb
- Overlord CDL (version 1.0-M1 or higher), available from http://www.jboss.org/overlord
-
pi4soa (version 2.0.0 or higher), available from http://pi4soa.wiki.sourceforge.net/download
Note
It is recommended that a pre-packaged version is used, which includes all of the necessary Eclipse related plugins. However the plugins can be installed separately into an existing Eclipse environment by following the instructions on the http://www.pi4soa.org download wiki.
- Ant, available from http://ant.apache.org
-
Install JBossAS
Unpack the JBossAS installation into the required location.
-
Install JBossESB
Unpack the JBossESB installation into a location alongside the JBossAS installation. Then follow the instructions in the JBossESB installation (install/readme.txt), to deploy JBossESB into the JBossAS environment.
-
Install the Overlord CDL distribution
Unpack the Overlord CDL distribution into a location alongside the JBossAS installation.
- Edit the install/deployment.properties file to update the JBossAS and JBossESB location settings.
-
From the install folder, run:
antto deploy the Overlord CDL to JBossAS.
-
Install pi4soa
Unpack the pi4soa pre-packaged Eclipse version into a location alongside the JBossAS installation, or install the relevant plugins (as described on the pi4soa wiki) into an existing Eclipse environment.
If just the service validation capabilities are being used, then no further configuration of the Eclipse environment is necessary. However if the conversational ESB actions, with conformance checking against a Choreography Description, will be used, then the following additional steps will be required:
- Start the Eclipse environment
Overload CDL is currently JDK1.5 compliant. Therefore it is necessary to ensure that the Eclipse environment also compiles classes, used by the ESB "conversation aware" actions, as 1.5 complaint. This can be achieved by selecting the Windows->Preferences menu item, and selecting the Java->Compiler node, and setting the compliance level to 1.5, as shown in the following image:
- Select the “Help - > Software Updates...” menu item
- From the Available Software tab, press the “Add Site...” button
- Press the “Local” button, browse to locate the tools folder in the Overlord CDL distribution, and then press the OK button. This will cause the local Eclipse update site, bundled with the Overlord CDL distribution, to be add to the Available Software tab.
-
Select the root node of the newly added local update site, and then press the “Install” button and follow the instructions to install the plugins.
Note
An eclipse issue occasionally causes the nodes under the checked root node to become unchecked, resulting in the software update manager indicating that no plugins need to be installed. If this happens, simply uncheck the root node, and then re-check the root node and press the “Install” button again.
Once the Overlord CDL distribution has been correctly installed, if you wish to try out any of the examples then the following steps should be followed to import the relevant projects into the previously configured Eclipse environment.
Select the 'Import...' menu item, associated with the popup menu on the background of the left panal (Navigator or Package depending on perspective being viewed).
When the import dialog appears, select the General->ExistingProject from Workspace option and press the 'Next' button.
Ensuring that the 'Select root directory' radio button is selected, press the 'Browse' button and navigate to the
${OverlordCDL}/samplesfolder, then press 'Ok'.
All of the Eclipse projects contained within the
samplesdirectory structure will be listed. Press the 'Finish' button to import them all.
Once imported, the Eclipse navigator will list the sample projects:
