Oracle® Transportation Management Installation Readme Version: 6.2 Copyright © 2006, 2010, Oracle and/or its affiliates. All rights reserved. ================================================================================== IMPORTANT: The latest notes and updates on installing Oracle Transportation Management 6.2 can be found on My Oracle Support, under Document ID 1188334.1 (My Oracle Support account required). Please check there before proceeding. Other useful notes on My Oracle Support: * See 1265208.1 for the 6.2 release announcement. * See 1188334.1 for installation notes and updates. * See 796594.1 for links to documentation and training resources. * See 790603.1 for the Release Content Documents. OTM documentation is shipped separately from the base product. You should have a file called "docs.zip"; unzip the contents of this file into a directory called "docs". For installation instruction, please refer to the Oracle Transportation Management 6.2 Installation Guide: /docs/administration/install.pdf After installation of the base product is complete you will need to move the contents of the "docs" directory to: $OTM/docs where $OTM is the root directory where Oracle Transportation Management was installed. ====================================================================== IMPORTANT: Some third party components necessary to use certain functions in the Oracle Transportation Management product are not included and can be obtained directly from the third party. In order to download these third party components, please follow these instructions. Note: to ensure that the correct version of the jars are downloaded, an MD5 checksum file is provided. More information on the md5sum utility can be found at: http://directory.fsf.org/project/textutils/ ====================================================================== The following files MUST be installed prior to starting Oracle Transportation Management: 1. Download the following file into a temporary directory: a. http://archive.apache.org/dist/jakarta/taglibs/standard/binaries/jakarta-taglibs-standard-1.1.2.zip 2. Unzip jakarta-taglibs-standard-1.1.2.zip using a Zip utility such as WinZip and locate the following files: a. jakarta-taglibs-standard-1.1.2/lib/jstl.jar b. jakarta-taglibs-standard-1.1.2/lib/standard.jar Copy them to the following directories on BOTH the Web & App servers: $OTM/glog/gc3webapp/WEB-INF/lib $OTM/glog/gc3webapp/WEB-INF/lib/3rdparty where $OTM is the root directory where Oracle Transportation Management was installed. 3. On Linux, Solaris, HP-UX and AIX, change the permissions on the files (in BOTH directories) to -rwxr-xr-x on both the Web & App servers: $ chmod 755 jstl.jar standard.jar 4. On Linux, Solaris, HP-UX and AIX, change the owner of the files (in BOTH directories) to the user used to install Oracle Transportation Management (e.g. otm62) on both the Web & App servers: $ chown otm62 jstl.jar standard.jar ---------------------------------------------------------------------- Note: Under certain conditions, clients have experienced a performance issue using the above libraries. A change was proposed to the open source project by a third party that has not yet been incorporated into the project, and our experience has shown that performance has been much better using these patched libraries. If you experience this performance issue and wish to install these non-standard files, do the following: 1. Rename the following files on the Web server: $OTM/glog/gc3webapp/WEB-INF/lib/standard.jar => standard.jar.orig $OTM/glog/gc3webapp/WEB-INF/lib/3rdparty/standard.jar => standard.jar.orig $OTM/glog/gc3webapp/WEB-INF/lib/3rdparty/saxpath.jar => saxpath.jar.orig (*) $OTM/glog/gc3webapp/WEB-INF/lib/3rdparty/jaxen-full.jar => jaxen-full.jar.orig (*) where $OTM is the root directory where Oracle Transportation Management was installed. (*) these files will not exist on newer Oracle Transportation Management installations 2. Download the following file into a temporary directory: a. http://flavio.tordini.org/download/standard-1.1.2-patched-jaxen-1.1.jar Note: If your browser downloads this as a .zip file, do NOT unzip it; simply rename it as directed in the next step. 3. Rename the file to standard.jar and copy it to the following directories on the Web server only: $OTM/glog/gc3webapp/WEB-INF/lib $OTM/glog/gc3webapp/WEB-INF/lib/3rdparty where $OTM is the root directory where Oracle Transportation Management was installed. 4. Download the following file into a temporary directory: a. http://dist.codehaus.org/jaxen/distributions/jaxen-1.1.1.zip 5. Unzip jaxen-1.1.1.zip using a Zip utility such as WinZip and locate the following files: a. jaxen-1.1.1/jaxen-1.1.1.jar 6. Rename the file to jaxen-full.jar and copy it to the following directory on the Web server only: $OTM/glog/gc3webapp/WEB-INF/lib/3rdparty where $OTM is the root directory where Oracle Transportation Management was installed. 7. On Linux, Solaris, HP-UX and AIX, change the permissions on the files (in BOTH directories) to -rwxr-xr-x on the Web server: $ chmod 755 standard.jar jaxen-full.jar 8. On Linux, Solaris, HP-UX and AIX, change the owner of the files (in BOTH directories) to the user used to install Oracle Transportation Management (e.g. otm62) on the Web server: $ chown otm62 standard.jar jaxen-full.jar 9. Remove all files & sub-directories from the following directory on the Web server: $OTM/tomcat/work where $OTM is the root directory where Oracle Transportation Management was installed. ====================================================================== To install WSDL4J: 1. Download the following file into a temporary directory: a. http://sourceforge.net/projects/wsdl4j/files/WSDL4J/1.6.2/wsdl4j-bin-1.6.2.zip/download 2. Unzip wsdl4j-bin-1.6.2.zip using a Zip utility such as WinZip and locate the following file: a. wsdl4j-1_6_2/lib/wsdl4j.jar Copy it to the following directory on BOTH the Web & App servers: $OTM/glog/gc3webapp/WEB-INF/lib/3rdparty where $OTM is the root directory where Oracle Transportation Management was installed. 3. On Linux, Solaris, HP-UX and AIX, change the permissions on the file to -rwxr-xr-x on both the Web & App servers: $ chmod 755 wsdl4j.jar 4. On Linux, Solaris, HP-UX and AIX, change the owner of the file to the user used to install Oracle Transportation Management (e.g. otm62) on both the Web & App servers: $ chown otm62 wsdl4j.jar ====================================================================== To install OpenMap: 1. Download the following file into a temporary directory: a. http://openmap.bbn.com/src/openmap-4.5.4.zip 2. Unzip openmap-4.5.4.zip using a Zip utility such as WinZip and locate the following file: a. openmap-4.5.4/lib/openmap.jar Copy it to the following directory on BOTH the Web & App servers: $OTM/glog/gc3webapp/WEB-INF/lib/3rdparty where $OTM is the root directory where Oracle Transportation Management was installed. 3. On Linux, Solaris, HP-UX and AIX, change the permissions on the file to -rwxr-xr-x on both the Web & App servers: $ chmod 755 openmap.jar 4. On Linux, Solaris, HP-UX and AIX, change the owner of the file to the user used to install Oracle Transportation Management (e.g. otm62) on both the Web & App servers: $ chown otm62 openmap.jar ==================================================================================