14.4 Uninstalling the Workflow Engine

The installation utility for Identity Governance and the Workflow Engine places an uninstall utility on the server for the Workflow Engine. If you have installed the Workflow Engine on a separate server, use the uninstall utility that was installed when you install the Workflow Engine.

If you installed the Workflow Engine on the same server as Identity Governance you must use the Identity Governance uninstall utility to uninstall the Workflow Engine and Identity Governance. For more information, see Section 14.2, Uninstalling Components Installed with the Identity Governance Installer.

While uninstalling, you must uninstall the features in the reverse order in which you installed them. For example, if you installed Identity Governance, then Workflow Engine, you must uninstall Workflow Engine, then Identity Governance.

The Workflow Engine uninstall utility provides the guided uninstall, the console uninstall, and the silent uninstall just like the installer utility does. The default mode of the uninstall utility is the method that you used to install. If you want to uninstall using a different method you must pass the appropriate parameter to perform that type of uninstallation. For more information, see Section 1.3, Understanding the Uninstallation Methods.

If the Workflow Engine is on the same server as Identity Governance and the Workflow Engine impacts the performance of Identity Governance, you can move the Workflow Engine to a separate server. For more information, see Section 13.6, Moving Workflow Engine to a Separate Server.

Use the following procedure to uninstall the Workflow Engine if you installed on a separate server from Identity Governance.

To uninstall the Workflow Engine when it is installed on a separate server from Identity Governance

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

  2. Define the Java path to the jre/bin directory as an environment variable in the uninstall script file that launches the uninstall utility.

    1. Open the uninstall script file in a text editor. The default location is:

      • Linux: /opt/netiq/idm/apps/wfe/Uninstall_IdentityGovernance/LaunchUninstall.sh

      • Windows: c:\netiq\idm\apps\wfe\Uninstall_IdentityGovernance\LaunchUninstall.bat

    2. Change or ensure that the path listed for the JRE_HOME variable is the path to the jre/bin directory for the Zulu JRE that is installed with the Zulu OpenJDK. The default path is:

      • Linux: /opt/netiq/idm/apps/jre/bin

      • Windows: c:\netiq\idm\apps\jre\bin

    3. Save and close the file.

  3. Stop Apache Tomcat. For more information, see Section 3.4.3, Starting and Stopping Apache Tomcat.

  4. Uninstall Workflow Engine if your version of Identity Governance is 3.0 or later.

    1. (Conditional) Uninstall Workflow Engine from a Linux server.

      1. Access the uninstall directory located here: /opt/netiq/idm/apps/wfe/Uninstall_IdentityGovernance

      2. Execute the script as root from a command line enter the following:

        ./LaunchUninstall.sh

    2. (Conditional) Uninstall Workflow Engine on a Windows server.

      1. Access the Control Panel as an administrator.

      2. Search for Workflow Engine

      3. Select Uninstall and follow the prompts to complete the uninstallation.

  5. When the uninstallation completes, delete the following folders.

    NOTE:The uninstall utility restores the *.war files that were in this directory before you installed the Workflow Engine.

    • Linux: The default path is /opt/netiq/idm/apps:

      • /opt/netiq/idm/apps/wfe

      • /opt/netiq/idm/apps/tomcat/webapps/wfconsole

      • /opt/netiq/idm/apps/tomcat/webapps/wfdocs

      • /opt/netiq/idm/apps/tomcat/webapps/workflow

        Delete the contents of the following folders including any subdirectories:

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

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

    • Windows: The default path is C:\netiq\idm\apps:

      • C:\netiq\idm\apps\wfe

      • C:\netiq\idm\apps\tomcat\webapps\wfconsole

      • C:\netiq\idm\apps\tomcat\webapps\wfdoc

      • C:\netiq\idm\apps\tomcat\webapps\workflow

      Delete the contents of the following folders including any subdirectories:

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

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

  6. Restart Apache Tomcat, if needed. For more information, see Section 3.4.3, Starting and Stopping Apache Tomcat.