This page contains a list of workarounds for known issues in TeamCity.
Clearing Browser Caсhes
There is a web UI-related issue which some our users have encountered (and it cannot be reproduced on other computers) which is tied with the cached versions of content. If you have come across such problem, make sure your browser does not use cached versions of content by clearing browser caches.
Logging with Log4J in Your Tests
If you use Log4J logging in your tests, in some cases you may miss Log4J output from your logs. In such cases please do the following:
Use Log4J 1.2.12
For Log4J 1.2.13+, add the "Follow=true" parameter for console appender, used in Log4J configuration: <appender name="CONSOLE" class="org.apache.log4j.ConsoleAppender"> <param name="Follow" value="true"/> </appender>
Agent Service Can Exit on User Logout under Windows x64
The used version of Java Service Wrapper does not fully support Windows 64 and this causes agent launcher process to be killed on user logout. The agent itself will be function until the next restart (server upgrade or agent properties change).
Subversion-related JVM Crashes
If JVM crashes while executing SVN-related code (e.g. under org.tmatesoft.svn package), you can try to disable it by either:
Passing -Dsvnkit.useJNA=false JVM option to the crashing process (server or agent), or
Making NTLM support less prioritative by passing -Dsvnkit.http.methods=Basic,Digest,NTLM JVM option.
Failed Build Can be Reported as a Successful One With Maven 2.0.7
This is a known bug in this version of Maven. Consider using any later version. In case it's not possible you can patch mvn.bat yourself by replacing the fragment at line 148 of mvn.bat:
:error set ERROR_CODE=1
with the following one:
:error if "%OS%"=="Windows_NT" @endlocal set ERROR_CODE=1
Conflicting Software
Certain antivirus software like Kaspersky Internet Security can result in Java process crashes or other misbehavior like inability to access files. Please try running with antivirus software uninstalled before reporting the issue to JetBrains. e.g. see the issue.
Please disable various indexing services. e.g. there might be problems with Windows Indexing Service. See issue for more details. Windows System Restore Feature might also need disabling.
Please also do not install software with background indexing like WinCVS, TortoiseCVS, TortoiseSVN and other Tortoise* products. This applies to server and also to agents if you use agent-side checkout.
Most common indicators of conflicting software are errors like "Access is denied", "Permission denied" or java.io.FileNotFoundException mentioning the file that is present and is writable by the user the agent/build runs under. Also network-related antivirus tools can sometimes result in "Connection reset" errors.
Subversion Repositories With NTLM Authorization
If TeamCity has problems connecting to SVN repository, while using NTLM Authentication, add an option to the TeamCity Startup Properties and to the agent options (if you use agent-side checkout): -Dsvnkit.http.methods=Basic,NTLM See a related forum post on this issue.
note
Starting from TeamCity 4.0.2 the default setting for svnkit.http.methods property is be Negotiate,Digest,Basic,NTLM, so this problem should not arise anymore. But this also means that more secure NTLM authentication won't be used by default. To enforce using NTLM, add JVM option -Dsvnkit.http.methods=NTLM,Negotiate,Digest,Basic.
note
Enforced NTLM authentication with TeamCity may be unstable. For instance, you may notice authentication errors after each 5 days of running. One of the ways to workaround this, according to our users, is to use local machine account between TeamCity and VisualSVN server (instead of domain account)
NUnit 2.4.6 Performance
Due to an issue in NUnit 2.4.6, its performance may be slower than NUnit 2.4.1. For additional information, please refer to the corresponding issue in our issue tracker: TW-4709
StarTeam Performance
Using StarTeam SDK 9.0 instead of StarTeam SDK 9.3 on the TeamCity server can significantly improve VCS performance when there is a slow connection between TeamCity and StarTeam servers.
Perforce 2009.2 Performance on Windows
If you run Perforce 2009.2 on Windows you may experience significant slow down. This is an issue with P4 server running on Windows. Please refer to corresponding section in Perforce documentation.
Agent running as Windows Service Limitations
When TeamCity build agent is installed as a Windows service, service limitations can affect the builds that the agent is running. If you encounter an issue with your build and it runs OK out of TeamCity please try to check whether it reproduces when TeamCity agent is Setting up and Running Additional Build Agents.
Common indicators of the issue are various "Permission denied" or "Access denied" errors during the build process.
The most common service-related issues are:
user the service runs under. The user should have enough permissions to perform the build.
access to network shares and mapped drives. Services have a restriction to access the resources that imposed by Windows.
interaction with desktop, headless mode, etc.
Unexpected errors on web from org.apache.jasper
If you encounter an unexpected error like "org.apache.jasper.JasperException: Unable to compile class for JSP" or alike (e.g. TW-13363), this most probably means the installation is corrupt or page templating engine malfunctioned. If you use tar.gz or .exe installation or deploy .war into Tomcat web server, please perform the following:
stop the server
delete <TeamCity Server home>/work directory
start the server again
In case this does not help, please uninstall and reinstall the server.
If you still have the issue reproducing, please file an issue into our tracker.