Skip to main content
Jump to: navigation, search

OHF Bridge Install Steps

Revision as of 14:30, 22 December 2006 by Eishay.gmail.com (Talk | contribs) (Tomcat Setup)

The page explains the installation process of the Ohf bridge. We promise we'll make it simpler :-)

Status

If you wish to use the OHF Bridge now, we advise you to use the online version which the 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

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

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

coming soon...

Back to the top