1.2 Understanding the Installation Methods

Identity Governance and OSP provide multiple installation methods.The following information applies to both the OSP installer and the Identity Governance installer. Select which method you want to use, depending on your environment. The different installation methods are the guided installation, the console installation, and the silent installation. You must provide the same information no matter which installation method you use.

For example, if you do not have X server installed on the server that hosts Identity Governance, you would use console mode. If you have multiple installations to perform, we recommend that you use guided mode for the first server and silent mode for the remaining servers.

The installers for the Identity Governance components install the components in the following default directories no matter which installation method you choose to use. You can change these directories during the different installation methods. The default installation paths are:

  • OSP: Default installation directory

    • Linux: /opt/netiq/idm/apps/osp

    • Windows: C:\netiq\idm\apps\osp

  • Identity Governance: Default installation directory

    • Linux: /opt/netiq/idm/apps/idgov

    • Windows: C:\netiq\idm\apps\idgov

  • Identity Reporting: Default installation directory

    • Linux: /opt/netiq/idm/apps/idrpt

    • Windows: C:\netiq\idm\apps\idrpt

Use the following information to determine which method works best for your environment.

1.2.1 Understanding the Sample Installation Scripts

Identity Governance requires multiple products to be installed, configured, and running before you start the Identity Governance installation. NetIQ provides some sample installation scripts that you can download, edit, and then use to install some of the required components before starting the Identity Governance installation.

The sample scripts install the following components:

  • Apache ActiveMQ

  • Apache Tomcat

  • Zulu OpenJDK

The Linux sample script does not install the PostgreSQL database. You must have a database installed before starting the Identity Governance installation. For more information, see Section 5.0, Creating Databases for Identity Governance and Identity Reporting.

The sample installation scripts are located on the Identity Governance documentation page under the References heading. You must download the scripts, extract the ZIP file, and then read the Readme.txt file. The file contains the instructions on how to use the sample scripts.

The sample scripts place all of the files for the installations in the following default directory:

  • Linux: /opt/netiq/idm/apps/

  • Windows: C:\netiq\idm\apps\

The OSP, Identity Governance, and Identity Reporting installers use this as a default location as well. This guide lists these default directories to help you know where to access the different products, configuration files, and the tools to manage Identity Governance. You can choose to change this default path by editing the installation scripts or changing the path when you run the installers.

1.2.2 Understanding the Guided Installation

The default installer utility for OSP, Identity Governance, and Identity Reporting is an interactive installation with a guided interface. This installer guides you through the installation by asking questions you must answer. To use the guided installation utility on a Linux server you must have X server enabled to display the guided installation. You must interact with the guided installation utility to have the installation finished successfully.

To run the guided installation, you launch the installer from the command line with no additional parameters. For example:

  • OSP: Use the following command for your platform.

    • Linux: ./osp-install-linux.bin

    • Windows: osp-install-win.exe

  • Identity Governance and Identity Reporting: Use the following command for your platform.

    • Linux: ./identity-governance-install-linux.bin

    • Windows: identity-governance-install-win.exe

The information you must provide to complete the installation is the same whether you use the guided installation, the console installation, or the silent installation. For more information, see the following sections:

1.2.3 Understanding the Console Installation

Identity Governance provides an interactive, console installation for OSP, Identity Governance, and Identity Reporting without requiring graphics to be enabled on the servers that run these products. This allows you to complete the installation without enabling X server on the Linux servers.

To run the installation in console mode, you launch the installer from the command line with the -i console parameter. For example:

  • OSP: Use the following command for your platform.

    • Linux: ./osp-install-linux.bin -i console

    • Windows: osp-install-win.exe -i console

  • Identity Governance and Identity Reporting: Use the following command for your platform.

    • Linux: ./identity-governance-install-linux.bin -i console

    • Windows: identity-governance-install-win.exe -i console

The information you must provide to complete the installation is the same whether you use the guided installation, the console installation, or the silent installation. For more information, see:

1.2.4 Understanding the Silent Installation

Identity Governance provides two files that allow you to install Identity Governance, OSP, and Identity Reporting without any interaction. The files are included in the ZIP files that you download for Identity Governance and OSP. You install Identity Reporting using the Identity Governance file. The two files are:

  • Identity Governance and Identity Reporting: identity-governance-install-silent.properties

  • OSP: osp-install-silent.properties

You can use these file if you have multiple installations to perform or you do not want to interact with the installation utility. You can also use the silent installation to install additional nodes when you cluster the components. For more information, see Section 2.3.4, Ensuring High Availability or Load Balancing for Identity Governance.

To use the file, you open the file in a text editor and define the different parameters for your environment. You can use the default paths listed in the sample installation scripts for the required components or you can define different paths. The default paths are:

  • OSP: Default installation directory

    • Linux: /opt/netiq/idm/apps/osp

    • Windows: C:\netiq\idm\apps\osp

  • Identity Governance: Default installation directory

    • Linux: /opt/netiq/idm/apps/idgov

    • Windows: C:\netiq\idm\apps\idgov

  • Identity Reporting: Default installation directory

    • Linux: /opt/netiq/idm/apps/idrpt

    • Windows: C:\netiq\idm\apps\idrpt

We recommend that you perform a guided installation with the -r path-to-response-file option to create a response file containing the correctly formatted values for your environment that you must add to the silent properties file. You can open the response file and copy the parameters from the response file to the silent properties file to simplify the process of creating the silent properties file. For example:

  • OSP: Use the following command for your platform.

    • Linux: ./osp-install-linux.bin -r path_to_silent_properties_file

    • Windows: osp-install-win.exe -r path_to_silent_properties_file

  • Identity Governance and Identity Reporting: Use the following command for your platform.

    • Linux: ./identity-governance-install-linux.bin -r path_to_silent_properties_file

    • Windows: identity-governance-install-win.exe -r path_to_silent_properties_file

After you have created the response file, open the response file and the silent properties file in a text editor. Copy the properly formatted values for your environment from the response file to the silent properties file.

After you have created the silent properties file with the proper values, you use this file in conjunction with the installer utility. When you launch the installer utility, you pass this file as a parameter. The installer uses the information in the silent properties file to complete the installation. For example, from the directory where you have the installation files enter the following:

  • OSP: Use the following command for your platform.

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

    • Windows: osp-install-win.exe -i silent -f path_to_silent_properties_file

  • Identity Governance and Identity Reporting: Use the following command for your platform.

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

    • Windows: identity-governance-install-win.exe -i silent -f path_to_silent_properties_file

For more information, see the following sections: