Starting and Stopping Reality

Automatic Startup

Reality is normally started automatically when the host system is powered up.

• On UNIX, the start script in /etc/init.d/reality is executed, setting up and running the Reality central daemons for all releases listed in the installed directory in /usr/realman.
• On Windows, the Reality service (realserv) is executed.

Manual Startup

• On UNIX, each version of Reality installed on the system can also be started separately using the realstart command. For example, to start Reality V14.0 manually, run the realroot command to set your user environment. For example, if using the Korn shell enter:

  . realroot 14.0

  Then, in super-user mode, enter:

  realstart

• On Windows, each version of Reality installed on the system can be started separately. At the the Command Prompt, use the realroot command to select the required version of Reality and then run realserv -s to start the services for that version:

C:>realroot 14.0
C:>realserv -s

Automatic Shutdown

On UNIX, Reality is stopped automatically when the system is powered down. The stop script in /etc/init.d/reality is executed using killreal to shutdown the central daemons for all releases listed in the installed directory in /usr/realman and remove the message queues.

On Windows, Reality is stopped automatically when the system is shutdown.

Manual Shutdown

• On UNIX, a specific version of Reality installed on the system can also be stopped using the killreal command.

  For example, to stop Reality V14.0 manually, use the realroot command to select version V14.0 (as described above for starting Reality). Then, in super-user mode, enter:

  killreal

  killreal performs a controlled and orderly shutdown.

  Note: The UNIX kill command must not be used to remove the central or database daemons because it will not delete the message queue, shared memory, etc. and it will not then be possible to restart Reality.

• On Windows, to stop a specific version of Reality use the host command realserv -e. Start a command prompt and select the required version with the realroot command. Then enter:

  realserv -e

  You can also stop a specific version of Reality from the Control Panel, by stopping the appropriate service.