UNIX®, Linux, and macOS Unattended Installation

Unattended Installation Overview

Default:

• You can perform unattended installation 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 a 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_UNICODE="Y"|"N"
 ISC_PACKAGE_INITIAL_SECURITY="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 installation as a nonroot user. See Installing 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 a 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:

• Installs in “normal” security mode with Superserver port 59992.

  sudo ISC_PACKAGE_INSTANCENAME="<instancename>"
   ISC_PACKAGE_INSTALLDIR="<installdir>"
   ISC_PACKAGE_USER_PASSWORD="<password>"
   ISC_PACKAGE_SUPERSERVER_PORT="59992"
   ISC_PACKAGE_INITIAL_SECURITY="Normal"
   ./irisinstall_silent [<pkg> ...]
  

  

• Installs all 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, not for a production installation.

  sudo ISC_PACKAGE_INSTANCENAME="<instancename>"
   ISC_PACKAGE_INSTALLDIR="<installdir>"
   ISC_PACKAGE_USER_PASSWORD="<password>"
   ISC_PACKAGE_INITIAL_SECURITY="Normal"
   ISC_PACKAGE_MGRUSER="admin1"
   ISC_PACKAGE_MGRGROUP="admin"
   ISC_PACKAGE_WEB_CONFIGURE="Y"
   ISC_PACKAGE_WEB_SERVERTYPE="Apache"
   ./irisinstall_silent [<pkg> ...]
  

  

Step 6: Execute Command

Default:

• Execute the command you created in the above steps.

• Proceed to Post-Installation.