docs.intersystems.com
InterSystems IRIS Data Platform 2019.2  /  InterSystems IRIS Basics: Connecting an IDE

InterSystems IRIS Connection Information
Previous section           Next section
InterSystems: The power behind what matters   
Search:  


InterSystems IRIS Connection Information
To connect an IDE to an InterSystems IRIS instance, you first need to select the instance, then determine the needed connection information, as follows:
It is also helpful 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:
InterSystems Cloud Manager
For InterSystems IRIS instances in containers deployed by ICM, the host identifier is the IP address or hostname of the provisioned or existing node the container is deployed on. You can always review the hostnames and IP addresses of the nodes in your deployment using the icm inventory command.
The default superserver and web server port numbers are 51773 and 52773, respectively; you can specify different numbers by including the SuperServerPort and WebServerPort properties in the defaults.json file. The Management Portal URL portal incorporates the host identifier and the web server port, for example http://40.122.36.160:52773/csp/sys/UtilHome.csp.
To open the Terminal for an instance deployed by ICM, you can use the icm session command with the -interactive option and the -machine option specifying the node hosting the instance.
The credentials for all of the above purposes are one of the predefined user accounts and the default password you set when deploying services on your infrastructure with the icm run command, 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 if you used the Namespace property in the definitions.json file or the -namespace option when deploying to specify a different default execution namespace, you may want to connect to that instead. You can also connect to a different namespace you previously created using the Management Portal.
InterSystems IRIS in a Container
For an InterSystems IRIS instance in a container deployed by you 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 (always 52773) as 52773 (as described in the cited section) 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.
InterSystems IRIS Installation Kit
For an InterSystems IRIS instance installed from a kit, the host identifier is the hostname or IP address of the system the instance is running on; you can use localhost if it is installed locally.
InterSystems IRIS installation sets the superserver and web server port numbers to 51773 and 52773 by default. However, if you have more than one instance of InterSystems IRIS installed on your system, the superserver and web server ports of the instances vary; to display the port numbers for all of the instances, you can use the iris list command on the operating system command line.
On a Windows system, you can open the Management Portal by clicking the InterSystems IRIS icon in the system tray and selecting Management Portal. On all systems, you can use the URL http://host:webserverport/csp/sys/UtilHome.csp, where host is the host identifier and port is the web server port number, for example http://localhost:52773/csp/sys/UtilHome.csp.
To open the Terminal for an installed instance:
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.
InterSystems IRIS Community Edition
You can deploy Community Edition in one of two ways:
To 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.
InterSystems Learning Labs
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:
Important:
The hostname provided for Atelier 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.


Previous section           Next section
Send us comments on this page
View this article as PDF   |  Download all PDFs
Copyright © 1997-2019 InterSystems Corporation, Cambridge, MA
Content Date/Time: 2019-09-19 06:44:28