What JetBrains TeamCity versions are supported?

The latest TeamCity Integration for JIRA Plugin supports TeamCity  6.x-8.x.

Does the plugin store the build data anywhere?

No. That is why when you restart JIRA, the plugin needs to index all TeamCity builds from scratch.

How can I get the plugin to show JIRA info in TeamCity?

The plugin installs on JIRA and shows TeamCity builds in JIRA. It doesn't work the other way round.

I configured TeamCity and JIRA and installed the plugin. Why I don't see the TeamCity tab in JIRA?

Most likely your JIRA user doesn't have the permission to View Issue Source Tab.

Why does the indexation take so long?

It may take quite a long time, if your TeamCity server has lots of builds. However, if you feel that it takes longer than it should, please go to  Administration > Add-ons > TeamCity Configuration > Troubleshooting  and see if there're any errors. Freezing at 0% for a long time might mean that you have a problem with connecting TeamCity and JIRA.

Something went wrong during the build indexation. Where can I see the error log?

Go to  Administration > Add-ons > TeamCity Configuration > Troubleshooting. 

These are the most frequent problems with possible causes:

Error MessagePossible Cause
java.net.NoRouteToHostException: No route to hostThe TeamCity host can't be reached due to network problems and/or an intervening firewall.
java.net.SocketException: Connection resetA TCP error. Most likely, a wrong port specified for the TeamCity host.
java.net.SocketTimeoutException: Read timed out
  • The JIRA host connected to the TeamCity host but didn't get any response from it most likely due to network problems.
  • Your TeamCity sever might be very slow. Check the CPU load during the indexation.
com.stiltsoft.lib.teamcity.connector.rest.exception.HttpStatusNotOkException: HTTP/1.1 401 Unauthorized
  • The TeamCity user's password in the Application Link is not valid.
  • The TeamCity user is authenticated via LDAP. See here for details.
HTTP/1.1 403 or 502JIRA tries to connect to TeamCity via a proxy. See #8 below.

For other HTTP errors (those containing  HTTP/1.1 [message code] ), please refer to  Status Code Definitions .  If you need further assistance in case of errors, please contact us. 

I created an Application Link. Now, I'm trying to create a Project Link, but something is not right. What gives?

You don't need a Project Link for the plugin to work. With the Application Link correctly configured, the plugin will assign all builds containing Issue Keys to corresponding projects.

JIRA and TeamCity reside in the same network and connect to the Internet via a proxy. Why can't JIRA connect to TeamCity? 

You need to set this parameter -DdisableProxyForTeamcity=true on your Java virtual machine startup. Learn more about parameters here.

What happens in case of network problems during the initial indexation?

Initially, the plugin indexes builds by packages of 20 builds. If during the initial indexation, the plugin can't access TeamCity, it will keep trying to index the build package next to the last successfully indexed one. If the Skip Builds option is enabled in Administration > Add-ons > TeamCity Configuration > Global Configuration, the plugin will skip the builds that can't be indexed due to network or other problems.

What happens if the connection to TeamCity is lost after the initial indexation?

After the initial build index is created, the plugin updates it every 2 minutes. In case it can't connect to TeamCity, the plugin will keep trying to reach it every 2 minutes until it succeeds. If the Skip Builds option is enabled in Administration > Add-ons > TeamCity Configuration > Global Configuration, the plugin will skip the builds that can't be indexed due to network or other problems.

Why may I need to reindex all TeamCity builds?

If the plugin doesn't show builds that you're sure should be shown, reindex the build list completely. To do that, go to  Administration > Add-ons >   TeamCity Configuration > Troubleshooting  and click the  Reindex  button. Please note that reindexation will start from scratch and can take a while on large instances.

  

How do I turn on logging?

In Administration > System > Troubleshooting and Support > Logging & Profiling, set the DEBUG level for the following packages:

com.stiltsoft.jira.extra.teamcity.index

com.stiltsoft.jira.extra.teamcity

com.stiltsoft.lib.teamcity.connector.rest. 

Optionally, you can do the same for com.stiltsoft.lib.teamcity.connector.util, but this may significantly slow down your JIRA instance and make a mess of your log.