Install and Configure Team Explorer Everywhere on Mac OSX – Part 1

I occasionally come across a client that has most of their development happening on Windows machines but their designers work on Macs.
This request happens often enough that I need to document it but infrequently enough that I don’t remember between occasions, so I’m going to document the procedure here.  This will be done in 3 parts.  The first part (below) will describe the actual installation of the Eclipse IDE and addition of TEE.  The second part will describe the installation of TEE into Eclipse.  Part 3 will show how to connect TEE to your TFS 2010 installation.

Quick Links

Part 2 – Installation of Team Explorer Everywhere 2010 into Eclipse
Part 3 – Configure Team Explorer to connect to Team Foundation Server 2010

Background

When we install Team Foundation Server we need to bring all of the team members into the repository but we don’t want to force the Mac folks to change to a Windows-based machine.  We could force them to run Parallels and then use Team Explorer from Windows but this is counter to one of the main pillars of TFS…

Let the user work where they are most comfortable.

To that end, Microsoft has provided a Team Explorer version that runs on non-Windows and Windows operating systems named (appropriately enough) Team Explorer Everywhere 2010, hereafter called TEE.  In fact, it will run pretty much anywhere you can run Eclipse-based IDEs.
As you may recall, Microsoft purchased the Teamprise assets (and team) from SourceGear back in November 2009.  Team Explorer Everywhere 2010 is the first release of the updated bits from that acquisition.

System Requirements

Here are the formal system requirements from Microsoft’s download page:

Supported Operating Systems:

  • Windows XP SP2
  • Windows Vista
  • Windows 7 (x86, x64)
  • Linux with GLIBC 2.3 to 2.11 (x86, x86_64, PowerPC)
  • Mac OS X 10.4 to 10.6 (PowerPC, Intel)
  • Solaris 8, 9, 10 (SPARC, x86, x86-64)
  • AIX 5.2 to 6.1 (POWER)
  • HP-UX 11i v1 to v3 (PA-RISC, Itanium)

Hardware:

  • 1 GHz or faster processor
  • 1 GB RAM or more
  • 1 GB of available hard-disk space; a portion of this disk space will be freed after installation if the original download package is removed from the hard drive

Any of the following IDEs:

  • Eclipse 3.0 to 3.5 on Windows, Linux, Mac OS X, Solaris, AIX, or HP-UX
  • IBM Rational Application Developer 6.0 to 7.5 on Windows
  • IBM Rational Application Developer 7.0 to 7.5 on Linux
  • Additional IDEs based on Eclipse 3.0 to 3.5 are supported including Adobe Flex Builder 3 and Aptana Studio 2.0

Any of the following versions of the Java runtime:

  • Sun Java™ 1.4 to 6, or IBM Java™ 1.4 to 6 on Microsoft Windows
  • Apple Java™ 1.4 to 6 on Mac OS X
  • Sun Java™ 1.5 to 6 on Linux or Solaris
  • IBM Java™ 1.5 to 6 on Linux or AIX
  • HP Java™ 1.5 to 6 on HP-UX

Eclipse Installation

Note: We will be installing onto Mac OSX 10.6.2 “Snow Leopard” today.

1. Start by opening Safari (or any web browser) and navigate to http://eclipse.org and click on the Download Eclipse button.
image
2. On the Downloads page, select the Eclipse IDE for Java Developers link.  Select either the 32- or 64-bit versions.
image
3. On the mirror selection page, click on the big, green Download arrow.
image
4. Eclipse will download into your Downloads folder.
image
5. When the download completes, open the Downloads folder and double-click on the eclipse-java-helios-macosx-cocoa.tar.gz file to have the Archive Utility extract Eclipse into its own folder in the Downloads folder.

NOTE: A commenter advised me that it is probably better to extract Eclipse to a folder under the Applications folder instead of the Downloads folder.  If you feel that is a better place for it, then please go ahead and just use that as a reference point in the rest of the article. – Steve

image
6. Open the Eclipse folder and double-click on the Eclipse application icon to launch Eclipse.
image
7. When Eclipse launches it will prompt you to select a Workspace. The Workspace is the location that you files reside within while working in Eclipse.  Keep the default value will place all of your files under your Documents folder.  You can tick the Use this as the default and do not ask again checkbox if you don’t want to be prompted for your workspace every time you open Eclipse.  Click the Ok button to continue.
image
8. On the Welcome page, click on the Workbench icon.
image
9. Congratulations!  You now have Eclipse installed on your Mac.
image

In Part 2, we will install Team Explorer Everywhere 2010 into Eclipse.

Quick Links

Part 2 – Installation of Team Explorer Everywhere 2010 into Eclipse
Part 3 – Configure Team Explorer to connect to Team Foundation Server 2010