3.2 Using the Wizard to Install Tomcat, PostgreSQL, and ActiveMQ

The following procedure describes how to install Tomcat, PostgreSQL, and ActiveMQ using a guided process, either in the GUI format or from the console. To prepare for the installation, review the considerations and system requirements listed in the following sections:

To perform a silent, unattended installation, see Silently Installing Tomcat, PostgreSQL, and ActiveMQ.

To perform a guided installation:

  1. Log in as root on Linux server or an administrator on Windows server 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

    For example, if you want to add this version of Postgres to a server while keeping a previous version of Postgres, create an installation path separate from the other version.

  3. 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 (console): Enter cmd /c "TomcatPostgreSQL.exe -i console"

    • Windows (GUI): Double-click TomcatPostgreSQL.exe

    NOTE:To execute the file, you might need to use the chmod +x or sh command for Linux or log in to your Windows server as an administrator.

  4. Review the introductory information, and then select Next.

  5. Accept the License Agreement, and then select Next.

  6. Specify the components that you want to install: Tomcat, PostgreSQL, and ActiveMQ.

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

    • Tomcat install folder

      Applies only when installing Tomcat.

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

    • Tomcat details

      Applies only when installing Tomcat.

      Specifies the ports needed for running Tomcat.

      Tomcat shutdown port

      Specifies the port that you want to use for cleanly shutting down all web applications 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.

      NOTE:By default on Linux, a non-root user cannot open a port under 1024. NetIQ recommends running Tomcat as non-root. Therefore, if you change the port from the default, you should use a port above 1024.

      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. For more information, see SSL/TLS Configuration HOW-TO in the Tomcat documentation.

      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.

    • ActiveMQ install folder

      Applies only when installing ActiveMQ.

      Specifies the parent directory where you want to install the ActiveMQ files.

    • PostgreSQL install folder

      Applies only when installing PostgreSQL.

      Specifies the parent directory where you want to install the PostgreSQL files.

    • PostgreSQL details

      Applies only when installing PostgreSQL.

      Specifies 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 database admin user and assigns it the same password as for postgres.

      Password for postgres user

      Specifies the password for the default postgres user and database login account, if created.

      PostgreSQL port

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

      Login account

      Applies only when you select Create database login account.

      Specifies the database administrator that can create database tables, views, and other artifacts.

      The default value is idmadmin, which corresponds with the default database administrator for the identity applications component of Identity Manager.

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

      Database name

      Applies only when you select Create empty database.

      Specifies the name of the database.

      The default value is idmuserappdb, which corresponds with the default database for the identity applications component of Identity Manager.

  8. Review the pre-installation summary.

  9. Start the installation process.

  10. When the installation process completes, select Done.