Before installing the GRIA war on a Windows XP system, you will require the following:
N.B. There are several ways to install and configure Windows XP, so you are advised to consult your system manager and set-up the system according to your needs.
This page explains how to install and configure all Windows XP prerequisites and how to configure the firewall.
The Windows XP distribution CD does not include several of the necessary packages. These are Java 1.5.X (5.0) and Tomcat 5.0.28 which must be installed separately. In addition if you are installing the GRIA Basic Application Services then Perl is a pre-requisite and, optionally, if you wish to use the demo applications, ImageMagick. The following sections describe how to install and configure these packages for Windows XP.
Download the JDK 5.0 Update for the Windows platform from Sun (the file will have the form jdk-1_5_x__xx-i586-p.exe). Double-click on the downloaded binary to run the installer, and during installation use the default values.
We recommend using tomcat v.5.0.28 as this version is the one that has been most comprehensively tested with GRIA. However, GRIA has also been used with v5.5.17 so it is possible to employ that version (or higher).
Download Jakarta Tomcat binary for Windows e.g. v5.0.28/bin/jakarta-tomcat-5.0.28.exe.
Install Tomcat by double-clicking on the downloaded package e.g. jakarta-tomcat-5.0.28.exe. During installation use the default values, ensuring that:
Perl is required in order to run the Basic Application Services correctly. The most common perl implementations on Windows are cygwin perl and ActiveState perl.
If your system does not have cygwin installed, it recommended that you install ActiveState Perl. Choose the latest release, click the "Next" button, and then download the MSI distribution for Windows. To fully complete the installation you must restart Windows.
On the other hand if cygwin was installed on your system using the default configuration, then perl is already available. In this case you only need to install the Win32::Process perl module. This can be easily done using the cygwin setup utility. However, the default mode of this utility is to update any previously installed packages to their most stable version. If you want to avoid this, ensure that when you reach the "Select Package" dialog you choose the "Keep" option. You should then navigate to the perl category and select the lastest version of the Perl-libwin32 package. This is illustrated below:
This is the default test application used in GRIA. ImageMagick binaries for Windows can be downloaded from here. Use a Q8 version, e.g. ImageMagick-6.2.5.5-Q8-windows-dll.exe.
The ImageMagick.exe package is self extracting and the installation procedure starts automatically. Follow the instructions at the end of the installation process to test ImageMagick.
The deployed GRIA war (or webapp) should be hosted behind a firewall to ensure that your server can only be accessed on certain ports. You should consult with your systems administrator to determine if you need to run a firewall on the GRIA server machine.
Windows XP by default runs a firewall which blocks ports 8080, and 8443. If you decide to run a firewall on the machine hosting the GRIA war, you will need to open port 8080 and 8443 during installation. The firewall can be configured by: choosing the Windows Firewall from the Control Panel, then click on Exceptions -> Add Port and enter name and number:
When you've finished setting up GRIA you can block port 8080 again.
In order to provide some synchronisation between the clocks on machines that the various GRIA packages are installed on, it is recommended to run an NTP client service that will synchronise your system with an Internet time server.
There are several NTP client implementations available, e.g. Meinberg's NTP client. If you decide to use this one, then during installation select the default options except for the "Configuration File Settings" dialogue. Here you should select an NTP server from the "Want to use predefined public NTP servers" drop-down list that is geographically located closest to you.
The easiest way to control Tomcat on Windows is to use the Tomcat Monitor tool. This is available by selecting Start -> All Programs-> Apache Tomcat 5.0 -> Monitor Tomcat. Once it is started you will notice a new icon on your taskbar. Right-click on the icon to start and stop the tomcat service. If you want the tomcat service to automatically start on boot-up right-click on the icon and select "Configure". Then change startup type to "Automatic".
The next step is to deploy the services in Tomcat according to the installation instructions for the package you are installing: