Uninstalling

To uninstall Rational® Adapter for Git, delete server friend relationships between Gerrit, Gitweb and CLM, unregister the Rational Adapter for Git from JTS, remove Gitweb additions and Git receive hooks, remove Gerrit additions and Gerrit receive hooks, delete the Rational Adapter for Git database, uninstall the Rational Adapter for Git from JTS, and delete any license files.

Procedure

  1. 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.
  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 Git Adapter and click the Remove Application icon in the Actions column.
    5. Click OK.
  3. Delete Gitweb additions.
    1. Go to your Gitweb installation folder; for example /usr/share/gitweb
    2. Delete the./static 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, remove the following lines (which are the end of the file):
      #User must modify gitweb.conf by adding the entries below
      
      #OSLC Configurations
      #Add the following entry to support OSLC Style Sheets
      
      push @stylesheets, "./static/OSLC.css";
      push @stylesheets, "./static/dojo/dijit/themes/claro/claro.css";
      push @stylesheets, "./static/jaf/jazz/app/internal/templates/BannerButtons.css";
      push @stylesheets, "./static/jaf/jazz/ui/templates/MenuPopup.css";
      push @stylesheets, "./static/jaf/jazz/ui/templates/Menu.css";
      push @stylesheets, "./static/jaf/jazz/ui/templates/MessageBox.css";
      push @stylesheets, "./static/jaf/jazz/ui/menu/templates/MenuItem.css";
      
      #Point gitweb site header to the html file we've packaged.
      #Otherwise, if one already exists - modify the existing site header
      #by merging or appending the GitwebSiteHeader.html code
      
      our $site_header = './static/GitwebSiteHeader.html';
  4. Delete Git receive hooks.
    1. Go to your Gitweb shared repository; for example /usr/share/gitweb
    2. Delete the/hooks folder in your Git repository.
  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 folder; for example /usr/share/Gerrit.
    2. Delete the /hooks folder in your Gerrit installation folder.
  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 10

  8. Uninstall the product using Installation Manager or command-line commands.
    • 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-line commands
      • 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.

    This is the sample response file that is used to run a silent uninstall. You can find this response file where you extracted the adapter. If you have removed the extracted adapter files, you can create a response file 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 CCM application servers that the adapter communicates with
    • One or more Gitweb and Gerrit servers that the adapter communicates with
  10. Check the Jazz Team Server directory where you installed the Rational Adapter for Git, for example /opt/ibm/JazzTeamServer/server/conf and delete the gitAdapter directory.

What to do next

If you used WebSphere® Application Server, see Undeploying the web application.

Feedback