Install: PML Browser Software

1. Install Tomcat on your computer, If you don't have it yet. Download and install Tomcat from jakarta.apache.org. We are going to use $TOMCAT to refer to the root directory where Tomcat is installed. The PML Browser may work with other servlet container or J2EE application server although we have tested it for Tomcat version 5.0 only.

2. Add owl to Tomcat default MIME type mappings.
   • Edit Tomcat configuration file web.xml located at $TOMCAT/conf
   • Search for a "<mime-mapping>" element.
   • You are probably at the top of a list of mime mappings. Thus, add the following lines to this list of mappings (for example, you may add the owl mapping below to top of the list):
   
   
   <mime-mapping>
       <extension>owl</extension>
       <mime-type>text/plain</mime-type>
   </mime-mapping>
   
   
   • Save Tomcat web.xmlconfiguration file

   
   

3. An IW configuration file (iw.xml) is needed to setup the PML browser. If your system has other IW applications installed, it may already have an iw.xml file and you can skip to step 5. Otherwise, you will need to follow the steps below:
   • Create a directory in your filesystem for storing your IW configurations. This is going to be your system's $IW_HOME directory. It can be located anywhere in your filesystem (for example, $IW_HOME can be created as $TOMCAT/iw).
   • Within $IW_HOME, create another directory named "conf".
   • Download a copy of the [IW configuration file] and place it in $IW_HOME/conf.

   
   

4. Define $IW_HOME as a global JNDI resource in your Tomcat configuration file.
   • Edit Tomcat configuration file server.xml located at $TOMCAT/conf
   • Search for the <GlobalNamingResources> element in the file
   • Somewhere within the element (after <GlobalNamingResources> and before </GlobalNamingResources>), add the following line replacing (your IW_HOME) by the actual value of $IW_HOME:
     (Please use the absolute address of $IW_HOME)
   
   
   <Environment name="iwhome" type="java.lang.String" value="(your IW_HOME)" override="true"/>
   
   
   • Do not save the file yet.

   
   

5. Associate $IW_HOME with IWBrowser context.
   • Edit Tomcat configuration file server.xml that is located at $TOMCAT/conf (if it is not open yet)
   • Search for the "localhost" Host element (you may search for the string "<Host name="localhost"".
   • Add the following lines within the host element:
   
   
   <Context path="/iwbrowser" docBase="iwbrowser"
       debug="5" reloadable="true" crossContext="true">
       <ResourceLink name="iwhome" global="iwhome" type="java.lang.String"/>
   </Context>
   
   Please note that this intallation instruction assumes that the war file in step 6 is going to be named "iwbrowser.war". If not, you may need to change the context above accordingly.
   • Save the configuration file

   
   

6. Modify $IW_HOME/conf/iw.xml to fit your environment.
   • Replace the value of the "wbrowserURI" element with the URL of the IWBrowser in your computer.

   • Modify the "WBROWSER" section to fit your environment. Instructions for setting up parameters within iw.xml are provided within the configuration file.

7. Download the [PML Browser application] and place it on $TOMCAT/webapps. At the moment, a password is needed to get the application in the IW website. As a war file it is going to be expanded properly when starting Tomcat.

8. Restart Tomcat
   • If Tomcat is running, use $TOMCAT/bin/shutdown.sh to shut it down
   • If you are upgrading the browser, we suggest a complete deletion of the following directories:
     • $TOMCAT/webapps/iwbrowser
     • $TOMCAT/work/Catalina/localhost/iwbrowser
   • Use $TOMCAT/bin/startup.sh to startup Tomcat

   
   

9. The IWBrowser should be working. If not, please observe the following notes:
• Your browser may produce the following error if it cannot load the iw.xml configuration file:
  
  java.lang.ExceptionInInitializerError
      iw.wbrowser.util.InitConfig.doGet(Unknown Source)
  
  So, you may need to go back to steps 4 and 5.