Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Difference between revisions of "OHF Bridge Install Steps"

(Pieces to obtain)
(Status)
Line 1: Line 1:
 
The page explains the installation process of the [[OHF Bridge]].  As we move toward the initial stable release, we hope to make the build and install process much simpler.
 
The page explains the installation process of the [[OHF Bridge]].  As we move toward the initial stable release, we hope to make the build and install process much simpler.
  
=Status=
+
This page was moved to [http://www.eclipse.org/ohf/components/bridge/install.php here].
 
+
If you wish to use the OHF Bridge now, we advise you to use the [http://ibmod235.dal-ebis.ihost.com:8090/bridge/services/ohf-bridge?wsdl online version] which the [http://ibmod235.dal-ebis.ihost.com:8080/ OHF Portal] is using.
+
Using this version relieve you from installing the bridge and will make sure you are using the latest bug fix.
+
 
+
==Installing from binaries (without compiling the bridge)==
+
===Pieces to obtain===
+
* [http://java.sun.com/javase/downloads/index.jsp Java JDK 5.0]
+
* [http://tomcat.apache.org/download-55.cgi Tomcat 5.5.*]
+
 
+
To get the next two files please contact Eishay Smith (eishays at us ibm com). There will be official releases of the files after the Connectathon.
+
* OHF Bridge Application zip file
+
* OHF Bridge configuration zip file
+
 
+
===Tomcat Setup===
+
* Install Tomcat from source or binary into a directory of your choice
+
** Take note of the port number your Tomcat installation use, this will be the port of the WSDL of the bridge. For simplification I'll refer to the 8090 port as the Tomcat port you are using, but you may change it to anything you like. If you wish to change the port number, check out the server.xml file in the conf directory.
+
* Run Tomcat and see that you can get the default tomcat page at http://localhost:8090/
+
 
+
===Deploy the bridge===
+
* Extract the OHF Bridge Application zip file to the webapps directory of your tomcat installation (at Windows OS the default is C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps\). After the extraction you should have the path <TOMCAT HOME>/webapps/bridge/WEB-INF/platform/plugins/
+
* Extract the files in OHF Bridge configuration zip file to the conf directory of your tomcat installation.
+
** Open the bridge.properties file in the conf directory. The file contains references to files the bridge needs. The reference are relative to the Tomcat installation directory. You don't need to change the references in case that teh Tomcat installation directory is the process directory. If you run tomcat as a windows service, you don't need to modify the path.
+
** The ''rhio.config.file'' property points to the RHIO config file. It may point to a file on the disk, or to file on the web. On the web we have a configuration file located at http://ibmod235.dal-ebis.ihost.com:8080/rhioConfig.xml . At the connectathon, we will have a local server that will serve this file in order to have a single point of configuration for all the test RHIO permutations you may need to test your application with.
+
* Start your Tomcat server
+
** First check that the Tomcat main page http://localhost:8090 gives you the Tomcat Default page.
+
** Check that you see the Axis page at http://localhost:8090/bridge/AxisServlet
+
** Click on the WSDL link http://localhost:8090/bridge/services/ohf-bridge?wsdl and see that you get the WSDL file
+
 
+
===Problems?===
+
Check out the logs at TOMCAT_HOME/log and TOMCAT_HOME/bridge. Most likely you'll get a message that explains what went wrong.
+
 
+
==Updating the Bridge==
+
Before we'll start, please note the structure of the Tomcat directory tree:
+
* The webapps directory contains the applications tomcat runs (the bridge is one of them).
+
* The work directory contains a cache of the application and the runtime use the files from there to instantiate the application.
+
 
+
If there is a file in the webapps directory and is not in the work directory, it will be copied there. But note that tomcat is not checking the timestemp of the files, so you can't assume that updating the webapps dir is all you need.
+
 
+
So the most simple way of updating the bridge will be to:
+
* Stop Tomcat
+
* Delete the bridge directory from:
+
**'''<TOMCAT_DIR>/webapps'''
+
**'''<TOMCAT_DIR>/work/Catalina/localhost/'''.
+
* Extract the new bridge.zip in the '''<TOMCAT_DIR>/webapps''' directory
+
* Start Tomcat
+

Revision as of 14:18, 19 April 2007

The page explains the installation process of the OHF Bridge. As we move toward the initial stable release, we hope to make the build and install process much simpler.

This page was moved to here.

Back to the top