Uninstalling the Git adapter

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

Procedure

  1. Delete server friends.
    1. Point your web browser to https://fully qualified hostname:port/ccm/admin.
    2. In the Communication section, click Consumers(Inbound).
    3. On the OAuth Consumers page, in the Authorized Keys section, hover over a consumer name for your Git adapter and click the Remove Consumer icon in the Actions column.
    4. Confirm that you want to delete the consumer name.
  2. Unregister the Rational® Adapter for Git from JTS.
    1. Point your web browser to https://fully qualified hostname:port/jts/admin.
    2. On the Administration page, click the Server tab.
    3. In the left pane, in the Configuration section, click Registered Applications.
    4. In the Registered Applications section, hover over the application name /gitAdapter and click the Remove Application icon in the Actions column.
    5. Click OK.
  3. Delete Gitweb additions.
    Important: In adapter software 1.1 or earlier the ./rlia folder was named ./static folder in the Gitweb server directory.
    1. Go to your Gitweb installation folder. For example, /usr/share/gitweb
    2. Delete the./rlia folder in your Gitweb installation folder.
    3. Delete the gitweb.conf variables. The gitweb.conf file is typically found in your /etc folder. In that file, for adapter 1.1.0.1 or later software remove the following lines:
      push @stylesheets, "https://fully qualified hostname:port/gitAdapter/web/client/client/OSLC.css";
      our $site_header = "./rlia/GitwebSiteHeader.html";
  4. Delete Git receive hooks.
    1. Go to the hooks directory for each of your Gitweb shared repositories. For example, /home/git/repos/first.git/hooks
    2. Delete the symbolic links for these hook files: pre-receive, reprocess.pl, and rtc_credentials.pl, and the rtchookreprocess directory if it exists.
  5. Delete the Gerrit additions.
    1. Go to your Gerrit installation folder. For example, /usr/share/Gerrit
    2. Delete the /static folder in your Gerrit installation folder.
    3. Go to the /etc folder.
    4. Delete the GerritSiteHeader.html and GerritSite.css files.
  6. Delete the Gerrit receive hooks.
    1. Go to your Gerrit installation hooks folder. For example, /usr/share/Gerrit/hooks.
    2. Delete the symbolic links for these hook files: patchset-created, gerrit_reprocess.pl, and rtc_credentials.pl, as well as the rtchookreprocess directory if it exists.
  7. Delete the Rational Adapter for Git database.

    Consult your database documentation for the commands to delete the database that you set up for the Git adapter. If you used a Derby database for the Git adapter, the Derby database is deleted when you do step 11.

  8. Uninstall the product by using Installation Manager or a command.
    • Installation Manager
      1. Start IBM® Installation Manager.
      2. Select the Uninstall wizard.
      3. Choose the package group and the package to uninstall, and follow the instructions on the wizard to complete the uninstall process.
    • Command
      • For Windows Uninstall with the following command:
         IBMIMc -silent -input tmp/GIT/disk1/silent-uninstall.xml -sVP -noSplash
      • For Linux. Uninstall with the following command:
         ./IBMIM -silent -input tmp/GIT/disk1/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.

    The following sample response file is used to run a silent uninstall. You can find this response file where you extracted the adapter. If you removed the extracted adapter files, you can create a response file by following this code.
    Remember: Change the value of the <offering id='com.ibm.rational.oslc.adapter.git" profile="IBM Collaborative Lifecycle Management" features="main.feature"/> profile property to the package name for the Jazz™ Team Server that you used when you installed the adapter.
    <?xml version="1.0" encoding="UTF-8"?>
    <agent-input>
    <uninstall modify='false'>
    <offering id='com.ibm.rational.oslc.adapter.git' profile='IBM Collaborative Lifecycle Management'/>
    </uninstall>
    </agent-input>
  9. For PVU licensing only, delete any license files that you copied to the properties/version directory for these locations:
    • One or more Change and Configuration Management application servers that the adapter communicates with
    • One or more Gitweb and Gerrit servers that the adapter communicates with
  10. For CAL licensing only, remove the license activation key.
    1. Point your web browser to https://fully qualified hostname:port/jts/admin
    2. From the Server Administration page, click License Key Management .
    3. On the License Key Management page, in the Client Access License Types area, hover over a license and click Remove license in the Actions column.

      The adapter license is removed.

  11. Check the Jazz Team Server directory where you installed the adapter. For example, /opt/ibm/JazzInstallDir/server/conf and delete the gitAdapter directory.

If you deployed the adapter web application on WebSphere® Application Server, then follow the remaining steps.

  1. To uninstall the adapter web application by using the console:
    1. Open the Admin console.
    2. Click Applications > Application Types > WebSphere enterprise applications.
    3. Select the check box next to gitAdapter; click Uninstall. Click OK. The file is uninstalled from the application server.
  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 gitAdapter directory.
    2. Go to WASInstallDir/profiles/profile name/temp/wscache and delete the gitAdapter directory.

Feedback