14.2 Uninstalling Components Installed with the Identity Governance Installer

The installation utility for Identity Governance, Identity Reporting, and Workflow Engine places an uninstall utility on the server. The uninstall utility uninstalls Identity Governance, Identity Reporting, and Workflow Engine, or Identity Governance and its components if you install the components at the same time. The uninstall utility provides the guided uninstall, the console uninstall, and the silent uninstall just like the installer utility does.

If you install Identity Governance and its components at separate times, the uninstall utility uninstalls the component that you installed last. For example, if you only installed Identity Governance and ran the system for a while and then installed Identity Reporting or Workflow Engine on the same server, the uninstall utility uninstalls Identity Reporting or Workflow Engine when you run it. You must run the utility a second time to uninstall Identity Governance.

The default mode of the uninstall utility is the method that you used to install Identity Governance or Identity Governance and Identity Reporting. 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.

To uninstall Identity Governance:

  1. Log in to the server running Identity Governance as root on a Linux server or as a user with administrative privileges on a Windows server.

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

    IMPORTANT:If you do not define the path to the jre bin directory, the uninstall utility does not work. The utility does not come with Java. You must point to the Java you use with Identity Governance.

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

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

      • Windows: c:\netiq\idm\apps\idgov\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 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.5.3, Starting and Stopping Apache Tomcat.

  4. (Conditional) If you are running any version of Identity Governance prior to 3.0, you must uninstall Identity Reporting separately from Identity Governance.

    1. (Conditional) Uninstall Identity Reporting on a Linux server.

      1. Access the uninstall directory. The default location is: /opt/netiq/idm/apps/idrpt/Uninstall_IdentityGovernance

      2. To execute the script, enter:

        ./LaunchUninstall.sh

    2. (Conditional) Uninstall Identity Reporting on a Windows server.

      1. Access the Control Panel as an administrator.

      2. Search for Identity Reporting.

      3. Click Uninstall and follow the prompts to uninstall Identity Reporting.

  5. (Conditional) Uninstall Identity Governance or uninstall Identity Governance and Identity Reporting or Workflow Engine if your version of Identity Governance is 3.0 or later.

    1. (Conditional) Uninstall Identity Governance or Identity Governance and Identity Reporting or Workflow Engine from a Linux server.

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

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

        ./LaunchUninstall.sh

    2. (Conditional) Uninstall Identity Governance or uninstall Identity Governance and Identity Reporting or Workflow Engine on a Windows server.

      1. Access the Control Panel as an administrator.

      2. Search for and select Identity Governance.

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

  6. (Conditional) If you installed Identity Governance and Identity Reporting or Workflow Engine at different times on the same server, run the uninstall utility a second time to delete the component you installed first.

  7. When the uninstallation completes, delete the following folders. The uninstall utility restores the *.war files that were in this directory before you installed Identity Governance.

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

      • /opt/netiq/idm/apps/idgov

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

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

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

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

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

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

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

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

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

      • (Conditional) If you installed Identity Reporting on the same server as Identity Governance, you must delete the following files and folders that Identity Reporting installed.

        • /opt/netiq/idm/apps/idrpt

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

        • /opt/netiq/idm/apps/tomcat/webapps/IDMRPT-CORE

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

      • (Conditional) If you installed Workflow Engine on the same server as Identity Governance, you must delete the following files and folders that Workflow Engine installed.

        • /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\idgov

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

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

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

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

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

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

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

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

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

      • (Conditional) If you installed Identity Reporting on the same server as Identity Governance, you must delete the following files and folders that Identity Reporting installed.

        • C:\netiq\idm\apps\idrpt

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

        • C:\netiq\idm\apps\tomcat\webapps\IDMRPT-CORE

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

      • (Conditional) If you installed Workflow Engine on the same server as Identity Governance, you must delete the following files and folders that Workflow Engine installed.

        • C:\netiq\idm\apps\wfe

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

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

        • 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

  8. Restart Apache Tomcat, if needed. For more information, see Section 3.5.3, Starting and Stopping Apache Tomcat.