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 Online 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
    
    ?

   Note: At various points when installing on CentOS, passwords are prompted for after selecting an option. Once the password is entered, the menu is normally redisplayed and the option needs to be reselected. As a side effect of the menus being redisplayed, the q option has to be used to quit the redisplayed menu before you can quit to the previous menu level.

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 NPS Reality website.

    Note: An installation on CentOS does not feature this prompt.

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.

    Both the Reality system itself and some of its features are targeted. This means that you must obtain a date-sensitive Serial Number Key, and a set of feature keys that must include a Version Key and User Licences Key, from Northgate Public Services for each system on which Reality and any targeted features are being installed (see Information You Must Supply). The feature keys are supplied in a "keyfile".

    If you are upgrading from V10.0 or later, you can either install the keys now (as is strongly recommended), or later as part of the set-up after installation. However, if you are upgrading from a release prior to V10.0, you must install the keys now; you cannot install them later.

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

    • Enter y if you have the necessary keys, or intend to use the evaluation version which does not require any.

      You are asked if you want to install the evaluation version - enter y or n as appropriate. Then follow the prompts that appear.

    • Enter n if you either do not have the keys available now, or want to install them later.

      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 Public Services via the NPS Reality website.

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
    UNIX-Connect /mnt/cdrom/uxc Version: V2.0.8.0 UserID: rosi
     
      a)    Load and install the Revision image V2.0.8.0
      b)    Re-install a selected Revision
      c)    Uninstall & delete a selected Revision
      l)    List available (loaded) Revisions
      u)    Change user ID
      s)    Shell out
      q)    Quit
     
    Please select an operation from above:

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 Online Documentation

To install the online 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 & Upgrade Guide). In all cases, the file system must support long file names.

Viewing the Online 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.