Installing the Team Explorer Everywhere Plug-in and the Command-line Client

You can use Team Explorer Everywhere and Visual Studio Team Foundation Server as part of your development processes with Eclipse to track work items, provide version control, and automate builds. You must install either the Team Explorer Everywhere plug-in for Eclipse or the Cross-platform Command-line Client for Team Foundation Server before you can use those features.

In this topic

- Prerequisites
- Install the Team Explorer Everywhere Plug-in For Eclipse
- Install the Cross-platform Command-line Client for Team Foundation Server

# Prerequisites

You must install a supported version of Eclipse, which you can obtain from the following Web site: Eclipse.org home.

Operating system requirements:

- Windows 10 (x86 and x64)
- Windows 8.1 (x86 and x64)
- Windows 8 (x86, x64)
- Windows 7 (x86, x64)
- Linux with GLIBC 2.3+ (x86, x86_64)
- Mac OS X 10.8+ (Intel only)

Integrated development environment (IDE) requirements:

- IDEs that are based on Eclipse 4.2 and later on Linux, Mac OS X, or Windows.

Java runtime requirements:

- Oracle Java™ 1.7+ or IBM Java™ 1.7+ on Linux
- Apple Java™ 1.7+ on Mac OS X
- Oracle Java™ 1.7+ or IBM Java™ 1.7+ on Windows

Team Foundation Server requirements:

- Visual Studio Team Services
- Visual Studio Team Foundation Server 2017
- Visual Studio Team Foundation Server 2015
- Visual Studio Team Foundation Server 2013
- Visual Studio Team Foundation Server 2012

# Install the Team Explorer Everywhere Plug-in For Eclipse

You must install the plug-in before you can use it in your development processes. You can install into Eclipse directly from the update site, or you can install from the Eclipse Update Site Archive.

#### To install the plug-in from the Update Site

1. Open Eclipse.
2. On the Help menu, choose Install New Software.
3. The Install dialog box appears.
4. Choose the Add button.
5. The Add Repository dialog box appears.
6. For the name, enter "Team Explorer Everywhere"
7. Specify the location of the update site: http://dl.microsoft.com/eclipse/tfs
8. Choose the OK button.
9. In the list of features in the Install dialog box, select the check box that corresponds to the Team Explorer Everywhere Plug-in for Eclipse. If you don't see this option, use the pull-down menu for Work with and find the update site URL you just entered in the list and select it, then select the check box beside the plug-in mentioned above.
10. Choose the Next button two times.
11. If you agree to the Microsoft Software License Terms, accept them and then choose the Finish button.
12. Restart Eclipse when you are prompted.

#### To install the plug-in from the update site archive

Note
The standard update site mechanism above is the preferred installation method, however this requires a connection to the internet and will install the very latest version of the plug-in from Microsoft. If the installation machine is not directly connected to the internet or the organization prefers that a specific version of the plug-in is installed by everyone then following method may more suitable.

1. Use the link on this page to download TFSEclipsePlugin-UpdateSiteArchive-14.134.0.zip.
2. Open Eclipse.
3. On the Help menu, choose Install New Software.
4. The Install dialog box appears.
5. Choose the Add button.
6. The Add Repository dialog box appears.
7. For the name, enter "Local Team Explorer Everywhere update archive".
8. Choose the Archive button.
9. The Repository archive dialog box appears.
10. Find and select the downloaded "TFSEclipsePlugin-UpdateSiteArchive-14.134.0.zip" file as the File name.
11. Choose the Open button.
12. Choose the OK button.
13. In the list of features in the Install dialog box, select the check box that corresponds to the Team Explorer Everywhere Plug-in for Eclipse.
14. Choose the Next button two times.
15. If you agree to the Microsoft Software License Terms, accept them and then choose the Finish button.
16. Restart Eclipse when you are prompted.

# Install the Cross-platform Command-line Client for Team Foundation Server

You can perform many version control operations from the Cross-platform Command-line Client for Team Foundation Server. Before you can use this client, you must install it and configure your shell or system path to include the installation folder.

#### To install the Cross-Platform Command-Line Client for Team Foundation Server

1. Use the link on this page to download TEE-CLC-14.134.0.zip.
2. Unzip the archive (TEE-CLC-14.134.0.zip file) that contains the client.
3. Configure your shell or system path to include the folder to which you unzipped the archive.
4. To verify that the client is working, at a command prompt, type tf, and then press the ENTER key.

If the client is correctly installed, output appears, starting with "Microsoft Team Explorer Everywhere Command-line Client (version 14.134.0)".
For information about any of the commands, you can type tf help Command, where Command is the name of the command for which you want information. For example, you could type tf help checkin. You can also type tf command /help or tf command -help to obtain help.

Note
You can control the behaviour of the command line client by setting environment variables in your shell, such as specifying a HTTP Proxy to use, enable automatic caching of your credentials or control you diff/merge tool. For information on the environment variables to set see the Set Environment Variables topic on MSDN.