Using Caché on Linux and UNIX

This chapter describes the specific procedures on Linux and UNIX:

Starting Caché

To start Caché, run the startup procedure at the system level. This procedure activates either a default configuration or a configuration you specify.

If you have any trouble starting Caché, view the console log using the Control Panel as described in the Monitoring Log Files section of the chapter on “Managing Caché”.

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.
Your UNIX uid group matches the group named during the Caché installation as having privileges to stop and start the system.

See the Caché Installation Guide for UNIX and Linux for information on specifying such privileges during installation.

Start Caché using the ccontrol command:

ccontrol start <configname>

where configname is the name of the configuration you want to start. See Controlling Caché Instances for more options and information.

Stopping Caché

Normally you will 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 or you are signed on as the root user.
Your UNIX uid group matches the group named during the Caché installation as having privileges to stop and start the system.

To stop Caché, from the command line:

Use the ccontrol command:
```
ccontrol stop <configname>
```
where configname is the name of the configuration you want to stop. See Controlling Caché Instances for more options and information.
This procedure invokes the Caché SHUTDOWN utility, which displays a status report. Check for active processes in the report to determine if the next step is necessary.

Should it be necessary, broadcast a message to any users on the system:

Do you want to broadcast a message to anyone? No=> Yes
Send a message to other terminals. Message => Please sign off
Terminal => /dev/tty/06
Terminal =>
Message =>

After sending one message you can send others, until you respond to the “Message” prompt by pressing Enter.
When the system asks if you would like to see another system status, enter Yes to see one, or press Enter if you do not want another report.
If you answer Yes, when the system status displays again, identify any active terminals.
Confirm that you want to halt by answering Yes. If you answer No, the shutdown procedure quits and Caché continues running.