Define a Remote Server Connection

Define a Remote Server Connection

To use the InterSystems IRIS Launcher utilities or other InterSystems IRIS applications on a remote server, the server must be on the connection list in the InterSystems IRIS 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 InterSystems IRIS on that server.

To define the remote server:

1. From the InterSystems IRIS Launcher menu, point to Preferred Server, and click Add/Edit to open the InterSystems IRIS Server Manager. (On Windows systems, you must have Administrator privileges to take this step.)

2. Click Add to open the Add Connection dialog box.

3. Fill in the fields as described in the following table and click OK. Each field is required unless otherwise indicated.

• Server Name — A descriptive phrase that identifies the server; it is what appears as a selection in the InterSystems IRIS 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. InterSystems IRIS accepts any legitimate name reference for the remote server.

• Port — The port number of the superserver. The default port number is 1972.

• Telnet Port — The port number of the telnet connection. The default port number is 23.

• Web Server IP Address — Optional. The IP address of the web server you wish to use to manage this InterSystems IRIS instance. Defaults to IP Address if not specified.

  If you plan to use a web server that exists on a separate machine from the InterSystems IRIS instance you are managing, enter the IP address of the web server machine in this field. Defaults to IP Address if not specified.

• Web Server Port — The port number of the web server, if needed.

• CSP Server Instance — Optional. The InterSystems IRIS instance name to which you want to connect if you are configuring one web server to connect to multiple InterSystems IRIS instances. See Specifying CSP Server Instance for more information.

  Note:

  The CSP Server Instance must be in all lowercase characters for the request to route properly.

• HTTPS — Whether or not links from the InterSystems IRIS Launcher use HTTPS.

• Authentication Method — Choose Kerberos or Password.

  See Kerberos Authentication for details on the use of these fields.

  See Instance Authentication for information about password-based authentication in InterSystems IRIS.

• Connection Security Level — For Kerberos 1 only. Choose either Kerberos, Kerberos with Packet Integrity, or Kerberos with Encryption.

• Windows InterSystems IRIS Telnet Server — For Kerberos only. Select this check box if you are defining a connection to a Windows server.

• Service Principal Name — For Kerberos only. This field is pre-filled with the recommended service principal name format “cache/<FQHN>” (FQHN is the fully qualified host name) for the IP address you enter.

• Comment — Optional. A description of the remote server.