Uninstalling the HP adapter

Uninstalling the adapter includes several steps such as deleting project associations, server friends, and license files.

Procedure

  1. For each CLM product, delete its project associations with the HP ALM server by clicking the x icon in the Actions column of each project association that you want to delete. To find the project associations that you want to delete, see Linking between HP ALM projects and CLM project areas.
  2. Delete server friends.
    1. Point your web browser to https://fully qualified hostname:port/ccm/admin.
    2. In the Communication pane, click Consumers(Inbound).
    3. On the OAuth Consumers page, in the Authorized Keys section, hover over a consumer name and click the Remove Consumer icon in the Actions column.
    4. Confirm that you want to delete the consumer name.
  3. Stop Apache Tomcat, if you selected this server when you installed the adapter.
  4. Uninstall the product with Installation Manager or a command line.
    • Installation Manager
      1. Start IBM® Installation Manager.
      2. Select Uninstall.
      3. Choose the package group and the package to uninstall, and follow the instructions on the wizard to complete the uninstall process.
    • Command line
      • For Windows Uninstall with this command:
         IBMIMc -silent -input HPInstallDir/silent-uninstall.xml -sVP -noSplash
      • For Linux Uninstall with this command:
         IBMIM -silent -input HPInstallDir/silent-uninstall.xml -sVP -noSplash

      These Installation Manager response files are tailored for the adapter to uninstall. You can find these response files in your Installation Manager directory.

    You can use a sample response file to run a silent uninstall. You can find this response file where you extracted the adapter. If you deleted the extracted adapter files, you can create a response file by using this code.

    <?xml version="1.0" encoding="UTF-8"?>
    <!--This script assumes that the package id used for install is the default IBM Rational Adapter for HP ALM. If this is not true the profile section should be updated  --><agent-input>
    <uninstall modify='false'>
    <offering id='com.ibm.rational.oslc.adapter.hpqm' profile='IBM Rational Adapter for HP ALM' features='main.feature'/>
    </uninstall>
    </agent-input>
  5. Delete any license files that you copied to the properties/version directory for these locations:
    • One or more CCM, RM, and QM application servers that the adapter communicates with
    • One or more HP ALM servers that the adapter communicates with
  6. Check the HPInstallDir directory and delete any remaining files after the uninstall process finishes.

If you used WebSphere® Application server, then undeploy the web application. You can use either a Jython script or the administration console to undeploy the adapter web application. The Jython script undeploys the adapter installed web application. The script assumes hpqm_deploy.py was used to deploy the web application.

  1. Uninstall the adapter web application by using a Jython script or the console.
    • Using a Jython script:
      1. To uninstall the adapter web application on a single application server, open a command window and change the directory to WASInstallDir/AppServer/profiles/profileName/bin
      2. Run the following command by substituting WAS_username with the WebSphere Application Server admin username, WAS_password with the admin user password, and path to the script with the location of the script, for example, WASInstallDir/server/was/hpqm_undeploy.py (notice the forward slash on the Windows platform).
        For Linux
        ./wsadmin.sh -language jython -user WAS_username -password WAS_password -f path to the script/hpqm_undeploy.py 
        For Windows
        wsadmin.bat -language jython -user WAS_username -password WAS_password -f path to the script/hpqm_undeploy.py 
    • Using the console:
      1. Open the Admin console for the WebSphere Application Server.
      2. Click Applications > Application Types > WebSphere enterprise applications.
      3. Select the check box next to hpqm; click Uninstall. This file is uninstalled from the application server.
      4. Delete all custom properties that you previously added.
        1. Navigate to Servers > Server Types > WebSphere application servers > Server1 > Process definition > Java Virtual Machine > Custom properties
        2. Select the check box next to derby.system.home, java.awt.headless, and org.eclipse.emf.ecore.plugin.EcorePlugin.doNotLoadResourcesPlugin
        3. Click Delete.
  2. Delete all temporary files and directories in the WebSphere Application Server profile.
    1. Go to WASInstallDir/profiles/profile name/temp/node name/server1 and delete the hpqm directory.
    2. Go to WASInstallDir/profiles/profile name/temp/wscache and delete the hpqm directory.
  3. Delete the profile that you created for the web application by using the Profile Management tool. For more information about deleting profiles, see Deleting profiles.

Feedback