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

In Part 1 of this series I described the background of the Team Explorer Everywhere 2010 (TEE) tool and its usefulness when working on non-Microsoft OSes.  I then listed the System Requirements for TEE and proceeded to list the steps required to install the Eclipse IDE which will host the TEE Eclipse plug-in.

In Part 2 I continued with the steps necessary to download and install the TEE Eclipse plug-in into the Eclipse IDE.

In Part 3 I will complete the series by showing how to connect your newly installed Team Explorer to your Team Foundation Server 2010 instance along with showing the ALM tools now available to you.

Quick Links

Part 1 – Background, System Requirements and Installation of Eclipse on Mac OSX “Snow Leopard”

Part 2 – Installation of Team Explorer Everywhere 2010 into Eclipse

Configuring Team Explorer Everywhere 2010 to connect to Team Foundation Server 2010

1. At this point you should have Eclipse and TEE installed and your Eclipse IDE should look something like this.

image

2. To make Team Explorer more readable we are going to move it so that it sits in the same area of Eclipse as Package Explorer.  To do this you can simply drag the Team Explorer tab and drop it on top of Package Explorer.

image

3. When you are done Eclipse should look like this.  Now you need to connect to Team Foundation Server.  To make this connection, click on the Add existing team project icon on Team Explorer’s toolbar.

image

4. When the Microsoft License Agreement window appears, read it thoroughly and then check the I have read and accept… checkbox then click the Next button.

image

5. In the Product Key dialog, enter your Product Key.  If you don’t have one yet or wish to evaluate TEE then simply select the Use a full featured version… checkbox.  This will configure TE as trial software for 30 days.  If you get a key later you can simply enter it in TEE without having to reinstall.  Click on the Next button to continue.

image

6. In the TFS Server dialog you will enter the connection information need to hook into TFS.  When you finish entering this information, click the Next button.

  • Server: http://[your_tfs_server]:8080/tfs
  • Username: your account name in TFS
  • Domain: your account’s domain name (contact your TFS Admin if you aren’t sure)
  • Password: the password for the account you entered in the Username field.
  • Save Password: check this box if you want TEE to not prompt you for your password every time you connect to TFS.

Note: If you check the Save Password checkbox your password will be saved as plain text and will be visible to others that may have access to your computer.  Please be aware of the possible security ramifications if your computer is shared with others.

image

7. In the Team Project dialog you will select the appropriate Team Project Collection and one or more Team Projects.  In most cases there will only be a single Team Project collection.  Select as many Team Projects as you normally work within.  If you aren’t sure which to select, contact your Team Foundation Server administrator or team lead.  Click the Next button.

image

8. In the TFS Workspace dialog you will select a Team Foundation Server workspace.  This is not the same as the Eclipse workspace that you selected earlier.  You can safely keep the defaults and click the Finish button.

image

9. If everything worked out, you should now be seeing something similar to the picture below.  The top node is your selected Team Project Collection and the node (or nodes) directly underneath are your Team Projects.  If you expand the first Team Project node (JavaCalcAgile in our case) you will see the nodes for the Work Items engine, Documents (Sharepoint document repository), Build engine (automated builds) and Source Control.

image

Congratulations!  You now have Team Explorer Everywhere 2010 installed and connected to Team Foundation Server 2010.

Quick Links

Part 1 – Background, System Requirements and Installation of Eclipse on Mac OSX “Snow Leopard”

Part 2 – Installation of Team Explorer Everywhere 2010 into Eclipse

 

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

In Part 1 of this series we discussed the background behind Microsoft’s Team Explorer version for non-Microsoft operating systems called Team Explorer Everywhere 2010 (TEE).  It also listed the System Requirements laid out the initial steps needed to install and configure TEE on a Mac OSX “Snow Leopard” machine.  That first part gave the installation steps for the Eclipse IDE.

Part 2 will show the steps needed to install Team Explorer Everywhere 2010 into the Eclipse IDE.

Quick Links

Part 1 – Background, System Requirements and Installation of Eclipse on Mac OSX “Snow Leopard”

Part 3 – Configure Team Explorer to connect to Team Foundation Server 2010

Download Team Explorer Everywhere 2010

1. Open a Safari window and navigate to http://www.microsoft.com/downloads/details.aspx?FamilyID=af1f5168-c0f7-47c6-be7a-2a83a6c02e57&displaylang=en

2. Click on the download files below link.

image

3. Click on the Download button next to TFSEclipsePlugin-UpdateSiteArchive010.0.0.zip.  The file will be downloaded into your Downloads folder. When the download completes, MacOS will have stripped the .zip extension from the file.  You will have to add it back in.

image

Install Team Explorer Everywhere 2010 into Eclipse

4. Open Eclipse to workbench.

image

5. Select the Help | Install New Software… menu item.

image

6. In the Install dialog, click on the Add button to add a new site.

image

7. In the Add Repository dialog enter the following and then click the Ok button

  • Name: Local Team Explorer plug-in archive
  • Location: /Users/[your account name]/Downloads/TFSEclipsePlugin-UpdateSiteArchive010.0.0.zip where [your account name] is your login account.

image

8. Back in the Available Software dialog, select the Visual Studio Team Explorer Everywhere 2010 item’s checkbox then click the Next button.

image

9. In the install Details dialog, review your selection and click the Next button.

image

10. In the Review Licenses dialog, read the entire license agreement (you’d be the first) and select the I accept… radio button if you agree.  Click the Finish button to install.

image

11. Wait a bit for the installation to finish.

image

12. Let Eclipse restart after installation.

image

13.When Eclipse comes back up, select the Window | Show View | Other… menu item.

image

14. In the Show View dialog, expand the Team Foundation Server node and select the Team Explorer node then click the Ok button.

image

15. The Team Explorer tab will be shown docked at the bottom of the Eclipse window.

image

In Part 3 of this series we will configure Team Explorer to connect a Team Foundation Server 2010 server.

Quick Links

Part 1 – Background, System Requirements and Installation of Eclipse on Mac OSX “Snow Leopard”

Part 3 – Configure Team Explorer to connect to Team Foundation Server 2010

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