Installing InterSystems IRIS for Health
To install InterSystems IRIS® for HealthTM, follow the instructions below, depending on your situation:
InterSystems strongly recommends that you review the “Preparing to Install” chapter of the Installation Guide before you run the installer. There may be slight differences when installing InterSystems IRIS for Health — for example, the default installation directory will be C:\InterSystems\IRISHealth\ instead of C:\InterSystems\Iris\.
Performing an Attended Installation
Running the Installer on Windows
To install a new instance of InterSystems IRIS for Health on Windows, run the installer executable as an administrator.
For detailed information on the options below, see the “Installing InterSystems IRIS on Microsoft Windows” chapter of the Installation Guide.
The installation process will prompt you for some information:
-
Choose an instance name for your installation (multiple instances can run on the same machine).
-
Choose the folder for the installation.
-
For the setup type, Development will be appropriate for most situations, especially if you are installing InterSystems IRIS for Health for the first time.
-
InterSystems recommends that you configure a web server automatically, if possible. You can modify the settings after the installation finishes. If you need to manually configure your web server you will be able to after the install finishes.
-
For security type, InterSystems recommends that you select Normal for a development environment or Locked Down for a production environment.
-
The InterSystems IRIS Service can run under a default SYSTEM (Windows Local System) account or under an existing Windows account. You will be prompted to choose a common password for the InterSystems IRIS for Health administrator accounts (_SYSTEM, Admin, SuperUser, and the Windows account you chose, if any) on the next screen.
-
You will be prompted to enter a password for the CSPSystem account.
-
In the Ready to Install the Program dialog box, you have the option to enter your license key: click License to do so and follow the prompts. You can obtain a license key from your sales engineer.
-
After that, click Install to complete the installation.
Running the Installer on Linux or macOS
To install a new instance of InterSystems IRIS for Health on Linux or macOS, follow the instructions below.
For detailed information on the options below, see the “Installing InterSystems IRIS on UNIX®, Linux, and macOS” chapter of the Installation Guide.
-
Extract the installation components from the provided tarball.
-
Navigate to the directory where you extracted the components and run the command irisinstall with elevated privileges.
-
Choose an instance name for your installation (multiple instances can run on the same machine).
-
Enter the name of the directory where the installation will reside. If the directory does not exist yet, it will be created.
-
For the installation type, Development will be appropriate for most situations, especially if you are installing InterSystems IRIS for Health for the first time.
-
InterSystems recommends that you configure a web server automatically, if possible. You can modify the settings after the installation finishes. If you need to manually configure your web server you will be able to after the install finishes.
-
For security settings, InterSystems recommends that you select Normal for a development environment or Locked Down for a production environment.
-
At the prompt What user should be the owner of this instance?, enter the name of an existing user account.
-
You will then be prompted to choose a password for the InterSystems IRIS for Health administrator accounts (_SYSTEM, Admin, SuperUser, CSPSystem, and the user account you chose for owner).
-
At the prompt What group should be allowed to start and stop this instance? enter the name of an existing group.
-
You can then choose to supply the full pathname for your license key, which you can obtain from your sales engineer.
-
After that, your chosen options are displayed on the screen. You can confirm the installation simply by pressing Enter.
Performing an Unattended Installation
InterSystems IRIS for Health can be installed in unattended mode.
Running an Unattended Installation on Windows
If you will run InterSystems IRIS for Health on Windows, follow the instructions in the “Unattended Custom Installation” section of the “Installing InterSystems IRIS on Microsoft Windows” chapter of the Installation Guide. During that process, keep in mind the following considerations that are specific to InterSystems IRIS for Health.
The minimum required set of parameters includes: instance name, a fully resolved physical pathname for the location of the installation, and the password for the SYSTEM (superadmin) account. The /qb switch is essential to running the installer in unattended mode.
The command line syntax for the minimum required set of parameters is: C:\> installation_executable.exe /instance instance_name /qb INSTALLDIR="install_directory" IRISUSERPASSWORD="password"
The InterSystems IRIS for Health unattended installer differs from the InterSystems IRIS unattended installer in that a few parameters work differently. See the table below.
Parameter or Switch | Supported by InterSystems IRIS for Health | Notes |
---|---|---|
ADDLOCAL | Y | Optional. The default installation does not include the Web Gateway libraries for external web servers, such as IIS. To install those libraries within the InterSystems IRIS for Health installation along with all other server components, add ADDLOCAL=ALL to the command line. |
INITIALSECURITY | N | Defaults to “Normal”. |
CLIENTINSTALL | N | |
ISCSTARTCACHE | N/A | |
UNICODE | N | Do not use this option. The installer will default to Unicode support as needed by InterSystems IRIS for Health. |
REPAIR | N | |
REINSTALL | N | |
REMOVE | N |
Examples: Microsoft Windows Unattended Installation
C:\> installation_executable.exe /instance HSIHsilent /qb INSTALLDIR="D:\InterSystems\HSIHsilent" IRISUSERPASSWORD="password"
Installs all available components for InterSystems IRIS for Health.
C:\> installation_executable.exe /instance HSIHclient /qb INSTALLDIR="D:\InterSystems\HSIHclient" CLIENTINSTALL=1
Installs only the client components listed in the table above. Some graphical progress indicators will be displayed.
Running an Unattended Installation on Linux or macOS
If you are running InterSystems IRIS for Health on Linux or macOS, follow the instructions in the “Unattended InterSystems IRIS Installation” section of the “Installing InterSystems IRIS on UNIX®, Linux, and macOS” chapter of the Installation Guide. During that process, keep in mind the following considerations that are specific to InterSystems IRIS for Health.
The minimum required set of parameters includes: instance name, a fully resolved physical pathname for the location of the installation, the password for the _system (superadmin) account, and “normal” security settings.
The command line syntax for the minimum required set of parameters is: $ sudo ISC_PACKAGE_INSTANCENAME="instance_name" ISC_PACKAGE_INSTALLDIR="install_directory" ISC_PACKAGE_USER_PASSWORD="password" ISC_PACKAGE_INITIAL_SECURITY="Normal" ./irisinstall_silent
The InterSystems IRIS for Health unattended installer differs from the InterSystems IRIS unattended installer in that a few parameters work differently. See the table below.
Parameter or Switch | Supported by InterSystems IRIS for Health | Notes |
---|---|---|
ISC_PACKAGE_INITIAL_SECURITY | Y | Defaults to “Normal”. |
ISC_PACKAGE_CLIENT_COMPONENTS | N | For a client-only installation, which includes components such as language bindings and SDKs and the InterSystems engine link libraries, use the irisinstall_client script.
For more information on installing client components only, see the “Installing Client-only InterSystems IRIS ” section of the “Installing InterSystems IRIS on UNIX®, Linux, and macOS” chapter of the Installation Guide. |
ISC_PACKAGE_STARTCACHE | N/A | |
ISC_PACKAGE_UNICODE | N | Do not use this option. The installer will default to Unicode support as needed by InterSystems IRIS for Health. |
Examples: Linux or macOS Unattended Installation
$ sudo ISC_PACKAGE_INSTANCENAME="HSIHsilent" ISC_PACKAGE_INSTALLDIR="/hs/HSIHsilent" ISC_PACKAGE_USER_PASSWORD="password" ISC_PACKAGE_SUPERSERVER_PORT="59992" ISC_PACKAGE_INITIAL_SECURITY="Normal" ./irisinstall_silent
Installs InterSystems IRIS for Health in “normal” security mode with Superserver port 59992.
$ sudo ISC_PACKAGE_INSTANCENAME="HSIHsilent" ISC_PACKAGE_INSTALLDIR="/hs/HSIHsilent" ISC_PACKAGE_USER_PASSWORD="password" ISC_PACKAGE_INITIAL_SECURITY="Normal" ISC_PACKAGE_MGRUSER="hsihadmin1" ISC_PACKAGE_MGRGROUP="hsihadmin" ISC_PACKAGE_WEB_CONFIGURE="Y" ISC_PACKAGE_WEB_SERVERTYPE="Apache" ./irisinstall_silent
Installs all InterSystems IRIS for Health modules; specifies the user and group who own the instance; configures the Web Gateway to work with an existing instance of Apache on the same host (installs Web Gateway libraries in /opt/gateway and adds Web Gateway configuration information to httpd.conf). Note that this configuration is appropriate only for a development instance of InterSystems IRIS for Health, not for a production installation.