14.3 Uninstalling Identity Reporting

The installation utility for Identity Governance and Identity Reporting places an uninstall utility on the server for Identity Reporting if you installed Identity Reporting on a separate server from Identity Governance. If you installed Identity Reporting on the same server as Identity Governance you must use the Identity Governance uninstall utility to uninstall Identity Reporting and Identity Governance. For more information, see Section 14.2, Uninstalling Components Installed with the Identity Governance Installer.

You would uninstall Identity Reporting if you want to move to new hardware, you want to run Identity Reporting on a separate server, or if you are upgrading to the latest version of Identity Governance. If you install Identity Reporting on a separate server, use the uninstall utility that was installed when you installed Identity Reporting to uninstall it.

If you installed Identity Reporting on the same server as Identity Governance and Identity Reporting impacts the performance of Identity Governance, you can move Identity Reporting to a separate server but it is a process. For more information, see Section 13.5, Moving Identity Reporting to a Separate Server.

The Identity Reporting 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 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.

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

To uninstall Identity Reporting when it is installed on a separate server from Identity Governance:

  1. Log in to the server running Identity Reporting 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 is:

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

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

  4. (Conditional) If you are running any version of Identity Governance prior to 3.0, you must use a different uninstall utility for Identity Reporting.

    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 Reporting if your version of Identity Governance is 3.0 or later.

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

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

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

        ./LaunchUninstall.sh

    2. (Conditional) Uninstall Identity Reporting 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. When the uninstallation completes, delete the following folders. The uninstall utility restores the *.war files that were in this directory before you installed Identity Reporting.

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

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

      • 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\idrpt

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

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

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

      • Delete the contents of the following folders including any subdirectories.

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

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

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