Caché System Administration Guide - InterSystems Documentation

Connecting to Remote Servers
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 System Management Portal on
the cube for this server, the URI is formed as follows:
http://://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.
http://localhost:80/cache1/csp/sys/UtilHome.csp
http://localhost:80/cache2/csp/sys/UtilHome.csp
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.
8.2 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 System Management Portal to the remote Caché server instance
and configure the following settings from the [Home] > [Configuration] > [Startup Settings] page of the
portal:
• WebServerName — The DNS name or IP address of the Web server that is configured for use
with Caché tools (equivalent to the Web Server IP Address setting).
• WebServerPort — The port number of the Web server (equivalent to the Web Server Port setting).
• WebServerURLPrefix — The name of the Caché server instance (equivalent to the CSP Server
Instance setting).
88 Caché System Administration Guide