25.01.2015 Views

Caché System Administration Guide - InterSystems Documentation

Caché System Administration Guide - InterSystems Documentation

Caché System Administration Guide - InterSystems Documentation

SHOW MORE
SHOW LESS

You also want an ePaper? Increase the reach of your titles

YUMPU automatically turns print PDFs into web optimized ePapers that Google loves.

Configuring Multiple <strong>Caché</strong> Instances<br />

Command<br />

ccontrol unload instname<br />

ccontrol rename instname {newname}<br />

Description<br />

Runs the procedure for unloading images<br />

(OpenVMS only).<br />

Renames the instance (not available on<br />

Windows systems).<br />

Table Notes<br />

1 On OpenVMS and UNIX-based systems, the all function displays the information for each instance<br />

on a single 80-column line with no line wrapping. It truncates any field that exceeds the allowed width<br />

and suffixes the tilde (~) symbol. If you require complete information, such as for parsing or reporting<br />

purposes, use ccontrol list.<br />

2 To display the most current help file for running the ccontrol command on Windows, invoke ccontrol<br />

help from the <strong>Caché</strong> bin directory. For example:<br />

C:\MyCache\Bin>ccontrol help<br />

The command displays the CcontrolHelp.html file in your browser; the file is in the install-dir\Help<br />

directory.<br />

On UNIX-based and OpenVMS platforms, you can run the ccontrol help command from any location.<br />

3 On OpenVMS-based systems, you may need to use a privileged account (for example, SYSTEM),<br />

or give a non-privileged account READALL, BYPASS, or SYSPRIV privileges, when using the<br />

ccontrol list function to display meaningful status information about installed instances.<br />

You may have your own procedures that involve using the scripts cstart and cstop, among others.<br />

<strong>Caché</strong> can accommodate these procedures. In fact, ccontrol invokes these scripts.<br />

For an example of creating user start and stop procedures, see the Use of the ^%ZSTART and ^%ZSTOP<br />

<strong>Caché</strong> Routines article.<br />

Important:<br />

The ccontrol command has several more functions. The help function displays<br />

available functions; others are internal to Inter<strong>System</strong>s and do not appear in the help<br />

display.<br />

9.4 Configuring Multiple <strong>Caché</strong> Instances<br />

You can install and simultaneously run multiple instances of <strong>Caché</strong> 4.0 and later on a single machine.<br />

Install <strong>Caché</strong> as for a single installation, giving each instance a unique name, a unique installation<br />

directory, and a unique port number for the SuperServer, Web server, and Telnet.<br />

<strong>Caché</strong> <strong>System</strong> <strong>Administration</strong> <strong>Guide</strong> 95

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!