Documentation Comments

Use this form to comment on this topic. You can also provide any general observations about the Online Documentation, or request that additional information be added in a future release.

Reality V15.0 ()

Reality Web Services (External Components Installation Guide) (M6859IG+WebServices.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

Reality Web Services

Prerequisites

A web server with support for Java servlets (Jetty is supplied).

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.

Log on to Windows as an administrator.
Mount the Web Services ISO image/DVD deliverable as described in Accessing the ISO/DVD 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

Log in using the root/superuser user-id.
Confirm that the partition has enough space for the new release. You will need about 100Mb.
Access the Web Services ISO image/DVD deliverable.
Mount the ISO image/DVD as described in Accessing the ISO/DVD Deliverable.
Change to the unix directory by entering:
```
#cd Unix
```
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:

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.