killreal

killreal sends messages to the various Reality daemons. By default it sends a message to shut down all reality processes for the current Reality release or instance.

Syntax

killreal {-d {database} } {-g} {-w} {-y}

Options

-d {database} Terminates the database daemon (UNIX) or service (Windows) for the specified database only. Database can be the path-name of the database (absolute or relative), or the system name of the database's entry in the ROUTE-FILE /etc/ROUTE-FILE is a file on a UNIX host containing items that control the routing a particular process will take through a network. Routing control includes destination system names, network addresses, etc. On Windows hosts, this information is held in the Registry. For Reality external components that use the PC Standard Network Interface for Windows (PCSNI), routing information is held in a file called winsni.ini in the Windows folder.  . If the database name is omitted, the default database The database used by the Reality host commands if none is specified on the command line. This is set using the REALDBASE environment variable. On Windows, you can also use the netadmin host utility to specify the default database.  is terminated.

-g Enables a licence extension (grace period) for any user licences that have expired or are about to expire, starting immediately. The extension ends after 20 days, or 10 days after the licences expire, whichever is the sooner; unexpired licences are not affected.

After enabling a licence extension with killreal -g, you must restart the central daemon (UNIX) or Reality services (Windows) - see Starting and Stopping Reality.

-w Turns off warnings about expiring user licences. You are prompted for the part number of the licences concerned and for your user name. This action is logged in the daemon log.

See Licence Expiry for more information.

-y Suppresses the warning messages. Ignored on Windows.

Restrictions

In general, killreal can only be run by the super-user (UNIX) or a user with administrator privileges (Windows). However, with the -d option, it can be used by the database owner; that is, the user who created the database. On Windows, it cannot be used without any options, nor with just the -y option.

Comments

If used on UNIX without any options, or just with -y, killreal sends a termination message to the central daemon which in turn sends messages to terminate the database daemon(s). Each database daemon then broadcasts requests to all reality processes on the database to initiate a controlled and orderly log off, leaving the database in a consistent state. If a reality process fails to respond after a period of approximately 30 seconds, the database daemon initiates a forced termination with a second SIGTERM signal(15).

Database Isolation

If you are using Database Isolation, you must use realroot to select the required instance of Reality before running killreal.

Licence Expiry

If the expiring licences are for a FailSafe installation, you must run killreal with the -w and -g options on both systems.

Examples

To kill the database daemon (UNIX) or service (Windows) for dbase1, enter:

killreal -d dbase1

The following message is displayed:

Shutdown of database dbase1 started

On completing the shutdown, killreal displays

Shutdown completed

This logs off all users from the specified database. The database daemon or service (as appropriate) is restarted as soon as the first user runs reality to log on again. If the administrator wishes to keep users off the database, the database must be locked using lockdbase.

UNIX

To kill the central daemon and all associated database daemons, enter:

killreal

The following message is displayed:

WARNING
This will cause all Reality databases running on message
queue queue-id to be killed, and the daemons to exit.
Type 'y' if you are sure you want this:

To restart the central daemon use realstart.