realclone
Creates, deletes and updates isolated instances of Reality.
Syntax
realclone –[c || d || {p}u]instance
Parameters
instance A single digit in the range 1 to 9 that identifies the required instance of the current version of Reality (selected using realroot).
Options
–c Creates a new instance of Reality and gives it the specified instance number. The Reality configuration is modified so that this new instance will be activated automatically on system startup.
–d Deletes the specified instance of Reality.
Note: Use realbind to move any databases associated with the deleted instance to another instance. Databases that are not associated with any existing instance cannot be used.
–{p}u Updates the specified instance to match the base version of the Reality software. The p option ensures that any files that are no longer present in the base version are deleted from the instance.
Restrictions
realclone should only be run by the super user (UNIX) or Administrator (Windows).
The base instance of the Reality software must be selected when running realclone (use realroot to change to the base instance).
Operation
When you create a new instance of Reality, a new directory is created, in the base instance's parent directory, with the same name as the base instance, but with an underscore and the instance number appended. For example, if the current version of the Reality is V12.0, the directory containing the Reality V12.0 software will be $REALROOT/12.0. If you create instance number 1 of this, as follows:
realclone -c1
the directory $REALROOT/12.0_1 is created and the files needed by a working version of Reality (that is, the subdirectories bin, devbin, files and var, and their contents) are copied into it from $REALROOT/12.0.
Before the new instance can be used, one or more databases must be associated with it (either by creating new databases with mkdbase, or by using realbind to change the instance associations of existing databases.
The Reality host utilities will always operate on the active instance. To use a particular instance, therefore, users must make it active; this is done by running realroot to set their environment to the required instance.
Examples
realclone -c3
Creates instance number 3 of the current version of Reality.
realclone -pu3
Updates the Reality software for instance number 3 to match that of the base version.
realclone -d3
Deletes instance number 3 of the current version of Reality. This can only be done if there are no databases associated with the instance.
