docs.intersystems.com
Home


Connecting to InterSystems IRIS in the Cloud
InterSystems: The power behind what matters   
Search:  


Want to see what InterSystems IRIS™ can do? One fast and easy way is to provision a public cloud node hosting a containerized InterSystems IRIS instance. This document explains how to get your cloud node and interact with the InterSystems IRIS instance running on it.
Getting Your InterSystems IRIS Cloud Node
To get started,
  1. Log into your Google Public Cloud, Amazon Web Services, or Microsoft Azure account. If neither you nor your employer have one yet, you can go to the GCP, AWS, or Azure portal page to quickly create a free account. Select or create a project (GCP), an IAM user and credentials (AWS), or a resource group (Azure).
  2. Find the InterSystems Community Edition page for your cloud provider by going to the Get InterSystems IRIS Today! page and selecting the appropriate link. (You can also go to the cloud provider’s marketplace page and search for InterSystems IRIS.)
  3. On the listing page, click Launch (GCP), Continue to Subscribe (AWS), or Create (Azure), then follow the prompts and fill in the required fields.
    Note:
    On AWS, for a more streamlined experience, choose Launch through EC2 at the first prompt on the Launch this software page. If you continue on the website, be sure to select Create New Based On Seller Settings from the Security Group Settings drop-down, )
That’s it! You are the proud owner of an InterSystems IRIS Community Edition cloud node, which comes with a free built-in 13-month license (there are some functionality restrictions).
Once your node is deployed, go to the page listing your nodes: Compute Engine > VM Instances (GCP), EC2 > Running instances (AWS), or Virtual machines (Azure).
Note:
You can also get immediate access to a free InterSystems IRIS instance on the InterSystems Labs web page! See InterSystems IRIS on the Web for more information.
Changing the InterSystems IRIS Password on the Linux Command Line
Before you do anything else, you must change the default password of the InterSystems IRIS instance on your cloud node. To do this, you need to open a Linux command line on the node by securely connecting to it using SSH.
The GCP and Azure interfaces include a built-in SSH connection option (Azure uses the credentials you provided when deploying the node). On AWS, and as an alternative on the others, you can connect using a separate program such as PuTTY. The cloud portals provide help on connecting with SSH using both the built-in options and third-party programs; for instructions for using PuTTY to connect to an AWS node, see Connecting to AWS Using PuTTY.
Once you have opened a Linux command line, change the default instance password by issuing the command iris password. Note the predefined user accounts that are displayed; you will use one of these with the new password you just entered to log into the InterSystems IRIS instance.
You can also use these InterSystems IRIS commands:
On the node’s Linux command line, you can also:
Interacting with InterSystems IRIS
There are several ways to interact with your InterSystems IRIS instance. The ones you’ll use depend on what InterSystems IRIS features you want to explore. They include:
InterSystems IRIS Terminal
On the container command line (opened using a docker exec command as described in the previous section), use the iris command to connect to and manage the InterSystems IRIS instance. For example, to open a Terminal session for the instance (which is called iris), issue the command iris session iris. (You can also do on the Linux command line with sudo docker exec -it try-iris iris session iris.)
When your Terminal session begins, log in using _SYSTEM or one of the other predefined accounts and the new password you provided when changing the password. You can also open the InterSystems IRIS SQL Shell by logging in as sqluser/sqluser.
Management Portal
To open the InterSystems IRIS Management Portal, load this URL in your browser:
http://external-IP:52773/csp/sys/UtilHome.csp
Example — http://35.192.00.154:52773/csp/sys/UtilHome.csp
You can see the specific link for your instance by using the iris info command on the Linux command line (as described in the previous section).
Log in using _SYSTEM or one of the other predefined accounts and the new password you provided when changing the password.
The Management Portal is the comprehensive web-based user interface to an InterSystems IRIS instance. Load it in your browser to configure and manage the instance and to access the InterSystems IRIS Data Platform features you are interested in. For example, you can create a custom namespace and database, create resources, roles, and users for authorization and manage other InterSystems IRIS security and encryption features, and configure connectivity, national language support, and other settings. You can also explore the pages used to create and manage interoperability productions, and use the System Explorer page to examine tables, views, and stored procedures on the instance, execute SQL queries and review query plans, and review the code on the instance and the globals that provide direct programmatic access to its data.
You can also search the documentation from the Management Portal, allowing you to review everything InterSystems IRIS has to offer on a topic of interest to you.
Integrated development environment
To connect an IDE to the InterSystems IRIS instance, you’ll need some or all of the following information:
The Atelier plug-in from InterSystems enables you to take advantage of the widely-known Eclipse open-source development environment to develop applications using InterSystems technology. The extensive array of plug-ins and extensions available for Eclipse means you can use whatever additional technologies your project requires, all in a single development environment. Eclipse also provides plug-ins exist for virtually all widely-used version control systems (VCS) and a powerful built-in debugging capability that is fully exploited by Atelier.
InterSystems IRIS application developers can also the Studio IDE, a client application running on Windows systems. Studio can connect to any InterSystems IRIS instance regardless of the platform it is running on.
Of course you can easily use other IDEs such as Eclipse, NetBeans, IntelliJ, and Microsoft Visual Studio.
Connecting with Java
To load data onto the InterSystems IRIS instance using JDBC, use this connection string:
jdbc:IRIS://external-IP:51773/namespace
Example — jdbc:IRIS://35.192.00.154:51773/USER
InterSystems IRIS provides a fully compliant (JDBC 4.2), pure Java, type 4 JDBC driver, which is a single standalone JAR file with no dependencies. You can download the JAR file, intersystems-jdbc-3.0.0.jar from https://github.com/intersystems/quickstarts-java/tree/master/lib.
When you use InterSystems IRIS JDBC to connect to a local Windows machine, the connection automatically uses a special, high-performance local connection, called a shared memory connection.
Find more information about connecting InterSystems IRIS and Java in the InterSystems Programming Tools Index.
Connecting with .NET
InterSystems IRIS provides two different but complementary ways to access InterSystems databases from a .NET application:
Find more information about connecting InterSystems IRIS and .NET in the InterSystems Programming Tools Index.
Next Steps
Where to go from here? Take your choice of a wide range of destinations. And remember, you can always contact us for information about or help with InterSystems products, including InterSystems IRIS.
Learning
Find out more about InterSystems IRIS with InterSystems online learning materials and the InterSystems IRIS documentation.
An Introduction to InterSystems IRIS
For high-level views of InterSystems IRIS and its capabilities, see InterSystems IRIS Overview (article) and the What is InterSystems IRIS? QuickStart.
InterSystems IRIS First Looks
These short documents introduce you to an InterSystems feature or technology and give you the chance to try it for yourself on your InterSystems IRIS cloud instance. Examples include:
For a full list of First Looks, see the Getting Started section of the InterSystems IRIS documentation. (Note that a few of the First Looks have hands-on exercises that cannot be performed on an InterSystems IRIS cloud instance because the functionality involved is not available.)
InterSystems IRIS QuickStarts
With InterSystems Learning Services QuickStarts, you can see how InterSystems IRIS Data Platform can be used to improve your systems and benefit your applications, and access informative hands-on encounters with InterSystems technology.
Experience InterSystems Technology
Ready to try InterSystems technology for yourself? Choose an experience in your area of interest and get started.
InterSystems Developer Community
On the InterSystems Developer Community, you can read about and discuss InterSystems products and technologies, including InterSystems IRIS. Posts include articles, questions and answers, announcements, new feature descriptions, and videos. Both InterSystems employees and community members participate. Register on the Developer Community to ask questions about InterSystems IRIS functionality and architecture and get answers from the people who know!
Worldwide Response Center
The Worldwide Response Center (WRC) provides expert technical assistance with InterSystems products. The center is on call 24x7x365 with staff fluent in 15 languages.
InterSystems IRIS on the Web
You can also get immediate access to a free InterSystems IRIS instance on the InterSystems Labs web page and use it to build an application with one of the many supported languages. Instructions are provided to connect your own IDE to the instance; you can then work with the included sample data, or create data of your own that more closely reflects the specific needs of your application. The InterSystems Labs instance comes with a free built-in 90-day license, with functionality limitations similar to those on the Community Edition cloud instance.
InterSystems IRIS Community Edition Limitations
The InterSystems IRIS instance on the Community Edition cloud node is subject to certain limitations, as follows:
Connecting to AWS Using PuTTY
As part of launching a node on AWS, you must designate or create an AWS public-private key pair for use in connecting to it. When you connect using SSH, you must supply the program you are using with the private key from this pair, as downloaded when you created the key pair or as supplied to you by your security administrator. Connect using PuTTY with these steps:
  1. Open the PuTTYgen key generator program that is installed with PuTTY and do the following:
    1. Use the Load button to load the .pem private key file provided by AWS. (Remember to set the file type selector in the file browser dialog to All files (*.*) to display the .pem file you want to load.)
    2. Use the Save private key button to save the key in .ppk format.
  2. Open the PuTTY program itself and do the following:
    1. In the Host Name box, enter ubuntu@host, where host is either the DNS name or the IP address, for example ubuntu@ec2-34-000-53-213.compute-1.amazonaws.com or ubuntu@34.000.53.213.
    2. In the navigation tree on the left, expand SSH and select Auth, and at the Private key file for authentication prompt browse for the .ppk file you saved in the previous step.
    3. Click Open.
    Once you have successfully connected, you can save the connection settings in PuTTY so that fewer steps will be required to connect in the future.


View this article as PDF
Copyright © 1997-2019 InterSystems Corporation, Cambridge, MA
Content Date/Time: 2019-02-18 00:56:43