You can control remote instances from a Telnet session, from the submenu on the Caché Launcher on Windows, or from a URI generated from the web server and instance information.
Point to a launcher utility and then click the server name.
You may also connect to a remote instance of Caché from a Telnet session:
You can remotely log into a Caché instance on any supported platform from a terminal running on a PC or from any workstation client capable of running Telnet. This client may have only utilities and not a Caché server instance. The version of Caché on the client machine in most cases, must be the same or a later version of the Caché system it manages.
On the macOS platform you can also use
SSH from a command prompt on Windows to connect to your macOS machine and then connect with the following command:
sudo /sbin/service telnet start
You can also use Caché Server Pages (CSP) with a remote web server. This can be used to manage a Caché instance using the Management Portal.
When connecting to the or choices on the menu, you can bookmark the generated URIs and return to these pages on your web server as long as the remote instance is running.
If you are using the Internet Explorer web browser you may need to adjust the Local intranet security settings to properly connect to remote servers.
To use the Caché Launcher utilities or other Caché applications on a remote server, the server must be on the connection list in the Caché Server Manager. This is a list of remote servers you have previously defined to which you can quickly connect. A remote server is defined with an IP address for a unique server and a TCP port, which is an instance of Caché on that server.
The Caché superserver must be running on the remote machine and its port must be open on your firewall to use the Caché Launcher utilities on that system.
For security reasons, username and password are not stored with the remote connection information.
To define the remote server:
Fill in the fields as described in the following table and click
OK. Each field is required unless otherwise indicated.
Add Connection Input Fields
|Server Name||A descriptive phrase that identifies the server; it is what appears as a selection in the Caché Launcher.|
|IP Address||The IP address, host name (if you have a DNS server) or the fully qualified domain name (FQDN) of the remote server. Caché accepts any legitimate name reference for the remote server.|
|Port||The port number of the superserver. The default port number is
|Telnet Port||The port number of the telnet connection. The default port number is
|Web Server IP Address|
|Web Server Port||The port number of the web server. The default port number is
|CSP Server Instance|
|Connection Security Level||For
|Windows Caché Telnet Server||For
|Service Principal Name||For
Web Server IP Address
If you plan to use a web server that exists on a separate machine from the Caché instance you are managing, enter the IP address of the web server machine in this field. Defaults to
IP Address if not specified.
CSP Server Instance
If you are configuring one web server to connect to multiple Caché instances, enter the Caché instance name to which you want to connect in the
CSP Server Instance field.
For example, if you have an IIS web server installed on a Windows machine and you also install two instances of Caché,
cache1 and cache2, by default you manage each instance with its own private Apache web server that is installed as part of Caché.
However, you can also manage both instances from the public IIS web server by changing the
Web Server Port ( 80 by default for IIS) and specifying cache1 and cache2 in the CSP Server Instance field when creating a server definition for each instance. This automatically creates virtual directories /cache1 and /cache2 on the public web server that point to the corresponding Caché instances.
When you enter a value in the
CSP Server Instance field and select the Management Portal on the launcher for this server, the URI is formed as follows:
http://<web srvr addr>:<web srvr port>/<csp srvr inst>/csp/sys/UtilHome.csp
This places the instance name before the
/csp/sys/UtilHome.csp portion of the URI and generates the following URIs for the two instances in the example.
If you plan to use Caché development tools and CSP applications remotely or control multiple instances from one web server, perform the advanced configuration steps described in the following section:
Advanced Web Server Configuration.
For some Caché features to function properly on a remote connection, you must configure some additional web server settings on the remote instance.
From the web server machine, point the Management Portal to the remote Caché server instance and configure the following settings from the
Startup Settings page of the portal ( System Administration > Configuration > Additional Settings > Startup):
For more information on complex configurations CSP and remote web servers, see the sections for your platform in CSP Gateway Configuration Guide.