UNIX®, Linux, and macOS Unattended Installation

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:

• If root is unavailable, you can perform a non-standard, limited InterSystems IRIS installation as a nonroot user. See Installing InterSystems IRIS as a Nonroot User before continuing.

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:

• Include any other parameters. See Unattended Installation Parameters for details.

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:

• Execute the command you created in the above steps.

• Proceed to Post-Installation.