25.1 Using the Wizard to Install PostgreSQL and Tomcat

The following procedure describes how to install Tomcat and PostgreSQL on a Linux or Windows platform using a guided process, either in the GUI format or from the console. To perform a silent, unattended installation, see Section 25.2, 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 root or 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

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

    • Linux: products/RBPM/postgre_tomcat_install/

    • Windows: products/RBPM/postgre_tomcat_install

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

    1. Navigate to the .tgz or 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, complete one of the following actions:

    • Linux (console): Enter ./TomcatPostgreSQL.bin -i console

    • Linux (GUI): Enter ./TomcatPostgreSQL.bin

    • Windows: 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.