install_fix
Installs (or removes) a Reality update.
Syntax
install_fix {options} [-u] updateFile
install_fix {options} -a updateDirectory
install_fix -b
install_fix {options} -r updateFile
Parameters
updateFile The name of the file containing the downloaded update.
updateDirectory The path of the directory containing the updates.
Options
-a Install all the updates in the specified directory.
-b Windows only. Rebuild the Reality executables without installing any updates.
-i userNameSpecifies the name or initials of the user who is installing the updates. install_fix will not prompt for this information.
-n Do not rebuild the Reality executables.
-r Removes the specified update. Note that although updateFile must be specified, the file concerned need not exist. Note: After removing an update, you must run SYS-UPDATE on each database to update the system files.
-u UNIX only. Overwrites the specified update with a new version. Cannot be used with the -a option.
-y Answer y to
all confirmation prompts.
Restrictions
UNIX
Can be used by the realman user only.
Before running install_fix, the Reality daemons must be shut down using killreal. On completion, run realstart to restart the Reality daemons.
Windows
Must be run by a user with administrative privileges.
Comments
When run, install_fix normally asks you for your name or initials. Once you have supplied this information, the process displays a description of the update and ask you to confirm installation. If you are installing several updates you are asked to confirm each update in turn. The -i and -y options allow you to suppress these prompts.
Note
If the process detects that the current version of the update is already loaded, the update is not installed and an appropriate message is displayed.
Once all the updates have been installed, If necessary, the installation process will then rebuild the Reality executables and/or inform you that you should logon to each database to complete the installation using the DBUPDATE TCL command.
UNIX
The Reality daemons/services must be shut down with the killreal host command before running install_fix to install updates. On completion, restart the daemons with realstart.
Windows
On Windows, install_fix asks if you want to shut down the Reality services so that the rebuild can proceed:
-
If you answer yes, the services are shut down and the executables are rebuilt. You are then asked if you want to restart the services. Reality cannot be used until this is done, but if you prefer, you can restart them later by running realserv with the
-soption. -
If you answer no, you must complete the update at a later time by running install_fix with the -b option.
Log Files
On Windows, install_fix logs its operations in three log files in the realman folder: install_fix.log, update_lib.log and build.log. If any problems occur when installing updates, examine these files for details.