TeamCity Integration for Jira

Space shortcuts

Page tree

Versions Compared

Old Version 58

changes.mady.by.user Alexander Kuznetsov

Saved on

compared with

New Version Current

changes.mady.by.user Vadim Rutkevich

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Once the add-on has been installed and application links have been configured, indexing of TeamCity data begins. Indexing is required for correct output of all related data about build in corresponding JIRAJira's sections. Indexing is performed only once for each configured application link. Afterwards the add-on synchronizes data with TeamCity servers every two minutes.

...

Info
iconfalse

Percentage of data indexing is counted depending on the number of TeamCity servers registered in JIRAJira.

For example, if you have only one TeamCity server connected, so 100% are equal to complete data indexing of this server. So if you see in the interface that 40% were completed, so 40% of data from TeamCity have been indexed.

If you have two TeamCity servers and both are not indexed, so 100% are divided by two, with 50% per each TeamCity server. For example, if data from one server is 80% indexed, and data from the other is one 10% indexed, so the total indexation percent for both instances will be 45% ((80%+10%)/2).

From version 2.3.0, the percentage of data indexing is also displayed for each registered TeamCity server individually.

...

You can also monitor progress of indexing and see if any errors occurred during the procedure.

  1. Open the JIRA's administration JIRA administration console and select Add-ons. 
  2. Locate the TeamCity Configuration section and select Troubleshooting.

...

If you experience any issues with data indexing, here you can also find out errors that occurred during indexing. For each error, the following information is displayed:

  • Application Link Name - name of the application link configured with TeamCity server;
  • Message - error description (below you can find the table with errors and their description);
  • Last Occurred - date and time when the error occurred last;
  • Quantity - number of errors of the same type occurred for the same application link. 

...

If you experience any issues with data indexing, please supply the error and its description when posting a ticket to our HelpDesk system. Below you can find the table with errors and their description.

Error MessagePossible Cause
java.net.NoRouteToHostException: No route to host
The TeamCity host can't be reached due to network problems and/or an intervening firewall.
java.net.SocketException: Connection reset
A TCP error. Most likely, an incorrect port was specified for the TeamCity host.
java.net.SocketTimeoutException: Read timed out
org.apache.commons.httpclient.ConnectTimeoutException: The host did not accept the connection within timeout of 10000 ms
  • The
JIRA
  • 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.

For possbile issue resolutions, refer to this page.

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.
com.stiltsoft.lib.teamcity.connector.rest.exception.HttpStatusNotOkException: HTTP/1.1 502 Proxy Error
or
com.stiltsoft.lib.teamcity.connector.rest.exception.HttpStatusNotOkException: HTTP/1.0 403 Forbidden
JIRA

Jira tries to connect to TeamCity via a proxy. For the details on connection via proxy server, refer to this page.

com.stiltsoft.lib.teamcity.connector.rest.exception.HttpStatusNotOkException: HTTP/1.0 403 Bad Request
or multiple records like the following:
[teamcity.connector.rest.RestClient] HTTP Status isn't 200. Actual Status - HTTP/1.1 400 Bad Request
[teamcity.index.update.IndexUpdaterImpl] Unable to synchronize with TeamCity
This is a known issue, which will be resolved in the next version. As a workaround, please re-index TeamCity data.
com.stiltsoft.lib.teamcity.connector.rest.exception.HttpStatusNotOkException: HTTP/1.0 404 Not Found

The add-on cannot reach the TeamCity host by the specified URL in the application link. Ensure that you have specified the correct address of the TeamCIty server.

How to verify URL address of TeamCity address:

  1. In the browser's address line, enter URL (which you specified in the applicaiton link), then add /httpAuth/app/rest/builds. 
  2. Your URL should look like: http://teamcity-server-address/httpAuth/app/rest/builds.
  3. Press Enter.
  4. Enter login and password.
  5. The XML listing with TeamCIty builds should be displayed.
java.net.UnknownHostException

IP address of the specified host cannot be resolved. Ensure that the host specified in the application link is accessible.

  1. In the browser's address line, enter the IP address of the host (from the application link).
  2. The login form of the TeamCity server should open.
HTTP/1.1 503 Service Unavailable

TeamCity server is temporarily unavailable. This may happen due to high load on the server or due to any other problem.

Try to open TeamCity server in your browser. Address the issue to TeamCity administrator to check the service unavailability.

You may also encounter this error when TeamCity performs scheduled data clean-up. Once this procedure is complete, this issue will no longer persist.

com.stiltsoft.lib.teamcity.connector.rest.exception.ResponseTimeoutException: Response time is more than
Response from TeamCity server has not been received within the defined timeout. Try to increase value of the Response Timeout option.

For other HTTP errors (those containing  HTTP/1.1 [message code]), please refer to Status Code Definitions.