Caché System Administration Guide
Using Caché on OpenVMS
This chapter describes the following procedures on OpenVMS:
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:
You are logged into OpenVMS as the system manager.
You have access to CMKRNL, WORLD, BYPASS, SYSLCK, ALTPRI, and OPER privileges.
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.
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>
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é:
This procedure displays a status report. Check for active processes in the report.
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>
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.
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
Locally Download the Hewlett Packard Secure Web Server (HPSWS) for OpenVMS. HPSWS is based on the Apache web server and can be downloaded for free from Hewlett Packard.
Remotely Install the CSP Gateway on a remote system that is running a supported web server. The version of Caché (specifically, the CSP Gateway components) on the remote web server host must be from the latest Caché release. Ideally, it must be the same or a later version of the Caché system it manages.
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:
Verify that you have a supported web server installed and running on the Windows machine.
This creates the CSP
directory structure on the web server and creates virtual directory references for the /CSP
files in IIS or Apache. It overlays any previous configuration changes you may have made.
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:
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
(if user credentials are required, the default username is CSPSystem
and the default password is SYS
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.
service specifies that a password is not
required, these fields must be empty.
. (You can use this web server to support multiple Caché instances by repeating this step to create server configurations for other Caché instances.)
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
Navigate to the Management Portal using the following URL: