8.2 Installing PostgreSQL and Tomcat

This section guides you through the process of installing Tomcat and PostgreSQL.

8.2.1 Using the Wizard to Install PostgreSQL and Tomcat

The following procedure describes how to install Tomcat and PostgreSQL on a Windows platform using a guided process. To perform a silent, unattended installation, see Silently Installing Tomcat and PostgreSQL for Identity Manager.

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

NOTE:Whether you install PostgreSQL or use an existing version of PostgreSQL, you must specify passwords for the database. However, this installation program does not support passwords that include a " or $ character. To use these special characters, change the password after you complete the installation process.

To perform a guided installation:

  1. Log in as an administrator to the computer where you want to install the applications.

  2. Ensure that the planned installation path does not include directories with any of the following names:

    • tomcat

    • postgres

    • activemq

    • jre

    NOTE:While installing Standard Edition, you must install ActiveMQ. Otherwise, the Reporting page does not load after you log in to Identity Reporting. Alternatively, copy the activemq-all-5.15.2 jar file into C:\NetIQ\idm\apps\tomcat\lib directory after completing the PostgreSQL installation and then restart Tomcat.

  3. (Conditional) If you have the .iso image file for the Identity Manager installation package, navigate to \products\CommonApplication\postgre_tomcat_install directory containing the installation files.

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

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

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

  5. From the directory that contains the installation files, run TomcatPostgreSQL.exe.

  6. In the installation program, specify the language that you want to use for installation, and then click OK.

  7. Review the introductory information, and then click Next.

  8. Accept the License Agreement, and then click Next.

  9. Specify whether you want to install Tomcat, PostgreSQL, or both.

  10. To complete the guided process, specify values for the following parameters:

    • Tomcat parent folder

      Applies only when installing Tomcat.

      Specifies the directory where you want to install the Tomcat files.

    • Tomcat details

      Applies only when installing Tomcat.

      Represents the ports needed for Tomcat.

      Tomcat shutdown port

      Specifies the port that you want to use for cleanly shutting down all webapps and Tomcat. The default is 8005.

      Tomcat http port

      Specifies the port that you want the Tomcat server to use for communication with client computers. The default is 8080. To use SSL, the default is 8443.

      Tomcat redirect port

      (Conditional) When you do not use TLS/SSL protocols, specifies the port to which the application server redirects requests that require SSL transport. The default value is 8443.

      Tomcat ajp port

      (Optional) Specifies the port that you want the application server to use for communication with a web connector using the AJP protocol instead of http. The default value is 8009.

      Use this parameter when you want the application server to manage the static content contained in the web application, and/or utilize the application server’s SSL processing.

    • PostgreSQL parent folder

      Applies only when installing PostgreSQL.

      Represents the directory where you want to install the PostgreSQL files.

    • PostgreSQL details

      Applies only when installing PostgreSQL.

      Represents the settings for the PostgreSQL database for the identity applications.

      NOTE:If you already have a supported version of PostgreSQL running on the server, the installation program prompts you for the password for the default postgres user. The program then creates the idmadmin user and assigns it the same password as for postgres.

      This installation program does not support passwords that include a " or $ character.

      Database name

      Specifies the name of the database. The default value is idmuserappdb.

      Database admin

      Specifies the idmadmin account, which is a database administrator that can create database tables, views, and other artifacts.

      This account is not the same as the default postgres user.

      Password for admin user

      Specifies the password for the database administrator and the default postgres user.

      This installation program does not support passwords that include a " or $ character.

      PostgreSQL port

      Specifies the port of the server that hosts the Postgres database. The default value is 5432.

  11. Review the pre-installation summary.

  12. Start the installation process.

  13. When the installation process completes, click Done.

8.2.2 Silently Installing Tomcat and PostgreSQL for Identity Manager

A silent (non-interactive) installation does not display a user interface or ask the user any questions. Instead, InstallAnywhere uses information from a default silent.properties file. You can run the silent installation with the default file or edit the file to customize the installation process. For a guided installation, see Using the Wizard to Install PostgreSQL and Tomcat.

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

Safeguarding the Passwords for a Silent Installation

If you do not want to specify the passwords in the postgresq_tomcat-silent.properties file for the installation, you can set the passwords in the environment instead. In this case, the silent installer will read the passwords from the environment, rather than from the postgresq_tomcat-silent.properties file. This can provide some additional security.

You must specify the following passwords for the installation:

  • NETIQ_DB_PASSWORD

  • NETIQ_DB_PASSWORD_CONFIRM

Use the set command. For example:

set NETIQ_DB_PASSWORD_CONFIRM=myPassWord

The installation program does not support passwords that include a " for $ character. To use these special characters, change the password after installing PostgreSQL.

Silently Installing Tomcat and PostgreSQL

  1. Log in to the computer where you want to install the applications.

  2. (Conditional) If you have the .iso image file for the Identity Manager installation package, navigate to \products\CommonApplication\postgre_tomcat_install directory containing the installation files.

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

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

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

  4. To specify the installation parameters, complete the following steps:

    1. Ensure that the postgresq_tomcat-silent.properties file is located in the same directory as the execution file for installation.

    2. In a text editor, open the postgresq_tomcat-silent.properties file.

    3. Specify the parameter values. For a description of the parameters, see Step 10.

    4. Save and close the file.

  5. To launch the installation process, enter the following command:

                      TomcatPostgreSQL -i silent -f postgresq_tomcat-silent.properties

    NOTE:If the postgresq_tomcat-silent.properties file resides 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.