Installation

Overview

To install Reality on a UNIX host, you must do the following:

1. Run the Reality installation program (see Preliminary).
2. Load the Reality software.
3. Install UNIX-Connect.
4. Build the Reality Executable.
5. Install the On-line Documentation (optional).

Preliminary

1. Log in using the root/superuser user-id.
2. Confirm that the partition (for example, /realman) has enough space for the new release. You will need at least 220 Mb.

3. Access the Reality ISO image/DVD.

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

• On Solaris the ISO image/DVD is normally automatically mounted to the /cdrom/cdrom0 directory.

  Note: If the ISO image/DVD is not automatically mounted, it can be mounted manually using:

  mount -F hsfs -r /dev/sr0 /cdrom

• On other systems, create a mount point using:

  mkdir -p /mnt/cdrom

  then:

  • On AIX manually mount the device 0 CD using:

    mount -vcdrfs -oro /dev/cd0 /mnt/cdrom

  • On Linux, manually mount the ISO image/DVD using:

    mount /dev/cdrom /mnt/cdrom

5. Change directory to the mount point:

   cd /cdrom/cdrom0	(Solaris)

   cd /mnt/cdrom		(other systems)

6. If you are installing Reality on AIX, run the customisation program by entering:

   ./custom/setup

7. Run the installation procedure by entering:

   ksh ./setup

8. 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.

   A menu similar to the following is then displayed:

   Current CD-ROM:                    Version:
   Please select one of
    
   a)   Install Reality
   b)   Install Client Components
   e)   Install Remote Tape
   f)   Install on-line documentation
   g)   Install ODBC Driver
    
   u)   Install UNIX-CONNECT
    
   l)   List image components
   v)   List image versions
    
   q)   Quit
    
    ?

Loading the Reality Software

9. From the top level Installation Menu, select option a) Install Reality:. A menu similar to the following is displayed.

   Reality Installation Menu
    
   Please select one of
    
     a)    Install base software
     u)    Install UNIX-CONNECT
     f)    Install common files
    
     m)    Build this release
    
     r)    Archive and remove an earlier release
     p)    Install 5.0 Failsafe patch
     l)    List image components
     v)    List image versions
     q)    Quit
    
      ?

10. Select option a. You will be prompted to enter your name or initials for the history file record.

11. If you are upgrading to a new version of Reality, you will be asked if you want to archive and delete any previous versions.

    Note: Previous versions will be saved in cpio format.

12. You are then prompted to choose the required MultiValue emulation.

    As an aid to migration, Reality can be configured to emulate another type of MultiValue system . When you install Reality, you can choose an appropriate emulation. If the emulation you require is not listed, refer to the latest migration information on the Northgate Reality web site.

13. The installation will then proceed (this might take several minutes). Follow the prompts that appear.
14. When the installation is complete you will be asked if you want to install the Reality keys.

    You can install the keys at this point, as part of the main installation (strongly recommended), or as part of the set-up after installation.

    Note: If you are upgrading from a release prior to V10.0, you must install the keys at this point; you cannot install them later.

    If you prefer, you can choose an evaluation version. You do not need any software keys for this option, but will be limited to 3 concurrent users.

    • If you already have the necessary keys, or intend using the evaluation version, enter y. You will then be asked if you want to install the evaluation version - enter y or n as appropriate. Then follow the prompts that appear.
    • If you do not have the keys available, enter n. Refer to Installing the Software Keys for how to install the keys at a later time.

    Notes

    • If your Serial Number Key was supplied separately from the other keys (that is, not in the keyfile), enter this first and then load the remaining keys from the keyfile.
    • If you wish to use the evaluation version to carry out performance/stress testing, you can increase the number of users for a 30-day period by registering with Northgate via the Northgate Reality web site.

Installing UNIX-Connect

15. Enter option u to install UNIX-Connect.

    Note: If upgrading, you must remove the previous version of UNIX-Connect first. If however, it is necessary for you continue to run a version of Reality earlier than V15 you will need to retain UNIX-Connect 1.5 or 1.4. Please contact your support representative for further advice.

16. Enter the rosi password if prompted. A menu similar to the following is displayed:

    UNIX-Connect CD-ROM Component Installation Utility
    Current CD-ROM: /cdimage/5/uxc     Version: V1.4.1.2
     
    Please select one of
     
      a)    Install base
      b)    Install service pack
      c)    Install a fix
      m)    Rebuild the installed version
      p)    What is the installed version ?
      r)    Remove the installed version
      i)    What is the current userid ?
      u)    Switch userid
      v)    List image versions
      t)    Run the installation check
      k)    Run a shell
      q)    Quit
     
        ?

17. Select option a. You may be prompted to enter the root password in order to run the install script.
18. When prompted to confirm that you want to install UNIX-Connect enter y.
19. An onsite link of UNIX-Connect is run automatically. When this is complete, press RETURN to return to the UNIX-Connect menu, and then enter q to return to the Reality Installation Menu. Then enter q again to return to the top level Installation Menu.

Building the Reality Executable

20. From the top level Installation Menu, select option a) Install Reality:. Then select option m to build the release.
21. The modules that will be excluded from the build are listed and you are asked for confirmation before continuing. If you want to include any overlays, RPQs or fixes, answer n and follow the prompts.

22. When you enter y in response to the confirmation prompt, the build completes.

    Note: If any error messages are displayed during the build process, take a note of them and contact Northgate support.

23. If you have not yet installed the software keys, you will be prompted to enter them.
24. If you are upgrading from a previous version, you will then be prompted:

    Rawlog currently pointed to by /usr/realman/n.n/bin/Rawlog
    Continue y/n [n]

    • If you intend to continue using your existing raw log with the new version of Reality, enter y.
    • If you enter n, you will need to create a new raw log (see Configuring a Log Disk).

25. If you are building a new installation of Reality, you will be asked if you want to make the new version LIVE. (If you do not enter y here, you can edit the file /usr/realman/installed to make the new version LIVE at a later date.)

    Note: The LIVE version of Reality is the version that is used automatically when a user logs on to the UNIX host. Non-LIVE versions require special actions, after host logon, in order to use them.

Installing the On-line Documentation

To install the on-line documentation, select option f, Install On-line Documentation, from the top-level installation menu. When prompted, enter the required location - the documentation will be placed in the subfolder onlinedocs relative to the install location you specify.

It is recommended that you install the Reality documentation on a web server, though it can also be installed on a file server or on individual PCs (for details, refer to the Reality on Windows, Installation Guide). In all cases, the file system must support long file names.

Viewing the On-line Documentation

The Reality documentation can be viewed in a web browser (see Online Documentation for details of supported browsers).

If you install the documentation in your web server's document root, your users will be able to access it via a URL such as:

http://systemname/onlinedocs/default.htm.

If you are using the Reality mini web server, they will need to include the port number in the URL; that is, use:

http://systemname:3080/onlinedocs/default.htm.

If you do not use a web server, you will have to open the file default.htm in the folder installLocation/onlinedocs.