13.1 Uninstalling OSP

The installation utility for OSP places an uninstall utility on the server. You must run this utility to uninstall OSP. If you installed OSP on the same server as Identity Governance or if you have installed it on a separate server, you must use the OSP uninstall utility to uninstall OSP. The Identity Governance uninstall utility does not uninstall OSP. You would uninstall OSP if you wanted to install OSP on a separate server from Identity Governance or if you were upgrading to the current version of Identity Governance.

IMPORTANT:You must always use the version of OSP that comes with the version of Identity Governance that you are using. Trying to use different versions of OSP causes unexpected behavior and is not supported.

The default mode of the uninstall utility is the mode that you used to install OSP. If you want to uninstall using a different method you must pass the appropriate parameter to perform that type of uninstall. For more information, see Section 1.3, Understanding the Uninstallation Methods.

To uninstall OSP:

  1. Log in to the server running OSP 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 OSP.

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

      • Linux: /opt/netiq/idm/apps/osp/Uninstall_osp/LaunchUninstall.sh

      • Windows: c:\netiq\idm\apps\idgov\Uninstall_osp\LaunchUninstall.bat

    2. Change or ensure that the path listed for the JRE_HOME variable is the path to the jre bin directory 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 OSP.

    1. (Conditional) Uninstall OSP from a Linux server.

      1. Access the uninstall directory located here: /opt/netiq/idm/apps/osp/Uninstall_osp

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

        ./LaunchUninstall.sh

    2. (Conditional) Uninstall OSP on a Windows server.

      1. Access the Control Panel as an administrator.

      2. Search for and select OSP.

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

  5. When the uninstall completes, delete the following files and folders:

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

      • 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 installation path is C:\netiq\idm\apps\osp.

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