5.6 Performing a Silent Installation of Identity Governance

A silent (non-interactive) installation does not display a user interface or ask the user any questions. Instead, the system uses information from the identity-governance-silent.properties file, included in the installation package. You must edit the file before beginning the installation process.

This section provides guidances for the following activities:

To prepare for the installation, review the considerations and system requirements listed in the following sections:

To perform a guided installation, see Using a Guided Process to Install Identity Governance and Identity Reporting.

5.6.1 Understanding the Passwords that Identity Governance Reads from Environment Variables During the Installation Process

Identity Governance reads in the following passwords from environment variables during the silent installation process. You must set these in the silent properties file.

  • install_authserver_client_secret: It is the password for OSP.

  • install_bootstrap_secret: It is the password for the bootstrap administrator.

  • install_db_admin_secret: It is the password for the database administrator.

  • install_db_secret: It is the password for igops, igdcs, igwf, and igara.

  • install_db_rpt_secret: It is the password for igrptuser.

  • install_db_reporting_secret: It is the password for idm_rpt_cfg.

  • install_truststore_secret: It is the password for cacerts.

  • install_smtp_password_auth_user: It is the password for the SMPT authentication user. If you SSL for SMTP, then you can enter it in the silent properties file or leave it empyt and enter it later.

5.6.2 Creating a Silent Properties File for Installing on a Secondary Node

In a clustered environment, you can use the same silent properties file for each node. However, you might choose to run the guided installation on the primary node, then silently install on the secondary nodes. You can quickly create a silent properties file from the Identity_Governance_InstallLog.log file that the guided installation creates.

  1. Locate the Identity_Governance_InstallLog.log file:

    • Linux: Default location of /opt/netiq/idm/apps/idgov/logs

    • Windows: Default location of c:\netiq\idm\apps\idgov\logs

  2. Locate the sample identity-governance-install-silent.properties file, by default in the same directory as the installation scripts for Identity Governance.

  3. Open the files in a text editor.

  4. Copy the parameter values from the log file to their corresponding parameters in the silent properties file.

    The silent properties file should contain all the parameters listed between User Interactions and Summary in the log file. Do not delete INSTALLER_UI=silent or any content after # When to Configure DB?.

  5. Change the values that represent the true/false settings:

    Log file

    Silent.properties file

    0

    false

    1

    true

  6. Change the values as specified in the following table:

    Log file

    Silent.properties file
    • install_servlet_protocol_http=1
    • install_servlet_protocol_https=0

    install_servlet_protocol=http
    • install_servlet_protocol_http=0
    • install_servlet_protocol_https=1

    install_servlet_protocol=https
    • install_authserver_protocol_http=1
    • install_authserver_protocol_https=0

    install_authserver_protocol=http
    • install_authserver_protocol_http=0
    • install_authserver_protocol_https=1

    install_authserver_protocol=https

  7. To prevent the installation process from creating or configuring the database, specify no for install_db_configure and leave install_db_create blank.

    For example:

    # When to Configure DB?
# Allowable values:
#   during - Perform configuration during installation
#   after  - Perform configuration post install, via a generated SQL script
#   no     - Do not perform DB configuration
install_db_configure=no

# Create DB?
# If performing the DB configuration during installation,
# should the installer also create the database
# or should it use an existing database.
#
# Allowable values:
#    true  - Create the database.
#    false - Use an existing database.
install_db_create=

    The installation process only needs the values for the databases under #Database details.

  8. Save and close the file.

5.6.3 Running the Silent Installation

  1. Log in as root on Linux server or an administrator on Windows server where you want to install Identity Governance.

  2. Stop Tomcat. For examples, see Stopping, Starting, and Restarting Tomcat.

  3. Locate the sample identity-governance-install-silent.properties file, by default in the same directory as the installation scripts for Identity Governance.

  4. (Conditional) In a non-clustered environment or when installing on the primary node, complete the following steps:

    1. In a text editor, open the identity-governance-install-silent.properties file.

    2. Specify the parameter values. For a description of the parameters, see Step 7.

    3. Save and close the file.

  5. (Conditional) When installing on a secondary node in a cluster, you can create the .properties file using the steps in Creating a Silent Properties File for Installing on a Secondary Node.

  6. To launch the installation program, enter the following command:

    • Linux: ./identity-governance-install-linux.bin -i silent -f path_to_silent_properties_file

    • Windows: From a command line, enter: identity-governance-install-win.exe -i silent -f path_to_silent_properties_file.

    NOTE:If the silent properties file is in a different directory from the installation script, you must specify the full path to the file. The script unpacks the necessary files to a temporary directory and then launches the silent installation.

  7. When the installation process completes, continue to Section 7.0, Completing the Installation Process.

    NOTE:Do not start Tomcat.