Caché System Administration Guide - InterSystems Documentation

Managing Caché
6.3 Managing Caché
From the shell, a user with any user ID in the sysmgr group can run ccontrol. When ccontrol executes,
it finds the proper file (cstop, for example) in the install-dir/bin directory.
The cstart, cstop, and cforce script files link to the cmgr executable, which runs in its current directory
switching the user ID to cachemgr.
The cmgr executable calls these scripts, which execute the appropriate Caché executables to run Caché
in the right mode for shutdown or force. The following sections describe how to perform these management
tasks on a Caché instance:
• Starting Caché
• Running Caché
• Stopping Caché
Important:
The owner of the installation has full privileges to start and stop the instance, to perform
system administration, and to run diagnostic programs for that instance.
Only the user ID that is the owner of the instance can and should run all diagnostic
activities. This ensures that any files or resources created are owned by the owner of
the instance and not root (which may make it impossible to access these resources by
a non-root user). For this reason, it is inadvisable for root to in any way administer
an instance not owned by root (including starting and stopping the instance). A user
running as root should only administer instances owned by root.
6.3.1 Starting Caché
To start Caché, run the startup procedure at the system level. This procedure activates either a default
configuration file or a configuration file you specify.
Note:
If you have any trouble starting Caché, view the cconsole.log file as described in the Monitoring
Log Files section of the Caché Monitoring Guide.
If you are not on the console machine, run Telnet and connect to the target machine where Caché is
installed. Before you can start Caché on UNIX, one of the following must be true:
• You are the superuser.
• You have signed on as the root user. (It is acceptable to su (super user) to root while logged in
from another account.)
Caché System Administration Guide 75