Caché System Administration Guide - InterSystems Documentation

Managing Caché
service cache start
6.3.2 Running Caché
From the shell, a user with any user ID and any group ID (anyuser:anygroup in this example),
can run csession, which executes cuxsession in the install-dir/bin directory.
The cuxsession executable switches the group ID to cacheusr and leaves the calling user ID in place
(anyuser:cacheusr). Running with cacheusr as the group ID, this executable has access to all
Caché privileges and files in that installation.
Now running as anyuser:cacheusr, Caché runs its standard startup logic, including Kerberos
negotiation, to identify a $USERNAME and a set of login roles. In many cases, this $USERNAME
value is associated with the actual user who invoked csession. Thus, while any user may run Caché,
the activities of that user once in Caché are defined and limited by the security roles assigned to that
user.
CAUTION:
Do not enter Caché by invoking its executable (cache.exe) directly from the
install-dir/bin directory.
The Caché executable is not itself a setgid-executable. It is the responsibility of the csession wrapper
to set the group properly on behalf of the user entering Caché. This is not a problem if you are running
Caché from the /usr/bin directory as set up by the ccontrol default function. The ccontrol default sets
up an executable file called cache in the /usr/bin/ directory and is a link to call csession which sets
permissions properly.
6.3.3 Stopping Caché
Normally you leave your Caché system running. However, if your operating system requires a restart,
you should stop Caché before you shut down your system. The Caché maintenance tasks, such as
backups and database repair utilities, do not require you to stop Caché.
To stop Caché on UNIX, the same requirements exist as for starting Caché. 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.)
• Your UNIX group ID matches the group named during the Caché installation as having privileges
to stop and start the system.
To stop Caché, from the command line:
1. Use the ccontrol command:
Caché System Administration Guide 77