Difference between revisions of "OHF Bridge Install Steps"
(→Updating the Bridge)
|Line 34:||Line 34:|
==Updating the Bridge==
==Updating the Bridge==
Revision as of 13:38, 2 January 2007
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 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
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:
- Extract the new bridge.zip in the <TOMCAT_DIR>/webapps directory
- Start Tomcat