4.3 Silently Installing One SSO Provider

A silent (non-interactive) installation does not display a user interface or ask the user any questions. The installation kit provides the osp-install-silent.properties file. To prepare for the installation, review the considerations and system requirements listed in the following sections:

To perform a guided installation, see Using the Wizard to Install One SSO Provider.

4.3.1 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 OSP_Install.log file that the guided installation creates.

  1. After installing OSP on the primary node, locate the osp_install_log.log file.

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

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

  2. Locate the sample osp-install-silent.properties file, by default in the same directory as the installation scripts for OSP.

  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.

    Your silent properties file should contain all the parameters listed between User Interactions and Summary in the log file.

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

    Log file

    Silent.properties file

    0

    false

    1

    true

  6. Change the values for the NetIQ servlet and auditing protocols as specified in the following table:

    Log file

    Silent.properties file

    • NETIQ_SERVLET_PROTOCOL_HTTP=1
    • NETIQ_SERVLET_PROTOCOL_HTTPS=0

    NETIQ_SERVLET_PROTOCOL=http

    • NETIQ_SERVLET_PROTOCOL_HTTP=0
    • NETIQ_SERVLET_PROTOCOL_HTTPS=1

    NETIQ_SERVLET_PROTOCOL=https

    • NETIQ_OSP_AUDIT_PROTOCOL_TCP=1
    • NETIQ_OSP_AUDIT_PROTOCOL_TLS=0
    • NETIQ_OSP_AUDIT_PROTOCOL_UDP=0

    NETIQ_OSP_AUDIT_PROTOCOL=tcp

    • NETIQ_OSP_AUDIT_PROTOCOL_TCP=0
    • NETIQ_OSP_AUDIT_PROTOCOL_TLS=1
    • NETIQ_OSP_AUDIT_PROTOCOL_UDP=0

    NETIQ_OSP_AUDIT_PROTOCOL=tls

    • NETIQ_OSP_AUDIT_PROTOCOL_TCP=0
    • NETIQ_OSP_AUDIT_PROTOCOL_TLS=0
    • NETIQ_OSP_AUDIT_PROTOCOL_UDP=1

    NETIQ_OSP_AUDIT_PROTOCOL=udp

  7. Save and close the files.

4.3.2 Running a Silent Installation

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

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

  3. (Conditional) If you have the .iso image file for the Identity Governance installation package, navigate to the directory containing the OSP installation files, located by default in the osp directory.

  4. (Conditional) If you downloaded the installation files from the NetIQ Downloads website, complete the following steps:

    1. Navigate to the .zip file for the downloaded image.

    2. Extract the contents of the file to a folder on the local computer.

  5. Locate the osp-install-silent.properties file, by default in the same directory as the OSP installation file

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

    1. In a text editor, open the silent properties file.

    2. Specify the parameter values.

      For more information about the settings for installation, see Step 5 through Step 6.

    3. Save and close the file.

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

  8. To run the silent installation:

    • Linux: Issue the following command:

      ./osp-install-linux.bin -i silent -f path_to_silent_properties_file
    • Windows: From a command prompt enter, osp-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.