Administration

This page contains solutions targeted for administrators.

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.

Administration Questions

1. How do I let people browse Git securely but without defining Git IDs for everyone?

With the Git Integration for JIRA add-on, you only need to define a single ID for the JIRA server.  JIRA then lets authorized JIRA users browse Git.

2. Does the Git Integration for JIRA add-on have API commands that allow addition/removal of a Git project?

Yes.  As of v2.8.3 of the Git add-on, the REST API for add, update, and delete repository is implemented.  The documentation for this feature is available at Git add-on: Hook and API Reference - Repository REST API open in new tab.

3. After upgrading JIRA from 4.1.1 to 5.2.9, I get some errors "Folder ... FORNEOnlineSolver git doesn't exist".  Where can I set the path correctly?  Is there any properties file?

Please visit add-on config and check Git Repositories tab.  Also upgrade of JIRA may lead to changing of user account used to run service, which in turn, may result in lack of permissions.

4. Does JIRA+GitHub integration support multiple JIRA projects (many) to multiple git repositories (many)?  If it does not, how about many-to-one or one-to-many?

Yes — it does support repositories supporting many projects.  That said – the associations are made by the developers when they commit code to a specific issue key (which is part of a project).  The permission that allows a user to see these commits in a JIRA project is whether they have the "View Development Tools" permission for that project (that's a JIRA setting).

The only project permissions that the Git Integration for JIRA add-on has are for the Repository Browser (Git dropdown menu).  To associate a repository with all JIRA projects or only specific projects, see Repository Browser setting open in new tab in the Connect to Git Repository wizard or edit a repository in the Git Repositories configuration page.

5. How do I connect to HTTPS repositories with self signed SSL certificates or other SSL issues?

This problem may be caused by a custom (a self-signed) certificate.  Make sure to install the latest JRE and then change the JAVA_HOME of JIRA server.

The above solution should work, otherwise, see below for the steps to workaround this issue:

  1. From your JIRA Server, clone the repository manually using the git client.
  2. Example:
    cd /jira/home
    cd data/git-plugin
    git clone --mirror https://my-self-signed-repo/project.git
  3. Make sure that the JIRA user has access to the folder above.
  4. Configure the repository to disable verification of the SSL certificate.
  5. Example:
    cd project.git
    git config http.sslVerify false
    Run git config http.sslVerify false in the repository folder.
  6. From your browser, log into JIRA and add a repository via Administration > Add-ons/Applications (JIRA 7).
  7. Select Git Repositores under Git Integration for JIRA.
  8. Click Connect to Git Repository then Advanced setup.
  9. For the Display Name, enter a description of the Git repository.
  10. For the Repository Root, enter the full path to the Git repository that you have cloned.  Considering the example in step 1, it will be similar to /jira/home/data/git-plugin/project.git.
  11. Click the Detect button next to the Repository Origin.
  12. Click Add to add this repository to the Git repository configuration list.

The clone will be kept up-to-date and the SSL verification issues will be ignored.

There are alternative solutions to make Java trust this certificate.  Please refer to the following articles from Atlassian which focuses on helping to resolve SSL Verification Issues:

If the problem persist, please send us a support zip to give us a better view of the issue.