Skip to end of banner
Go to start of banner

TFS4JIRA FAQ

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 32 Next »

 

Licensing

My license key is being rejected. Am I doing something wrong?

If your license key is being rejected, most probably it's because you are trying to enter your key in the wrong place. See this page for more detailed information on providing a license key. Please remember that from version 2.1.0 TFS4JIRA accepts only Atlassian Marketplace licenses. If you have old license type, obtained directly from Spartez, please write to sales@spartez.com in order to have your license migrated.

Where can I find rules governing licenses?

Please refer to Atlassian documentation: https://www.atlassian.com/licensing/purchase-licensing

TFS check-ins synchronization (TFS4JIRA JIRA Plugin)

Error in JIRA UPM that says "The JIRA server was contacted but has returned an error response."

This error sometimes happens after updating UPM. Please try the following:

  • Stop JIRA
  • Make sure the JAR file with TFS4JIRA plugin has been removed from $JIRA_HOME/plugins/installed-plugins
  • Start JIRA
  • Install TFS4JIRA plugin again

I don't have "TFS Check-ins" tab at all on issue view

JIRA user must have particular permission set in order to see this tab. The exact permission depends on the JIRA version you use:

  • View Development Tools for JIRA >= 6.1
  • View Version Control for JIRA <= 5.1.1
  • View Issue Source Tab for any other version of JIRA.

Plugin ignores "Start at Changeset #" value

Please check if permissions for project in TFS are correct for account that you provided. As a test you can check if this option works correctly for admin account.

I've defined a TFS repository in TFS4JIRA plugin configuration but I can't see any check-ins.

First thing to check is whether TF4JIRA managed to successfully scan your TFS repository. Navigate to Administration -> TFS Repositories. and click on Status link – a popup will show up presenting information about last repository scan. Please verify if last scan time is OK and if last scanned changeset number matches the most recent changeset number in your repository. In case of last synchronization attempt failure, you should see also error details presented. You can also click on Edit link and then press Test button to check if repository data you've provided are OK. Below you will find a list of the most common errors you may encounter.

I get "The SOAP endpoint https://example.com/SomeCollection/Services/v1.0/Registration.asmx could not be contacted. HTTP status: 404" error

Most common cause of such an error is either invalid TFS server URL or invalid project collection name. Regarding URL please verify that you've provided full URL with proper scheme (http:// vs. https://), port number and path component (by default, local TFS installation URL ends with /tfs, e.g. http://example.com/tfs).

I get "sun.security.validator.ValidatorException: PKIX path building failed: sun.security.provider.certpath.SunCertPathBuilderException: unable to find valid certification path to requested target" error

Most probably your TFS server uses SSL certificate which cannot be verified (usually because it's self signed). Please follow the steps listed below to add your certificate to trusted store.

How do add my TFS server SSL certificate to JIRA trusted certificates store?

  1. Save your TFS server certificate to a file. The easiest way to do it is to use a web browser to navigate to TFS web interface and when the certificate is presented save it to a file.
  2. Run shell and change directory to <JAVA_HOME>/lib/security where <JAVA_HOME> is location of Java JRE which is used by JIRA.  As you can have many JREs installed on your machine, the best way to check which one is used by JIRA is to navigate to Administration -> System Info and get java.home property.
  3. Run the following command: 
    keytool -import -keystore cacerts -file <certificate_file>
    where <certificate_file> is a path to file, that you've saved in step 1. You have to confirm certificate addition by pressing y. You will also be prompted for keystore password, which by default is changeit.
  4. Restart JIRA

TFS4JIRA seems to successfully run synchronizations but still I cannot see any check-ins.

Most common case is that user, which credentials are provided in repository configuration, is not privileged enough permissions to fetch the changesets. Please vertify that the user has both permissions:

  • View collection-level information for the selected collection. Lack of this permission usually manifests as error message when running TFS connection test, although sometimes it's not the case (the test passes, but TFS quietly returns no results). How to set the permission:

    • Visual Studio 2010/2012: Team -> Team Project Collection Settings -> Security

  • Read permission for the selected folder. How to set the permission:
    • Visual Studio 2010: View -> Other Windows -> Source Control Explorer -> Right click on the folder -> Properties ->  Security
    • Visual Studio 2012: View -> Other Windows -> Source Control Explorer -> Right click on the folder -> Advanced -> Security

Also, please verify that your TFS4JIRA plugin version is 1.7.5 or newer as previous versions contained a critical bug.

TFS4JIRA Synchronizer installation

I've installed TFS4JIRA Synchronizer – what now? Where can I access the application?

TFS4JIRA Synchronizer application can be reached under the following URL: http://<your-iis-host>/tfs-jira-synchronizer. You may need to setup appropriate access permissions in order to be able to log in to the application.

TFS4JIRA Synchronizer installer finished without any complaints but I get "HTTP 500.19" error when I navigate to the application site.

This problem occurs when you have IIS8 server without ASP.NET 4.5 feature enabled. Please enable it and refresh the site (you don't have to run the installer again).

TFS4JIRA Synchronizer installer finished without any complaints but I get "HTTP 500.19" with 0x8007007e code error when I navigate to the application site.

You need to run following command in console (more info): %windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/httpCompression /-[name='xpress']

TFS4JIRA Synchronizer installer finished without any complaints but I get "HTTP 500.19" with 0x80070021 code error when I navigate to the application site.

You need to run following command in console: %windir%\system32\inetsrv\appcmd unlock config -section:system.webServer/modules

TFS4JIRA Synchronizer installer finished without any complaints but I get "HTTP 500" error on static files (*.js, *.css) when I navigate to the application site.

This problem occurs when there is AboMapperCustom-[number] in Handler Mappings, which should be deleted in order to application site work correctly. Handler Mappings can be found in IIS Manager: Connections tree, Sites > Default Web Site > tfs-jira-synchronizer, then look in the IIS section in the center of the screen.

When I test connection with JIRA I get "The remote server returned an error: (403) Forbidden." error.

JIRA after first unsuccesfull attempt to log in shows captcha which user has to fill in, so probably you just have to go to JIRA login page and log manually - after that connection between JIRA and Synchronizer should work OK. Please remember that it is best to turn off synchronization profile during that change because if this profile has old password it will be locking JIRA with every synchronization attempt.

TFS-JIRA issues synchronization (TFS4JIRA Synchronizer)

I've configured TFS repository inside JIRA plugin, but issues and work items synchronization doesn't seem to work.

TFS4JIRA provides two features: TFS check-ins synchronization (which is configured inside JIRA) and TFS-JIRA issues/work items synchronization (which is configured inside TFS4JIRA Synchronizer web application). The features are independent and each require to be configured separately, so although you've configured TFS repositories in JIRA (for check-ins synchronization), you still have to define synchronization profiles in Synchronizer webapp (for issues synchronization).

Is comments and attachments synchronization supported?

Yes it's supported but in both of this cases deleting is not supported due to technical reasons.

I have JIRA 6.0.1 and issues and work items doesn't synchronize correctly.

There is a bug in JIRA 6.0.1 that prevents Synchronizer to check the date set in JIRA instance. When you have JIRA 6.0.1 you need to have same timezone set in JIRA and in the computer on which Synchronizer is installed.

Not all of the values from TFS are visible on the mappings screen (for example only subset of State fields can be chosen).

Remove folder <synchronizer_path>\App_Data\TFSClientCache and check again if all of the TFS values are on the list now.

I want to synchronize only JIRA Issues/TFS Work Items of some types and ignore other items.

You should go to page "JIRA Issue Type/TFS Work Item Type" and select "Do nothing" option instead of "Raise error" in value mappings section.

 

  • No labels