This section guides you through the process of installing Tomcat and PostgreSQL.
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:
Release Notes accompanying the release
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:
Log in as an administrator to the computer where you want to install the applications.
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.
(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.
(Conditional) If you downloaded the installation files from the NetIQ Downloads website, complete the following steps:
Navigate to the win.zip file for the downloaded image.
Extract the contents of the file to a directory on the local computer.
From the directory that contains the installation files, run TomcatPostgreSQL.exe.
In the installation program, specify the language that you want to use for installation, and then click OK.
Review the introductory information, and then click Next.
Accept the License Agreement, and then click Next.
Specify whether you want to install Tomcat, PostgreSQL, or both.
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.
Specifies the port that you want to use for cleanly shutting down all webapps and Tomcat. The default is 8005.
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.
(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.
(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.
Specifies the name of the database. The default value is idmuserappdb.
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.
Specifies the password for the database administrator and the default postgres user.
This installation program does not support passwords that include a " or $ character.
Specifies the port of the server that hosts the Postgres database. The default value is 5432.
Review the pre-installation summary.
Start the installation process.
When the installation process completes, click Done.
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:
Release Notes accompanying the release
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.
Log in to the computer where you want to install the applications.
(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.
(Conditional) If you downloaded the installation files from the NetIQ Downloads website, complete the following steps:
Navigate to the win.zip file for the downloaded image.
Extract the contents of the file to a directory on the local computer.
To specify the installation parameters, complete the following steps:
Ensure that the postgresq_tomcat-silent.properties file is located in the same directory as the execution file for installation.
In a text editor, open the postgresq_tomcat-silent.properties file.
Specify the parameter values. For a description of the parameters, see Step 10.
Save and close the file.
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.