Buck Hodges

Visual Studio ALM (VSALM, formerly VSTS) - Team Foundation Service/Server (TFS) - MSDN

December, 2005

Posts
  • Buck Hodges

    Beta TFS MSSCCI plugin now available for VB6, VC6 (not yet VS 2002/2003)

    • 1 Comments

    Brian Harry announced the availability of the beta TFS MSSCCI plugin for VB6, VC6 (not yet VS 2002/2003).

    You can download it at http://www.microsoft.com/downloads/details.aspx?familyid=32202966-EF04-442F-8C5C-88BDF15F551C&displaylang=en.

    Buck

  • Buck Hodges

    How to improve command line performance

    • 7 Comments

    If you are using the tf.exe command line in scripts to convert from another version control system or to run other tasks that involve a lot of calls, there are several factors that have a large impact on the performance.  Other than the command files, all of the following applies to Visual Studio as well, but VS has the significant advantage of amortizing one-time overhead across a long execution time.  The command line pays one-time costs every time it runs, so it's important to minimize those costs when performance matters.

    Check LAN connection settings (applies now and for RTM)

    First, check your LAN connection settings in Internet Explorer (Tools -> Internet Options -> Connections -> LAN Settings).  Often, the best settings are either to have no boxes checked or to have both of the bottom two checkboxes checked, "Use a proxy server" and "Bypass proxy server for local addresses."  The reason is that the .NET 2.0 framework network code gets its settings from the settings in IE.  Prior to the December CTP, there was no way to override this.

    How much difference does it make?  It makes a 1 - 2 second difference per tf.exe execution on our network.  Of course, these settings may not work on your network, either for tf.exe or IE, depending upon your network configuration; you'll need to test it.

    Beginning with the December CTP, there is an optional registry setting that you can use to tell the Team Foundation client to bypass the proxy server without changing your IE settings.  In HKCU (per user) or HKLM (global), you can create the registry entry Software\Microsoft\VisualStudio\8.0\TeamFoundation\RequestSettings\BypassProxyOnLocal of type string with the value "true" to get the improved performance.

    Avoid running tf.exe on the application tier (applies now and for RTM)

    You might think that running tf.exe on the application tier would give you the best performance.  After all, the network communication would be minimized, right?  Well, it doesn't work that way.

    Team Foundation has a registration service that the client uses in order to get to the various services, including version control.  When a client app, such as tf.exe, VS, or your own custom application, needs to use version control, the TF client code must request the service definition from regsistration service on the server.  To avoid constantly requesting service registration information that rarely changes, the client-side registration code maintains a cache and only makes the server call when the cache is out of date.

    However, when the client code executes on the application tier, the client-side registration code detects that it is running on the application tier and does not cache the service registration information.  Additionally, there's a bug (that won't even be fixed for RTM due to being posponed to v2) that results in the client-side registration code requesting the registration information twice.  So, every execution of tf.exe invokes two registration service information requests when run on the application tier.

    The result is that tf.exe is faster when run on a machine other than the application tier (both now and for RTM).  So how much difference does this make?  It can save 1 - 3 seconds.  How much it saves really depends on some additional factors.  The call to get the registration information may take a few hundred milliseconds or so (multiplied by two for the app tier).  The rest of the savings comes from SOAP proxy class not being generated.  The client-side SOAP proxies other than version control use the standard SOAP proxy support provided by the .NET 2.0 framework where the client-side proxy class is generated by wsdl.exe at build time.  At runtime, the framework uses reflection to dynamically generate, compile, and load serialization assembly the first time the proxy class is used.  As you might guess, that's very expensive for the command line.

    The best setup would be a client machine that's connected to an application tier via a fast, local network switch.

    Use NGen with tf.exe (applies to beta 3 refresh and earlier)

    With .NET 2.0, NGen has improved substantially.  NGen generates native image dlls for .NET assemblies and executables (you can find more details on NGen here).  The result is that less time is required to load and run the assemblies.

    The December CTP and beyond will use NGen during setup to create the native images.  For beta 3 and beta 3 refresh, you can use ngen.exe to reduce the time to load and run tf.exe.  You only need to run ngen.exe once.  Bring up a Visual Studio 2005 Command Prompt (Start -> All Programs -> Microsoft Visual Studio 2005 -> Tools -> Visual Studio 2005 Command Prompt), change to the %PROGRAM_FILES%\Microsoft Visual Studio 2005\Common 7\IDE directory and execute the following command.

    ngen install tf.exe

    NGen will examine tf.exe's dependencies and generate native images for them.  The result will be a faster start up time for every execution of tf.exe.  How much time does it save?  This may save up to 200 ms.

    Generate command files for sequences of tf.exe commands (applies now and for RTM)

    Team Foundation Server uses Windows authentication (NTLM) to authenticate users.  That means that every initial request from tf.exe must go through the NTLM handshake.  Since many tf.exe commands make only one or two requests, that means that most requests incur the authentication overhead.  For a long sequence of tf.exe commands, that overhead can really add up.

    If you are going to run a sequence of tf.exe commands, you can put them into a command file.  Preliminary documentation for command files is available here on MSDN.  The documentation refers to some addtional commands that are not available now, such as cd, rem, quit, and exit.  You can also run "tf @" and start typing or piping input as it reads from the standard input stream (experiment with it).

    When you execute a command file, only the first request incurs the authentication overhead.  After that, the authenticated connection is reused[1].  How much time does this save?  Well, there's no quick answer here.  It's the product of the authentication overhead multiplied by the number of authentication requests you can avoid by using command files.  Additionally, it's the runtime startup overhead multiplied by the number of times you would have invoked tf.exe (this isn't nearly as significant if you've used ngen.exe as explained previously).

    Summary

    We've covered the most important command line performance issues that you can control: LAN settings (or TFS registry setting for RC/RTM), not running tf.exe on the application tier, running ngen on the beta 3 tf.exe, and using command files to avoid authentication overhead.  If you follow the recommendations discussed above, the tf.exe performance should be noticeably better.

    ___________

    [1]  Technically, it's the first request on each thread.  Uploads, downloads, and pending adds (if you are adding more than 200 files at a time) use multiple background threads.  If all of the authenticated connections are in use, a thread will open a new connection that must be authenticated.  The authenticated connections are part of a pool (connection group) that are reused as needed.

  • Buck Hodges

    Backing up and restoring Team Foundation

    • 0 Comments

    Rob Caron posted a link to the re-launched VSTS User Education team blog.  It includes a post of the procedures for backing up and restoring Team Foundation Server.  That includes the databases, SharePoint, reports, etc.  It also includes restoring TFS to a different server.  There have been lots of requests for this in the forum, so now's the time to give it a try.

    They have also posted documentation on permissions and the default groups, roles, and permissions.

    Since this is pre-release documentation, be sure to email them with any problems in the documentation.

    [Update 3/2/06]  You can find updated procedures for restoring TFS at http://blogs.msdn.com/vstsue/articles/511396.aspx.

  • Buck Hodges

    Team Foundation Version Control API documentation

    • 7 Comments

    I've mentioned the Team Foundation Version Control client API example before as good way to get started with the API, and there are examples with labels and items too.  You can find documentation for the classes and methods in the Team Foundation Version Control API in the October Visual Studio SDK release.  Once you install it, you can find the Version Control API doc in
    C:\Program Files\Visual Studio 2005 SDK\2005.10\VisualStudioTeamSystemIntegration\Version Control\Object Model (Help 1.x format).zip.

  • Buck Hodges

    The "Filter by solution" button

    • 9 Comments

    You are probably familiar with the Pending Changes window if you've been using Visual Studio with Team Foundation (View -> Other Windows -> Pending Changes).  Have you ever wanted to have the Pending Changes window show only the pending changes for files in the currently open solution and not all of the other changes in your workspace?

    There's button, called "Filter by solution," that does exactly that.  It's located between the Refresh button and the Workspace selector.

    The button acts like a toggle.  When it's in the "active" state, the Pending Changes window restricts the list of pending changes to those involved in the currently open solution.  If you don't have a solution open, the button is disabled.

     

  • Buck Hodges

    Warehouse troubleshooting guide

    • 0 Comments
    Bryan MacFarlane posted a troubleshooting guide for warehouse problems in the MSDN Team Foundation Forum.  If you are having problems with your warehouse or reports, it's a good resource to try to figure out what's going wrong.
  • Buck Hodges

    Source Control Explorer now shows more information about the state of items

    • 3 Comments

    One of the problems that users encounter when using Source Control Explorer is knowing what state the file or folder is in, particularly if it is shown in gray rather than black text.  In beta 3 refresh and ealier, gray text meant that the file or folder was unmapped, cloaked, deleted, or not downloaded.  There was no way to tell a deleted file from a cloaked file, for instance.  It often left users asking the question, "Why is that file (or folder) gray and how do I change that?"

    Recently, we added more information to what Source Control Explorer shows simply by changing the "Latest" column to say more than yes or no. 

    In the screen shot below, you can now see that I have the latest of the folder Mine (the folder itself, we'd have to go into the folder to see the state of the contents); the folder Misc is cloaked; the folder Old has been deleted; and I do not have the latest version of foo.cs.  If I had added an folder that wasn't mapped to the example below, you'd see "Not Mapped" for that folder.

    By default, viewing deleted files and folders is turned off, in which case I wouldn't see the folder Old.  To have Source Control Explorer display deleted files and folders, go to Tools -> Options -> Source Control -> Visual Studio Team Foundation and check the view deleted items setting.

  • Buck Hodges

    Using VS to get the URI for a Team Project

    • 0 Comments

    Someone asked a question today about getting the URI for a Team Project.  James Manning's Team Project code sample showed how to do it using the API.  However, that was overkill in this case.  Bill Essary pointed out that you can select the Team Project in Team Explorer, right-click on it, and choose Properties (rather than right-click, you could just hit F4).  The Properties window shows the URI as the Url property (yes, apparently no one noticed that).

    The URI you get will look something like the following.  All Team Foundation URI's start with "vstfs:///" that will be tranlated to actual server URL's as needed.

    vstfs:///Classification/TeamProject/7c0d0a50-e31a-4bed-8e48-a99bc95def95

    The URI isn't needed for any normal day-to-day tasks.  Occasionally, you may have the need for it for some advanced admin activity.  TfsSecurity, for example, can accept Team Project URI's for some options.

  • Buck Hodges

    New CTP of Team Foundation is available (NOT supported by go-live)

    • 0 Comments

    Jeff Beehler has just written a post about the newly-released December CTP of TFS.  Jeff describes some of what changed, but probably the most important thing is that it is NOT supported under the go-live license.  There will not be any migration scripts to move to it or from it.

    The reason for that is that this release hasn't been through much formal testing.  Sure, we upgraded our dogfood system with it, so we think it works well enough.  But the goal here was to get a drop out for folks to test out all of the changes we've made, though not in production use.

    If you do try it out and find a bug, or if you find a bug in beta 3, please file it through the MSDN Product Feedback Center.  All bugs filed there get reviewed and assigned to the appropriate dev, as appropriate.  The bugs from PFC are automatically imported into TFS Work Item Tracking in our dogfood system.

Page 1 of 1 (9 items)