There are many ways to connect to a Caché instance. Two of the most common are through the Caché Launcher (only on Windows platforms) and from the command line of the console.

Each Caché instance installed on a Windows machine has its own launcher. All of the launcher utility functions operate within the context of the instance associated with that launcher.

As you install each instance of Caché, you give it an instance name. To perform command-line procedures on a particular instance of Caché, use this name. You can start, stop, and maintain each of these instances independently. The following table shows the most common commands to manipulate Caché instances.

These commands are described in detail in Connecting to a Caché Instance (csession) and Controlling Caché Instances (ccontrol).

From the Caché Launcher, you can also control multiple remote Caché environments. Caché allows you to create and edit all Caché data on remote systems. This includes, but is not limited to, running remote backups, editing remote instances, and creating and compiling remote objects and routines. See the chapter “Connecting to Remote Servers” in this guide for more detailed information.

Once you have started Caché, you can log into Caché on the command line using the csession command, as follows:

csession <instname> [arguments]

where instname is the name of the instance that you are managing, and [arguments] indicates one or more of the optional arguments described in the following table. On a Windows system, you must execute the command from its location, the install-dir\bin directory of a Caché instance, or include the full path in the command, for example:

C:\InterSystems\Cache27\bin\csession Cache33

To use the csession command or the ccontrol command (see Controlling Caché Instances) on a remote server, use csession or Terminal, or a remote connection through Terminal or Telnet/ssh client.

You can control an instance of Caché using the ccontrol command. The ccontrol command supports a number of functions and has the following syntax:

ccontrol <function> <instname> [arguments]

where instname is the instance name that you chose during the installation.

C:\InterSystems\Cache27\bin>ccontrol help

The ccontrol help command displays the CcontrolHelp.html file in your browser; the file is in the install-dir\Help directory.

The optional arguments (indicated by [arguments]) are:

To use the ccontrol command or the csession command (see Connecting to a Caché Instance) on a remote server, use a Telnet or ssh client or the Terminal.

The following table displays some common uses of the ccontrol command.

1 If you require complete information, such as for parsing or reporting purposes, use ccontrol list.

2 (removed)

3 The namespace argument has no effect if you are starting Caché with a user account whose namespace property contains a value. See the “Users” chapter of the Caché Security Administration Guide for details on maintaining user accounts.

4 Only owner and cacheusr can run SHUTDOWN without csession login.

5 On UNIX®/Linux systems, these tasks are executed using the csession command (see Connecting to a Caché Instance).

You can install and simultaneously run multiple instances of Caché 4.0 and later on a single machine. Install Caché as for a single installation, giving each instance a unique name, a unique installation directory, and a unique port number for the superserver, web server, and Telnet.

The special considerations for multiple instances are:

For a standard, single instance of Caché, the superserver port number is 1972 by default. For multiple instances of Caché 4.0 and later on a single machine, each must have a unique port number. During installation, subsequent instances are assigned the next available port if you choose to set it automatically, or you can manually enter port numbers during the installation. A standard installation sets the following port numbers for your Caché instance as follows:

You most likely do not need to change the superserver or web server port numbers because of the way the Caché installation assigns them. However, you do need to assign each instance a unique Telnet port number. You can change the superserver port value after installation from the Memory and Startup page (System Administration > Configuration > System Configuration > Memory and Startup) of the Management Portal, and you can change the web server and Telnet port values after installation from the Startup Settings page (System Administration > Configuration > Additional Settings > Startup) and the Telnet Settings page (System Administration > Configuration > Device Settings > Telnet Settings), respectively, of the Management Portal.