TeamCity
 
You are viewing the documentation for an earlier version of TeamCity.

Applying Patches

Last modified: 20 April 2023

To apply the patch for vss-native.exe:

  1. Shutdown TeamCity server

  2. Open <TeamCity Server>/webapps/root/WEB-INF/classes/bin

  3. Backup existing vss-native.exe

  4. Copy new file replacing the original one

  5. Start the server

To apply full VSS plugin patch:

  1. Shutdown TeamCity server

  2. Open <TeamCity Server>/webapps/root/WEB-INF/classes/bin

  3. Backup existing vss-native.exe

  4. Copy new file replacing the original one

  5. Open <TeamCity Server>/webapps/root/WEB-INF/classes/jetbrains/buildServer/buildTriggers/vcs/vss folder

  6. Backup all files there. Make sure no extra files are created under <TeamCity Server>/webapps/root/WEB-INF/classes path

  7. Remove all files under that path

  8. Unpack all class files from archive to <TeamCity Server>/webapps/root/WEB-INF/

  9. Start the server

Capturing Logs From VSS-native



Copy to some folder vss-native.exe. This file can be found under TeamCity temp folder. The name would be TC-VSS-NATIVE-<some numbers>.exe. Run this program with /log switch. For commandline documentation, please start the process.

Microsoft Team Foundation Server Integration



To apply the patch for tfs-native.exe:

  1. Shutdown TeamCity server

  2. Open <TeamCity Server>/webapps/root/WEB-INF/classes/bin folder

  3. Backup existing tfs-native.exe

  4. Copy new file replacing the original one

  5. Start server

To apply full VSS plugin patch:

  1. Shutdown TeamCity server

  2. Open <TeamCity Server>/webapps/root/WEB-INF/classes/bin

  3. Backup existing tfs-native.exe

  4. Copy new file replacing the original one

  5. Open <TeamCity Server>/webapps/root/WEB-INF/classes/jetbrains/buildServer/buildTriggers/vcs/tfs

  6. Backup all files there. (Make sure the are no extra files created under <TeamCity Server>/webapps/root/WEB-INF/classes path)

  7. Remove all files under that path

  8. Unpack all class files from archive to <TeamCity Server>/webapps/root/WEB-INF/

  9. Start the server

Capturing Logs From TFS-native



Copy to some folder tfs-native.exe. This file can be found under TeamCity temp folder. The name would be TC-TFS-NATIVE-<set of digits>.exe. Run this program with /log switch. For command-line parameters help, just run the process with no parameters. Log files would be created under TEMP directory in TeamCity.NET folder. For each process new log file is created.

.NET Runners



To patch .NET part of .NET runners:

  1. Open <TeamCity Server>/webapps/root/update/plugins/

  2. Copy dotNetPlugin.zip to temp folder

  3. Backup dotNetPlugin.zip

  4. Extract dotNetPlugin.zip

  5. Replace contents of /bin folder with new files.

  6. Pack files again. Make sure there is no files in the root of archive.

  7. Replace dotNetPlugin.zip file on the server.

  8. All build agents should upgrade automatically.

  9. Run the builds.

To enable logging from .NET runners:

  1. Open <TeamCity Server>/webapps/root/update/plugins/

  2. Copy dotNetPlugin.zip to temp folder

  3. Backup dotNetPlugin.zip

  4. Extract dotNetPlugin.zip

  5. Copy /bin/teamcity-log4net-debug.xml to /bin/teamcity-log4net.xml

  6. You may patch Log4NET config file if needed.

  7. Pack files again. Make sure there are no files in the root of archive.

  8. Replace dotNetPlugin.zip file on the server.

  9. All build agents should upgrade automatically.

  10. Run the builds.

By default all log files will be stored under <TeamCity agent>/temp/buildTmp/TeamCity.NET folder, log files are created for each process.