Reality Web Services

Prerequisites

• A web server with support for Java servlets (Jetty is supplied). This can be on the same system as the Reality database or on another system. On web servers that do not support servlets, plug-ins can be used to add servlet support.

  Note

  Reality Web Services have been tested on Jetty 5.1.4 and Tomcat 5.0.

• Java Runtime Environment (JRE) or Java Development Kit (JDK), version 1.4.1_02 or later. For Jetty, you can use either; for Tomcat you must use a JDK.

Set-up before installation

Before installing Reality Web Services, you must set the JAVA_HOME environment variable to the path of your JRE or JDK. For information on how to set JAVA_HOME, refer to Setting Environment Variables.

Installation

Windows

Before installing Reality Web Services, you must close down all other applications, including any anti-virus software.

1. Log on to Windows as an administrator.

2. Mount the Web Services ISO image/DVD deliverable as described in Accessing the ISO Deliverable. Run SETUP.EXE. Follow the prompts to install Reality Web Services.

   Note

   If you deselect the Jetty Container option, you will be prompted to enter the path to your web server.

UNIX

1. Log in using the root/superuser user-id.

2. Confirm that the partition has enough space for the new release. You will need about 100Mb.

3. Access the Web Services ISO image/DVD deliverable.

4. Mount the ISO image/DVD as described in Accessing the ISO Deliverable.

5. Change to the Unix directory by entering:

   #cd Unix

6. Run the installation procedure by entering:

   ./webservicessetup

   Follow the prompts to install Reality Web Services.

   Note

   If you answer n when asked whether to use Jetty as your web server, you will be prompted to enter the path to your web server.

Set-up after installation

Jetty web server

To start and stop the Jetty web server, do the following:

Windows

• To start Jetty, select Reality Web Services | Start Jetty from the Start menu.

• To stop Jetty, select Reality Web Services | Stop Jetty.

UNIX

To start Jetty, do the following:

1. Log in using the root/superuser user-id.

2. Enter the following:

   #cd /usr/northgateis/jetty5.1.4
   #java -jar start.jar

   To stop Jetty, enter the following:

   #cd /usr/northgateis/jetty5.1.4
   #java -jar stop.jar

Database configuration

Each database that will expose DataBasic subroutines must be set up as described in the topic Creating a Reality Web Service.