Uninstall/Reinstall

This page contains related questions about installation management of Git Integration for JIRA add-on.

Use the FAQ below to find answers to common questions.  Feel free to contact our support team (support@bigbrassband.com) if you don't see what you're looking for.

Uninstall/Reinstall Questions

1. How do I reinstall the plugin?
  1. Remove any repositories from the Git Integration for JIRA add-on repositories configuration page.
  2. Remove the Git Integration for JIRA add-on.  How can I remove the Git add-on while JIRA is stopped?
  3. Remove the Git Integration for JIRA add-on's indexing service.
  4. Stop JIRA, remove old lucene indexes:
  5. (/var/jira/home/caches/indexes/plugins/jira-git-revisions)
  6. Install Git Integration for JIRA add-on. Start JIRA. Verify that the plugin is enabled.
  7. Add repositories to the Git add-on repositories configuration page.
  8. Verify that each JIRA ticket has the 'Git Commits' tab.
  9. Tab may have a note: 'There are no git log entries for this issue yet'.  If you see the note, wait until the revision indexer job populates the 'Git Commits' tab.
2. How do I uninstall the Git Integration Plugin for JIRA add-on and remove its data?

The following steps will remove the Git Integration Plugin for JIRA add-on and delete its data from JIRA:

  1. Uninstall the Git Integration Plugin for JIRA add-on from the JIRA UPM (Universal Plugin Manager).

    Go to JIRA Administration > Add-ons > Manage add-ons.  Under User-installed add-ons, select Git Integration Plugin for JIRA then click Uninstall.
  2. Git add-on for JIRA UPM uninstall
  3. Delete all repositories:
  4. rm -rf $JIRA_HOME/data/git-plugin
  5. Delete the index:
  6. rm -rf $JIRA_HOME/caches/indexes/plugins/jira-git-*
  7. Remove the Git Integration Plugin for JIRA add-on tables (all tables starting with AO_8BA09E_) from the JIRA database.
  8. Credentials are usually located in $JIRA_HOME/dbconfig.xml.  There is no standard SQL command to remove all tables by prefix.  The list of tables depends on the installed Git Integration Plugin for JIRA add-on version.  All the tables are displayed in JIRA Administration > System > Plugin Data Storage. Git plugin tables
  9. Remove the table by performing the following SQL command: DROP TABLE table_name.
3. The last page of the documentation shows how to upgrade an old version of the Git Integration Plugin for JIRA add-on.  Step 3 says: "Remove Git Integration Plugin for JIRA add-on indexing service."  There are 2 services listed: GitRevisionIndexerJob AND Git Revision Indexing Service.  Which should I delete?

GitRevisionIndexerJob is the correct one.  Keep that job.

Git Revision Indexing Service is an old job and should be removed.

4. In the temp location, I see several jar files with different versions updated at the same time.  What would be the procedure for cleaning them up?

Make sure that the UPM add-on installed in your JIRA instance is the latest version.

The goal here is to end up with only one copy of the jira_git_plugin jar file in the ./home/plugins/installed-plugins folder and all others removed:

  1. Stop JIRA.
  2. Fully clean up the plugin temp folders or at least remove these kind of files:
  3. JIRA_INSTALL_FOLDER/temp/*_git_plugin-*.jar
    JIRA_HOME_FOLDER/plugins/.osgi-plugins/transformed-plugins/*_git_plugin-*.jar
  4. Remove all versions of the Git Plugin from installed-plugins folder except the latest version (JIRA_HOME_FOLDER/plugins/installed-plugins/*jira_git_plugin-x.y.z.jar): JIRA_HOME_FOLDER/plugins/installed-plugins/*_git_plugin-*.jar
  5. Run JIRA.