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.

RealityV15.1Online Documentation (MoTW) Revision 7

Installing Updates (UNIX Installation Guide) (M6847IG+Updates.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

Installing Updates

Updates to Reality are made available on the NPS Reality Support webpage. These are normally supplied as a service pack containing the latest recommended updates.

To download the latest service pack, select the V15.1 support link on the left of the page. Then click the pack for UNIX/Linux platforms and save the file.

Before downloading, please read the documents Description of Recommended Updates and Installation Info File for details of the contents of the pack and any additional configuration that might be necessary.

Caution

Before you install an update, ensure that you have an up-to-date backup of your existing data.

Other support information is available on the NPS Reality website.

Procedure

Download the latest service pack from the Reality website to your UNIX system.

It is recommended that you create an updates subdirectory in the realman user's home directory and save the update there.
Uncompress the downloaded file:
- On Solaris and AIX, use the uncompress utility.
- On Linux, use the gzip utility with the -d option.
Extract the individual updates from the resulting .tar file with the following command:
```
tar -xvf fileName
```
Ensure that no users are logged into Reality. If necessary use the LOGOFF command.
Login to UNIX as root.
Execute the command:
```
$REALROOT/bin/killreal
```
to shut down the Reality daemons.
Switch UNIX user-id to realman.
Run the install_fix command as follows:
```
install_fix -a updatesDirectory
```
where updatesDirectory is the path to the directory containing the downloaded updates.

For example, if you have extracted the service pack to the directory /usr/realman/updates, when run from the realman user's home directory the command would be:
```
install_fix -a updates
```
Note: If you only want to install a single update, run install_fix without the -a option and specify the file containing the required update. For example, for update V14.2.0.0001 saved in the directory /usr/realman/updates the command would be:
```
install_fix updates/V14.2.0.0001.tar
```
install_fix will ask you for your name or initials. Once you have supplied this information, the process displays a description of each update to be installed and asks you to confirm installation.
Notes:
- You can suppress the confirmation prompts by running install_fix with the -y option.
- If the process detects that the current version of the update is already loaded, a message is displayed and the update is not installed.
If necessary, the installation process then rebuilds Reality and/or informs you that you should logon to each database to complete the installation.
Log into UNIX as root and run the command:
```
$REALROOT/bin/realstart
```
to restart the Reality daemons.
If you were informed that you need to log onto each database to complete the operation, log on to each database as the database owner and ensure that you are logged on to the SYSMAN account. Then from TCL run:
```
DBUPDATE updateNumber
```
where updateNumber is the number of the update you have installed (for example, 14.2.0.0001); omit the update number to process all updates. Follow the on-screen prompts.