Repository

This page contains solutions to common issues encountered while connecting and configuring git repositories.

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.

Repository Questions

  1. I have an existing git repository on a JIRA server.  How can I figure out what values should be used for repository origin and repository root fields?
  2. Where is the location of the local git repository?
  3. How do you configure the Repository Root which is not located in a JIRA home directory with Git Integration for JIRA?
  4. I use GitLab.  Is there a special utility to export repository configuration to connect all its repositories to JIRA?
  5. I get the following error: "Host or port specified in <git_repository_url> are inaccessible". Do I also need a git instance on the JIRA server?
  6. We use GitBlit without SSH keys and use only HTTPS instead.  Does Git Integration Plugin for JIRA support this?
  7. I am using JIRA which is hosted on Windows.  I changed the password of the Active Directory account running JIRA.  Now, I cannot access my repository.  Why?

Repository Questions

1. I have an existing git repository on a JIRA server.  How can I figure out what values should be used for repository origin and repository root fields?
  1. Change current directory to the folder where repository is located.
  2. Run pwd.
  3. Response should go to repository root field.
  4. Run git remote show origin.
  5. Find origin url in command response.
  6. Set this value for repository origin field.
3. Where is the location of the local git repository?

The Repository Root (in settings) must be a local path for server which is used to run JIRA.

In other words, the plugin must point to a clone of the repository and this clone must run locally with JIRA.

Update/edit repository screen
4. How do you configure the Repository Root which is not located in a JIRA home directory with Git Integration for JIRA?

There are three possible ways to do this:

  • Clone the repository outside of JIRA then connect to it via Connect to Git Repository  >  Advanced Setup.
  • Clone the repository with the standard Connect to Git Repository Wizard into the JIRA home directory.  Soon afterwards, move the cloned repository and update the settings on the repository.
  • You could symlink the {$JIRA_HOME}/data/git-plugin directory to a different volume.  The standard Connect to Git Repository Wizard will still write there, but the data will reside on the different volume.  But be aware, that the Git add-on treats anything in the Git-Plugin folder as a clone that it owns.
5. I use GitLab.  Is there a special utility to export repository configuration to connect all its repositories to JIRA?

There's a utility that helps GitLab users export repository settings from GitLab server.  Get the JAR file and follow instructions at GitLab to TSV.  Requires Git Integration Plugin for JIRA to work.

This utility will create a TSV import file which can be imported via Bulk Change feature of the Git Integration Plugin for JIRA.

How to import a TSV file generated from this utility:

GitLab to TSV, how to
6. I get the following error: "Host or port specified in <git_repository_url> are inaccessible". Do I also need a git instance on the JIRA server?

If your JIRA and Git servers are running through a firewall, configure the firewall to allow access using the URL schemes for git repositories.  For authentication issues, make sure to check first the correct port for its connection.

Below are the default ports for common git URL protocols:

Protocol Default port
ssh:// port 22
git:// port 9418
http:// port 80
https:// port 443

Test git connection and repository URL by doing the following:

  1. Install git client (or run sudo apt-get install git)
  2. Place your ssh key into ~/.ssh
  3. Clone the repository (or run git clone <your_repository_url>)
The Git Integration for JIRA will run successfully if the above connection test ran without errors.
7. We use GitBlit without SSH keys and use only HTTPS instead.  Does Git Integration Plugin for JIRA support this?

Yes. The Git add-on definitely supports GitBlit via HTTPS authentication.  Use the Connect to Git Repository wizard to connect to your repositories.  Towards the end of the process, a username and password will be required for connection authentication.

8. I am using JIRA which is hosted on Windows.  I changed the password of the Active Directory account running JIRA.  Now, I cannot access my repository.  Why?

When using Active Directory accounts for repository access, changing the password of the AD account running JIRA can cause repository authentication issues.

You need to restart JIRA to regain access to repositories.