docs.intersystems.com
Home  /  Quick Start: InterSystems IRIS Installation


Articles
Quick Start: InterSystems IRIS Installation
InterSystems: The power behind what matters   
Search:  


Quick Start: Purpose
This guide will help you get a single, licensed instance of InterSystems IRIS™ running on your desktop or virtual machine. This instance will be ideal for you to try out the technologies described in our First Look guides.
We’ve provided instructions for 64-bit Windows 10, Red Hat Enterprise Linux 7, and Apple macOS 10.13.
Caution:
You should NOT use this guide for a production installation or for any custom installation configurations: for help on those topics, see the Installation Guide.
Quick Start: Before You Begin
Before you start installing InterSystems IRIS, make sure that you have:
Important:
The First Look you’re reading may have specific requirements for an installation: for example, “Locked Down” security may be required. Make sure to review the “Before You Begin” sections of the First Look before you follow the directions below.
Quick Start: Installing InterSystems IRIS on Windows 10
To install InterSystems IRIS on Windows 10:
  1. In Windows Explorer, right-click the InterSystems IRIS installation executable and select Run as administrator. Click Yes in the resulting Windows user account control dialog.
  2. If a Select instance dialog appears, choose New Instance.
  3. Accept the license agreement and click Next.
  4. In the InterSystems IRIS Instance Name dialog, enter a name for your instance of InterSystems IRIS, using only alphanumeric characters and underscores. Then click Next.
  5. If the displayed destination folder for the installation is acceptable, click Next. If not, click Change to choose a different folder. Use a folder on your machine, not a mapped network drive.
  6. In the Setup Type dialog, accept the default of Development and click Next.
  7. In the Initial Security Settings dialog, choose the security type recommended by your First Look. If none is recommended, choose Normal and click Next.
  8. In the Enter Credentials dialog, choose Run InterSystems IRIS under a defined Username account, confirm that your Windows username and domain are correct, and enter your Windows password. Then click Next.
  9. In the InterSystems IRIS Users configuration dialog, enter and re-enter a password of 8–32 characters (alphanumeric and punctuation allowed). Make note of this password, since you will use it when you log into the main InterSystems IRIS management tools. Then click Next.
  10. For Enter password for CSPSystem account, enter and re-enter a password of 8–32 characters (alphanumeric and punctuation allowed). Make note of this password. Then click Next.
  11. In the Ready to Install the Program dialog, click License. Navigate to your iris.key file and choose it. Then click Install. The installation process will take a few minutes.
For access to your new installation, right-click the up arrow in the Task Bar. You should see a menu of icons. The InterSystems IRIS icon looks like this and if you right-click it, you’ll see a list of management tools for the instance.
Quick Start: Installing InterSystems IRIS on Red Hat Linux
To install InterSystems IRIS on Red Hat Linux using a bash shell:
  1. Create a group within Linux and add your user account to it.
  2. Extract the installation files from the tarball.
  3. Go to the directory to which you extracted the installation files.
  4. Run the command sudo ./irisinstall, which will issue a series of prompts.
    1. If you are prompted to enter a number for your platform, enter the number listed for Red Hat Enterprise Linux.
    2. For Enter instance name, enter a descriptive name for your instance. Use only alphanumeric characters and underscores.
    3. Confirm the instance name by pressing Enter.
    4. For Enter a destination directory for the new instance, enter the name of the directory for the InterSystems IRIS system files. Do not use a symlink. The directory need not exist yet on your machine.
    5. Confirm that you want to create the new directory (or use the existing directory you entered) by pressing Enter.
    6. For Setup type <1>, press Enter to accept the default installation type (Development).
    7. For Initial Security settings, enter the number for the security type recommended by your First Look. If none is recommended, select 2 for “Normal”.
    8. For Which user should be the owner of this instance? enter the name of your user account.
    9. For Please enter the common password for _SYSTEM...", enter (and then re-enter) a password of 8–32 characters (alphanumeric and punctuation allowed). Make note of this password, since you will use it when you log into the main InterSystems IRIS management tools.
    10. For Please enter the password for CSPSystem...", enter (and then re-enter) a password of 8–32 characters (alphanumeric and punctuation allowed). Make note of this password.
    11. For What group should be allowed to start and stop this instance?, enter the name of the group you created in step 1 above.
    12. For Do you want to enter a license key, enter y. Then enter the full pathname of your iris.key file (for example, /home/user/iris/iris.key).
    13. The script will display the installation options you’ve chosen before proceeding. Press Enter to accept the choices.
  5. Take note of the URL displayed at the end of the installation script’s output: it is the URL for the Management Portal, which is the system administration user interface for InterSystems IRIS.
  6. To check the status of and see other information about your newly installed instance, enter iris list.
Quick Start: Installing InterSystems IRIS on macOS
To install InterSystems IRIS on macOS using a bash shell:
  1. Create a group within macOS and add your user account to it.
  2. Extract the installation files from the tarball.
  3. Go to the directory to which you extracted the installation files.
  4. Run the command sudo ./irisinstall, which will issue a series of prompts.
    1. If you are prompted to enter a number for your platform, enter the number listed for Red Hat Enterprise Linux.
    2. For Enter instance name, enter a descriptive name for your instance. Use only alphanumeric characters and underscores.
    3. Confirm the instance name by pressing Enter.
    4. For Enter a destination directory for the new instance, enter the name of the directory for the InterSystems IRIS system files. Do not use a symlink. The directory need not exist yet on your machine.
    5. Confirm that you want to create the new directory (or use the existing directory you entered) by pressing Enter.
    6. For Setup type <1>, press Enter to accept the default installation type (Development).
    7. For Initial Security settings, enter the number for the security type recommended by your First Look. If none is recommended, select 2 for “Normal”.
    8. For Which user should be the owner of this instance? enter the name of your user account.
    9. For Please enter the common password for _SYSTEM...", enter (and then re-enter) a password of 8–32 characters (alphanumeric and punctuation allowed). Make note of this password, since you will use it when you log into the main InterSystems IRIS management tools.
    10. For Please enter the password for CSPSystem...", enter (and then re-enter) a password of 8–32 characters (alphanumeric and punctuation allowed). Make note of this password.
    11. For What group should be allowed to start and stop this instance?, enter the name of the group you created in step 1 above.
    12. For Do you want to enter a license key, enter y. Then enter the full pathname of your iris.key file (for example, /home/user/iris/iris.key).
    13. The script will display the installation options you’ve chosen before proceeding. Press Enter to accept the choices.
  5. Take note of the URL displayed at the end of the installation script’s output: it is the URL for the Management Portal, which is the system administration user interface for InterSystems IRIS.
  6. To check the status of and see other information about your newly installed instance, enter iris list.