Caché System Administration Guide - InterSystems Documentation
Caché System Administration Guide - InterSystems Documentation
Caché System Administration Guide - InterSystems Documentation
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