OHF Bridge Install Steps
The page explains the installation process of the Ohf bridge. We promise we'll make it simpler :-)
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
- 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 the8090 port as the Tomcat port you are using, but you may change it to anything you like.
- 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
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