Overview

This Installation Guide describes the procedure for installing Reality external components.

Terms and abbreviations

DDA Distributed Data Access

HTML HyperText Markup Language

JDBC Java Database Connectivity

JRE Java Runtime Environment

ODBC Open Database Connectivity

PCSNI PC Standard Network Interface

RSC Remote Subroutine Call (Remote Basic)

SQL Standard Query Language

TCP/IP Transmission Control Protocol/Internet Protocol

WinSNI The Windows component of PCSNI.

Winsock Windows Socket Library

Product overview

Refer to either of the Reality Installation Guides (Reality on UNIX Installation & Upgrade Guide or Reality on Windows Installation & Upgrade Guide).

Contents of the ISO/DVD deliverables

The Reality ISO image/DVD contains the following external components:

PCSNI  Standard network interface software for Windows that provides a consistent network and device independent interface to a LAN card. The WinSNI Configuration Editor, a tool for setting up PCSNI connections, must be installed separately.

RealEdit
A Reality editor running under Windows. Similar in operation to other Windows editors, but also allows you to perform Reality-specific operations such as compiling and cataloging DataBasic programs, and viewing included code.

RealSQL-ODBC Driver
Allows ODBC-compliant Windows applications to read and write data to a Reality database using SQL.

RealSQL-JDBC Driver
Allows JDBC-compliant applications to read and write data to a Reality database using SQL. Includes a standard API that can be used in Java applications, applets and servlets. Can be installed on both Windows and UNIX.

JRealThis provides the Java programmer with the ability to access Remote Basic subroutines (DataBasic subroutines that have been enabled for remote access), and to write custom servlets to access a Reality database via RealWeb.

RealWeb
Provides the Web developer with access to data held in a Reality database. Consists of a set of Java servlets that run on a web server and a DataBasic API for constructing HTML pages. Can be installed on both Windows and UNIX.

Remote Tape Server
Provides the means of saving and restoring Reality data on remote tape drives. Can be installed on both Windows and UNIX.

The Web Services ISO image/DVD provides web services that can be used to make programming resources available to remote applications, by exposing subroutines and functions using a web server.

Starting the installation

Note

If you are installing Reality Web Services, see Reality Web Services.

Windows

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

  1. Log on to Windows as an administrator.

  2. Access the Reality ISO image/DVD and run SETUP.EXE.

    When the introductory screen appears, click Custom followed by Continue.

  3. If you are installing for the first time, the Reality licence agreement is displayed. You must accept this agreement before you can continue.

  4. When the main menu appears, select the option you require (see the descriptions of the individual components).

UNIX

You can start the installation when logged on as any user. However, if you are not root/superuser you will need to enter the root/superuser password.

  1. Confirm that the partition (for example, /realman) has enough space for the new release. You will need at least 220Mb.

  2. Access the Reality ISO image/DVD.

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

  4. Run the installation procedure by entering:

    ksh ./setup

  5. If you are installing for the first time, the Reality licence agreement is displayed. Press the space bar to move through the agreement page by page, or q to skip to the end. You will then be asked if you accept the licence - you must answer y to continue the installation.

  6. Select option b) Install Client Components from the menu that appears.

Upgrading to a new version

Note that where an external component is marked on the Installation Menu as Update, this indicates that an earlier version of that component is installed and can be upgraded. If a component is marked as Overwrite, this indicates that the installed version is the same as the version on the ISO image/DVD.

Removing the External Components

On Windows, you can remove a Reality external component via the Control Panel's Add/Remove Programs option. The exception to this is PCSNI, which is a 16-bit application; it is recommended that you do not attempt to uninstall PCSNI.