8.3 Installing Workflow Engine on a Separate Server

This procedure describes how to install Workflow Engine for Identity Governance using the guided method or the console method. You can also perform a silent installation by using the silent properties file.

To prepare for the installation, review the prerequisites and system requirements.

  1. Log in as an administrator on the server where you want to install the Workflow Engine.

    NOTE:The Workflow Engine requires you to log in as root on the Linux server or an administrator on the Windows server to complete the installation successfully.

  2. Ensure that you have a copy of the installer on this server. For more information, see Section 2.2, Obtaining Identity Governance, Identity Reporting, Workflow Engine, and OSP.

  3. If you are using an unsecured environment, stop Apache Tomcat. Otherwise you need Apache Tomcat running so the certificates can be retrieved during Step 9.

  4. From the directory that contains the installation files, complete one of the following actions:

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

    • Linux: Enter one of the following commands from a command prompt:

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

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

    • Windows: Enter the following from a command prompt:

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

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

  5. Read and accept the License Agreement.

  6. Select Workflow Engine for the install set.

  7. Use the information you gathered in Section 8.2, Workflow Engine Installation Worksheet to complete the installation.

  8. Review the pre-installation summary.

  9. (Conditional) In a secured (TLS) environment, stop Apache Tomcat. For more information, see Section 3.4.3, Starting and Stopping Apache Tomcat.

  10. Start the installation process.

  11. When the installation process completes, review the Workflow Engine logs. The default location of the logs is here:

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

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

  12. Before starting Apache Tomcat again, delete the contents of the following two directories from Apache Tomcat that contain cached files. The directories are:

    • Linux: Default installation location:

      • /opt/netiq/idm/apps/tomcat/temp

      • /opt/netiq/idm/apps/tomcat/work/Catalina/localhost

    • Windows: Default installation location:

      • C:\netiq\idm\apps\tomcat\temp

      • C:\netiq\idm\apps\tomcat\work\Catalina\localhost

  13. Proceed to Section 9.0, Completing the Installation Process.