Getting Started Get Set Up InterSystems IRIS Connections

InterSystems IRIS Connections

Page Contents
Page Contents


To connect an IDE to an InterSystems IRIS® instance, you first need to select the instance, then determine the needed connection information, as follows:

  • Host identifier: The IP address or hostname of the instance’s host.
  • Superserver and web server port numbers for the instance.
  • Valid credentials for the instance.
  • The name of an existing namespace on the instance.

It is also important to know the URL of the instance’s web-based Management Portal, and how to open the InterSystems Terminal on the instance, which requires the instance’s name.

How you determine this information depends on how you deployed the instance you are working with, as follows:

Learning Labs Sandbox


All connections to the containerized InterSystems IRIS instance that is part of your InterSystems Learning Labs configuration are set up during the Learning Labs launch, and all the connection information you need is displayed on the launch page, as follows:

  • The URL for the integrated IDE
  • A set of credentials for all purposes
  • The Management Portal URL
  • The hostname for external IDEs (with the exception of Studio), and the web server port number (always 80)
  • Under External Connections, the server’s IP address and the superserver port number (labeled InterSystems IP and InterSystems Port)
The hostname provided for external IDEs and included in the Management Portal URL is not a standard DNS name and cannot be used for other purposes.

A Terminal option is available on the InterSystems menu in the integrated IDE (as is a Management Portal option), so you don’t need to keep track of the instance name.

Community Edition


You can deploy Community Edition in one of two ways:

  • When you provision a cloud node hosting a running InterSystems IRIS Community Edition container on a public cloud platform, the IP address (host identifier) of the cloud node. the instance’s superserver and web server port numbers (always 51773 and 52773, respectively), and the Management Portal URL for the instance are displayed when you first connect to the node using SSH, and can be displayed at any time by entering iris info on the Linux command line. The portal URL incorporates the IP address and the web server port, for example http://40.122.36.160:52773/csp/sys/UtilHome.csp.
  • When you pull the Community Edition image from the Docker Store and deploy an InterSystems IRIS Community Edition container on a system of your choice, the host identifier is the IP address or hostname of the system the container is running on. The superserver and web server port numbers depend on how you publish the instance’s ports when you create and start the container with the docker run command; for more information, see “Deploying InterSystems IRIS Community Edition on Your Own System” in Getting Started with InterSystems IRIS Community Edition. As an example, if you publish the instance’s web server port as 52773 and your browser is running on the same system as the container, the Management Portal URL is http:/localhost:52773/csp/sys/UtilHome.csp.

For information about opening the Terminal for any Community Edition instance, see “Interacting Using InterSystems IRIS Terminal” in Getting Started with InterSystems IRIS Community Edition.

The credentials for all purposes are one of the predefined user accounts and either the new default password you provided when changing the password on first connecting to the cloud node (see “Changing the InterSystems IRIS Password” in Getting Started with InterSystems IRIS Community Edition) or the default password SYS, if you are on your own system or logging into the cloud instance without having connected to the node first. When you use SYS, you are prompted to immediately change the password for the account you are using. You can also use an account you previously created on the instance.

You can always connect your IDE to the USER namespace that exists in all InterSystems IRIS instances, but you can also connect to a different namespace you previously created using the Management Portal.

Containers


For an InterSystems IRIS instance in a container you can deploy from an InterSystems image, the host identifier is the IP address or hostname of the system the container is running on.

The superserver and web server port numbers depend on how you publish the instance’s ports when you create and start the container with the docker run command; for more information, see “Deploying InterSystems IRIS Community Edition on Your Own System” in Getting Started with InterSystems IRIS Community Edition. As an example, if you publish the instance’s web server port as 52773 and your browser is running on the same system as the container, the Management Portal URL is http:/localhost/:52773/csp/sys/UtilHome.csp.

To open the Terminal for an instance in a container, you can use the docker exec command to run the iris terminal command within the container; for an example, see “Interacting Using the InterSystems IRIS Terminal” in Getting Started with InterSystems IRIS Community Edition. You can also use docker exec to open a shell within the container and run iris terminal from that. To use the iris terminal command you need the instance name, which in any container from InterSystems is always IRIS.

The credentials for all purposes are one of the predefined user accounts and the default password SYS (you are prompted to immediately change the password for the account after doing this), or an account and password you have previously added to the instance.

You can always connect your IDE to the USER namespace that exists in all InterSystems IRIS instances, but you can also connect to a different namespace you previously created using the Management Portal.