# Troubleshooting Known Issues

This page collects known problems that you might encounter when working with Teamscale along with their respective solutions.

If Teamscale runs into memory-related problems such es OutOfMemoryError: Java heap space, please refer to the dedicated article on memory issues.

# Jira does not render Teamscale Annotations correctly

Teamscale can annotate Jira tickets with the finding/test-gap information aggregated over commits for that ticket. This can be enabled in the Jira connector in the project settings.

If it looks like in the following screenshot, Jira does not render the markdown content correctly:

Jira Integration Render Problem

This problem can be solved by configuring Jira to the wiki style renderer:

  1. Log in to JIRA as a JIRA administrator.
  2. Navigate to Administration > Issues > Field Configurations.
  3. Click on the Configure link for the field configuration used by the field to which Teamscale writes.
  4. Click on the Renders link for the field to change.
  5. Select the new renderer type from the Active Renderer drop-down list. Select the Wiki style renderer.
  6. Click on Update to apply the change.

Afterwards, Teamscale's annotations in Jira ticket should be rendered properly:

Working Jira Integration

# Cross-Site Scripting (XSS) Errors

If access to a Teamscale instance is being managed by an external server such as NGINX (which is a recommended practice), it may be necessary to adapt the header settings to accommodate the cross site scripting and request forgery guarding mechanisms built into Teamscale. Specifically, this is the case when an error message appears containing the text X-Requested-By header is missing.

To fix this, insert the following line in your NGINX configuration file at the appropriate place (e.g., the server you want to configure):

add_header 'Access-Control-Allow-Headers' 'X-Requested-By';

# Vsix-Installer Crashes when Manually Installing Teamscale's Visual Studio Extension

When installing the Teamscale Visual Studio Extension in Visual Studio 2015 on Windows 10, a XamlParseException similar to following error may occur:

System.Windows.Markup.XamlParseException was unhandled
Message: An unhandled exception of type 'System.Windows.Markup.XamlParseException' occurred in PresentationFramework.dll

As a workaround, the extension can be installed manually via the command line as follows:

\path\to\visualstudio\Common7\IDE\VSIXInstaller.exe /q <YOUR-TEAMSCALE_EXTENSION.vsix>

# TransportException: Object too large when using Git Connector

The Git connector reports this error when a Git repository that contains a file larger than 2 GB is connected to Teamscale. This is due to internal limitations of the Java Git implementation, which unfortunately cannot be circumvented.

A possible workaround is to clone the repository with a native Git client, which doesn't have this limitation, and then exclude the problematic file from Teamscale analysis:

  1. In the workspace directory, execute git clone --bare $REPO_URL.
  2. Add the Git connector to the Teamscale project in question.
  3. When configuring the Git connector, use the Excluded file names option to exclude the respective file from analysis.

Another option is to remove the offending file from the history of the Git repository entirely, e.g., if it was added by accident. This StackOverflow question has some pointers on how to perform such an operation.