Skip to main content

UNIX®, Linux, and macOS Unattended Installation

This page details the steps for unattended installations on UNIX®, Linux, and macOS.

Make sure you have completed the following before performing the steps on this page:

Unattended Installation Overview

Default:

  • You can perform unattended installation of InterSystems IRIS instances on your systems using the irisinstall_silent script.

  • An unattended installation gets configuration specifications from the configuration parameters and the packages specified on the irisinstall_silent command line.

  • Each specified package represents an InterSystems IRIS component; the installation scripts for each component are contained in the packages directory below the directory containing the irisinstall_silent script.

  • The general format for the irisinstall_silent command line is to precede the command itself by setting environment variables to define the installation parameters. See the example for details.

Example:

sudo ISC_PACKAGE_INSTANCENAME="<instancename>"
 ISC_PACKAGE_INSTALLDIR="<installdir>"
 ISC_PACKAGE_PLATFORM="<platform>" ISC_PACKAGE_UNICODE="Y"|"N"
 ISC_PACKAGE_INITIAL_SECURITY="Minimal"|"Normal"|"Locked Down"
 ISC_PACKAGE_MGRUSER="<instanceowner>" ISC_PACKAGE_MGRGROUP="<group>"
 ISC_PACKAGE_USER_PASSWORD="<pwd>"  ISC_PACKAGE_CSPSYSTEM_PASSWORD="<pwd>"
 ISC_PACKAGE_IRISUSER="<user>" ISC_PACKAGE_IRISGROUP="<group>"
 ISC_PACKAGE_CLIENT_COMPONENTS="<component1> <component2> ..."
 ISC_PACKAGE_STARTIRIS="Y"|"N"
 ./irisinstall_silent [<pkg> ...]

Step 1: Before Beginning

Default:

  • Before beginning your installation, perform the necessary pre-installation steps.

  • Determine your strategy for installing an external web server:

    • The easiest option is to install the Apache httpd web server before beginning the installation. The installer can auto-configure this web server.

    • If you intend on using a different web server or manually configuring the IIS web server, review Installing a Web Server for necessary steps that must be performed prior to the installation.

Step 2: Log in as root

Default:

  • Log in as user ID root.

  • It is acceptable to su (superuser) to root while logged in from another account.

More:

Step 3: Determine Parameters to Specify

Default:

  • Include the required unattended installation parameters:

    • ISC_PACKAGE_INSTANCENAME=“<instancename>

    • ISC_PACKAGE_INSTALLDIR=“<install-dir>” (New instances only)

    • ISC_PACKAGE_USER_PASSWORD=“<password>” (Required for installations with Normal or Locked Down security levels)

  • For details on these required parameters see Unattended Installation Parameters.

  • The installation uses the default for any parameter that is not included. The installation fails if a required parameter is not included.

More:

Step 4: Unattended Installation Packages

Default:

  • Do not include a package name or include the standard_install package.

More:

  • The installation scripts for each component are contained in the packages directory below the directory containing the irisinstall_silent script.

  • Each package is in its own directory, and each package directory contains a manifest.isc file defining prerequisite packages for the package in that directory.

  • The standard_install package is the starting point for a server install in which all packages are installed.

  • You can include one or more of these packages in your installation.

  • You can also define a custom package for your installation. See Unattended Installation Packages for details.

  • For details on more complex custom installation packages, see Adding UNIX® Installation Packages to an InterSystems IRIS Distribution.

Step 5: Create Installation Command

Default:

  • Create an installation command using the following format:

    sudo ISC_PACKAGE_INSTANCENAME="<instance-name>" ISC_PACKAGE_INSTALLDIR=<install-dir> [PARAMETERS] ./irisinstall_silent [PACKAGES]
    
  • Include any additional parameters separated by spaces.

  • Include any specific packages separated by spaces.

Examples:

  • In this example, all packages are installed with minimal security:

    sudo ISC_PACKAGE_INSTANCENAME="MyIris" ISC_PACKAGE_INSTALLDIR="/opt/MyIris1" ./irisinstall_silent
    

    If the MyIris instance already exists, it is upgraded; otherwise, it is installed in the /opt/MyIris1 directory.

  • In this example, the installation is aborted and an error is thrown if the instance named MyIris does not already exist:

    sudo ISC_PACKAGE_INSTANCENAME="MyIris" ./irisinstall_silent
    
  • In this example, only the database_server and odbc packages and the odbc client binding are installed with minimal security:

    sudo ISC_PACKAGE_INSTANCENAME="MyIris" ISC_PACKAGE_INSTALLDIR="/opt/MyIris2"
    ISC_PACKAGE_CLIENT_COMPONENTS="odbc" ./irisinstall_silent database_server odbc
    

Step 6: Execute Command

Default:

Purpose of this instance: Draft documentation
DocReleaseID: HealthConnect2025.1
Content loaded from:
/staging/learning/iris-doc/2025.1.x/doc/cache/en-us/src/
/staging/learning/iris-doc/2025.1.x/doc/ensemble/en-us/src/
/staging/learning/iris-doc/2025.1.x/doc/healthconnect/en-us/src/
/staging/learning/iris-doc/2025.1.x/doc/healthcommon/en-us/src/
/staging/learning/iris-doc/2025.1.x/doc/security/en-us/src/
Excluded items: AADAN, ABIT, ACLOUD, AFL_adonet, AFL_ecp, AFL_icm, AFL_jdbc, AFL_netxep, AFL_sharding, AFL_xep, APMML, APOWER, ARGATEWAY, AWEBSOCKETS, AWSGI, BJAVA, BJAVNAT, BJAVPER, BJAVXEP, BJSNAT, BNET, BNETNAT, BNETODBC, BNETXEP, BPYNAT, BSPK, BTPI, BXCI, GAUTOML, GCONV, GCSP, GICM, GIKNOW, GIML, GISQ, GISR, GSCF, GSQLSRCH, GTSQ, GUIMA, PAGE_activex, PAGE_administration, PAGE_apimgr, PAGE_appdev_ides, PAGE_bi, PAGE_cachedirect, PAGE_data_migration, PAGE_data_science, PAGE_deployment, PAGE_deployment_configuration, PAGE_deployment_containers, PAGE_deployment_icm, PAGE_deployment_iko, PAGE_deployment_install, PAGE_dotnet, PAGE_dotnet_native, PAGE_dsvr, PAGE_embedded_language_development, PAGE_epython, PAGE_external_language_development, PAGE_interop, PAGE_interop_lifecycle, PAGE_interop_vdoc, PAGE_interoperability, PAGE_java, PAGE_java_jdbc, PAGE_java_native, PAGE_machine_learning, PAGE_monitoring, PAGE_multimodel, PAGE_multimodel_multidimensional, PAGE_multimodel_object, PAGE_multivalue, PAGE_native, PAGE_nodejs_native, PAGE_objectscript, PAGE_objectscript_ides, PAGE_odbc, PAGE_platform_arch_design, PAGE_pygate, PAGE_python, PAGE_python_native, PAGE_reports, PAGE_scalability, PAGE_security_authentication, PAGE_security_authorization, PAGE_studio, PAGE_zen, PAGE_zenmojo, PAGE_zenreports
FeedbackOpens in a new tab