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

Starting and Stopping Reality (Host) (startingandstoppingreality.htm)

To	Reality
Version
Topic
Submitted by
Company
Location
Email address
Comment

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 installeddirectory 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 realstartcommand. For example, to start Reality manually, run the realroot command to set your user environment. For example, if using the Korn shell for Reality V15.1 enter:
```
. realroot 15.1
```
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 -sto start the services for that version:

C:>realroot 15.1
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 manually, use the realroot command to select the current version (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.