Installing_Tomcat_and_IBD_Builds

Installing Apache Tomcat

What follows described how to install Tomcat on Windows as a service. If you prefer, you can run Tomcat on the console, or in another operating system.

• Download the Tomcat Windows installer (this link is for Tomcat 5.5.25; feel free to use a latter version if available).
• Run the installer. You should be able to go through the installation wizard by always hitting "next". The default options are generally OK. On one of the pages, the installer will ask you where you have Java installed. Just make sure that the installer picks the version of Java that you want to use.
• Then at the end hit "Finish". This should start Tomcat.
• Right click on the Apache Tomcat icon on the Windows start bar, go to properties and set the max heap size to 256 MB.
• With your browser go to http://localhost:8080/. You should see a message telling you that Tomcat was successfully installed. In the Windows toolbar, at the bottom right of your screen you should have a little Tomcat icon, from which you can stop and start Tomcat. If that icon doesn't show up, go to the Windows Start menu, All programs, Apache Tomcat, and click on Monitor Tomcat.

Also please do the following to make sure that the application log file is created in the appropriate directory:

• Stop Tomcat, right click on the Tomcat icon in the Windows task bar, and choose configure.
• In the Startup tab, look at the Working Path configuration, and add \bin at the end of the path (if not already there).

[Image:Doc-tomcat-properties.png]

Installing a New Build

• Once the download is finished, right click on the file name (orbeon.zip) and uncompress it to the orbeon directory. After the file is uncompressed, you should have an orbeon directory in the same directory where you have orbeon.zip. Note that the content of the menu will change slightly depending what utility you have installed.

[Image:Doc-install-uncompress.png]

• Remove the orbeon directory in the Tomcat webapps directory, if you have one already and copy the orbeon directory you just create to that Tomcat webapps directory. With the default installation of Tomcat, that directory is C:\Program Files\Apache Software Foundation\Tomcat 5.5\webapps.
• If you choose to install IBD in a directory other than webapps/orbeon (say webapps/ibd), edit the file WEB-INF/resources/config/properties-local.xml and change the property oxf.fr.appserver.uri to http://localhost:8080/ibd (the last part of the path matching the name of the directly you created in webapps).
• Right click on the Tomcat icon in the Quick Launch toolbar, and select “Start service”. This will start Tomcat. When Tomcat starts, it will automatically deploy the application.
• With Firefox (as discussed, support for IE is pending), go to http://localhost:8080/orbeon/.