The following describes a typical installation path for the OHF Bridge. The process involves using the bundled Apache Axis libraries and server-side Equinox Servlet container in Apache Tomcat to deploy the Bridge as a Web service. There are additional paths, including deploying within Jetty or WebSphere as well as using the OHF Bridge as a POJO. If you wish to build the OHF Bridge from CVS, please go here.

For running the OHF Bridge in a Tomcat environment, please obtain the following components. Note that many of the resources below are included in the "OHF Bridge Installation" package and do not need to be downloaded twice.

• Sun Java JDK Version 5 (Java 6 currently not supported!)
• Apache Tomcat 5.5.x
• Eclipse OHF Bridge version 0.2.0
• Eclipse OHF IHE, HL7v2, and common libraries version 0.2.0 (Included)
• Apache Axis 1.4 (Included)

If you are not using the Installation Package provided, the following additional downloads are required:

• Eclipse SDK 3.2.2
• OHF Bridge configuration files
• Eclipse Equinox/OSGi server-side Servlet (WAR file)
• Eclipse Modeling Framework 2.2.x
• Various Eclipse runtime libraries (Obtained from your Eclipse installation, see list below.)

The easiest way to get the OHF Bridge up and running is to use the installation package that contains all dependencies, with the exception of Tomcat. Follow these steps to get the OHF Bridge up and running in Tomcat.

1. Obtain required files (Tomcat 5.5, OHF Bridge Installation Package
2. Install Apache Tomcat
   If Tomcat is already installed, stop the process and delete the Catalina directory under [tomcat home]/work/ before continuing.
3. Unzip the OHF Bridge Installation Package files into the root directory of your Tomcat installation.
4. Start Tomcat. If you installed Tomcat as a service, it is likely already started. You will need to restart it.
5. Verify you get a Web service description (WSDL/XML) by going to http://localhost:8080/bridge/services/ohf-bridge?wsdl.

That's it! You're now ready to use the OHF Bridge! Click here for more information on how to use the OHF Bridge.

The following is a step-by-step guide to setting up the OHF Bridge from scratch. The process essentially involves the same process that is needed to create the installation package from above. It is strongly recommended that you use the installation method outlined in the previous section. Only follow this path if you're interested in how the Bridge is really setup! :)

Step 1: Install and prepare Tomcat
1. Obtain all required files (listed above)
2. Install Apache Tomcat
   If Tomcat is already installed, stop the process and delete the Catalina directory under [tomcat home]/work/ before continuing.
3. If started, stop Tomcat. If you installed Tomcat as a service, it was probably automatically started.
4. Place the Eclipse Equinox WAR file in the [tomcat home]/webapps/ folder. Optionally you can use the Tomcat deployment manager to deploy the WAR.
5. Start Tomcat, preferably from the command line (using the Catalina script). Verify that you get an osgi> prompt.
6. Stop Tomcat by either killing the process or typing exit at the OSGi prompt.
Step 2: Install the Bridge and required components
7. Extract the JAR files from the OHF Bridge binary package (not the install package) into the [tomcat home]/webapps/bridge/WEB-INF/eclipse/plugins/ directory.
8. Copy the following Eclipse runtime libraries from your Eclipse 3.2.x plugins directory into the [tomcat home]/webapps/bridge/WEB-INF/eclipse/plugins directory. The * means you match your version of those files.
   • org.eclipse.core.runtime_3.2.*.jar
   • org.eclipse.core.jobs_3.2.*.jar
   • org.eclipse.equinox.preferences_3.2.*.jar
   • org.eclipse.core.contenttype_3.2.*.jar
9. Copy the following Eclipse Modeling Framework (EMF) libraries from either your Eclipse 3.2.x plugins directory OR the EMF 2.2.x download package into the [tomcat home]/webapps/bridge/WEB-INF/eclipse/plugins/ directory. The * means you match your version of those files.
   • org.eclipse.emf.ecore_2.2.*.jar
   • org.eclipse.emf.common_2.2.*.jar
   • org.eclipse.emf.ecore.xmi_2.2.*.jar
Step 3: Configure the Bridge and Tomcat
10. Extract the contents of the OHF Bridge configuration package into the [tomcat home]/conf/ directory.
11. Append ",org.eclipse.ohf.bridge.ws@:start,org.eclipse.ohf.bridge@:start" (remember the leading comma!) to the osgi.bundles property in the [tomcat home]/webapps/bridge/WEB-INFO/eclipse/configuration/config.ini file
12. Copy the Web service deployment descriptor (server-config.wsdd) from the [tomcat home]/conf/ directory to the [tomcat home]/webapps/bridge/WEB-INF/ directory.
Step 4: Run it!
13. Start Apache Tomcat.
14. Verify you get a Web service description (WSDL/XML) by going to http://localhost:8080/bridge/services/ohf-bridge?wsdl.