Vcs-worker installation

Vcs-worker

Starting from TeamCity 8.0 it is possible to use additional processes (vcs-workers) to serve version control operations. Every VCS operation could be executed either inside TeamCity server or could be sent for execution to a connected vcs-worker

To install the vcs-worker:

• open Administration | Vcs-worker page on TeamCity server and download vcs-worker.zip
• extract vcs-worker.zip to the target machine and open port 9888 in firewall
• start vcs-worker with <vcs-worker>/bin/agent.bat start or <vcs-worker>/bin/agent.sh start command
• set JAVA_HOME environment variable with path to installed Java JVM 1.6+
• make sure you can open vcs worker address in browser from server TeamCity server
• open <TeamCity data directory>/config/vcs-worker.properties.dist
• un-comment worker.1.url line (remove #) and specify URL to installed vcs-worker, i.e. http://vcs-worker-host:9888
• copy vcs-worker.properties.dist to vcs-worker.properties
• no TeamCity server restart is required

Additional steps for advanced configuration of vcs-worker:

• check <vcs-worker>/conf/vcs-worker.properties.dist for more options
• rename <vcs-worker>/conf/vcs-worker.properties.dist to vcs-worker.properties in order to apply the change
• restart vcs-worker to apply the change

Additional steps for TeamCity server configuration:

• check <TeamCity data directory>/config/vcs-worker.properties.dist for more options
• apply changes into vcs-worker.properties file
• no restart is required

All connected vcs-workers are listed under Vcs-Worker tab on server administration