Caché System Administration Guide
Using Caché on OpenVMS
[Back] [Next]
Go to:

This chapter describes the following procedures on OpenVMS:

Starting 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 OpenVMS, one of the following must be true:
Run the Caché startup procedure. The distribution includes a template of this startup command procedure, CACHE$STARTUP.COM; modify this file as necessary for your site.
Run CACHE$STARTUP.COM at the operating system level when you restart OpenVMS, as well as when you install or upgrade Caché.
To start Caché, modify the CACHE$STARTUP.COM file to automatically start the desired Caché instance when OpenVMS starts (as described in the header text of the file.)
You can also start Caché from the command line, using the ccontrol command as follows:
ccontrol start <instname>
where instname is the Caché instance name that you chose during the installation. See Controlling Caché Instances for more options and information.
Stopping Caché
To stop Caché on OpenVMS, the requirements are the same for starting Caché. You must have access to CMKRNL, WORLD, BYPASS, SYSLCK, ALTPRI, and OPER privileges. You should have these privileges if you are logged on OpenVMS as the system manager. To stop Caché:
  1. Use the ccontrol command:
    ccontrol stop <instname>
    where instname is the name of the Caché instance that you want to stop. See Controlling Caché Instances for more options and information.
  2. This procedure displays a status report. Check for active processes in the report.
  3. If there are active users on the system, you should send them a warning message that you are about to shut down the Caché system. Enter the message you want to send, and the terminal to which you want to send it. To send a message to several terminals, specify each terminal individually. For instance:
    Do you want to broadcast a message to anyone? No=>Yes
    Send a message to other terminals. Message => Please sign off
    Terminal => _NTY5:
    Terminal => <RETURN>
    Message =>
  4. When the system asks if you would like to see another system status, enter Yes to see one, or press RETURN if you do not want another report.
  5. Confirm that you want to halt by answering Yes. If you answer No, the shutdown procedure quits, and Caché continues running.
Accessing the Management Portal
The Management Portal is a web application provided with the installation to manage a Caché instance. Unlike on other platforms, Caché does not install a private web server on an OpenVMS instance. To use the Management Portal to manage a Caché server on OpenVMS, you must install the CSP Gateway on a supported web server machine (see “Supported Web Servers” in the “Supported Technologies” section of InterSystems Supported Platforms) and configure it to control the Caché instance on OpenVMS.
You can do this:
You can access the Management Portal through any supported web server and operating system combination. The following section, Configuring the Portal on Windows, describes the procedure for setting up the CSP Gateway and web server environment on a Windows host. If your environment is more complex or you need to use your web server for other applications as well, see the following topics for details:
Configuring the Management Portal on Windows
This section describes a configuration that uses your web server to control one instance of Caché on an OpenVMS machine.
To access the Caché instance on an OpenVMS system from a remote web server on Windows:
  1. Verify that you have a supported web server installed and running on the Windows machine.
  2. On the web server machine, install a minimal Caché shell. During the installation process (as described in the Installing Caché on Windows chapter of the Caché Installation Guide), follow the instructions below:
  3. Once you have installed this minimal Caché shell on a Windows web server machine, configure the CSP Gateway to access the OpenVMS-based Caché server. On the web server machine, navigate to the CSP Gateway Configuration page by entering the URL in a browser:
    http://localhost/csp/bin/Systems/Module.cxw (bookmarking this URL is helpful).
    This URL does not point to the Caché private Apache Web server; it points to a supported web server on your system using the default port of 80.
    If the Gateway Management forms are configured to be password protected, you must enter your User Name and Password (if user credentials are required, the default username is CSPSystem and the default password is SYS).
  4. Click Server Access and Add Server to create a new server configuration that connects to the remote Caché server. For this new server configuration, fill in the Server Name > IP Address, and TCP Port fields with the name, IP address, and superserver TCP port of the OpenVMS Caché server.
    If the %Service_CSP service specifies that a password is required, then fill in the User Name and Password/Password (Confirm) fields as follows:
    If %Service_CSP service specifies that a password is not required, these fields must be empty.
    Click Save Configuration. (You can use this web server to support multiple Caché instances by repeating this step to create server configurations for other Caché instances.)
  5. Click Application Access and Add Application to create a configuration for the path to the portal application, /csp/sys. For this path configuration, define the Default Server to be the Server Name you entered in the previous step and click Save Configuration.
  6. Navigate to the Management Portal using the following URL:
    http://localhost/csp/sys/UtilHome.csp, where you can now manage your OpenVMS instance.