Geeks With Blogs

News

View √Čtienne Tremblay's profile on LinkedIn
ET's VS and TFS World Fascinating tidbits about VS and TFS and .NET (well I hope...)

So you just finish installing TFS, it works great and you’re about to give out the name to all your devs so they can start using the great new features in TFS but the name of the server uses corporate naming standard and is called rtmtgbs001 that is a great name for the ITO folks they know the scheme and can find that server to patch it and all that but for devs and project manager, and other consumers of TFS data it’s a bit hard to remember and if you have many servers it because quite difficult to remember.

So you create a new url in DNS called tfs.myorg.mycompany.com viable internally (note I’m not talking about make it available on the internet yet that will be implemented in SP1 I’ll come back to that when I have more info) so what should you do to accomplish this. Here are the steps to do that for a single server install (note this probably will work for a dual server install as well I just have not tested it). Note also that this is not I repeat not are windows server rename, the name (netbios, domain sid, etc) stays the same, its just to change the access of TFS to a friendlier name.

I’m writing this entry to try to unravel the mystery of this, I have looked around on the internet to find a solution for this and got a lot of conflicting answers in forums and in the Microsoft documentation. So I contacted my friends at Microsoft and got what needed to be done. This may vary from site to site but at least it will be mostly correct. As always test this before implementing in production. I have done those steps on my production servers and all is good.

Step 1) Run TFSAdminUtil ActivateAT with new friendly name this updates any internal references to use a friendly name, including the web service subscriptions.

TFSAdminUtil ActivateAT tfs.myorg.mycompany.com

Step 2) In order for the Team Sites to be able to display the reports web parts from reporting services correctly you need to go to HKLM\Software\Microsoft\VisualStudio\8.0\TeamFoundation\ReportServer and change the key to the friendly name.

Step 3) Go to :\Program Files\Microsoft Visual Studio 2005 Team Foundation Server\Web Services and edit the Web.config file note that all the [] brackets should be <> it's just that html being what it is none if my quotes where visible it tought it was html.

Change

[ADD value="http://rtmtgbs001:8080" key="TFSNameUrl" /]
[ADD value="rtmtgbs001 " key="TFS Name" /]

To

[ADD value="http://tfs.myorg.mycompany.com:8080" key="TFSNameUrl" /]
[ADD value="tfs.myorg.mycompany.com" key="TFS Name" /]

There is also a comment key called TFSUrlPublic uncomment it and change to friendly name this is required so the project alert WI links use the friendly name

Change

[ADD value="https://www.microsoft.com:8081" key="TFSUrlPublic" /]

To

[ADD value="http:// tfs.myorg.mycompany.com:8080" key="TFSUrlPublic" /]

Step 4) we need to fix the TFSServerScheduler config file, first stop the service in services management console then go to :\Program Files\Microsoft Visual Studio 2005 Team Foundation Server\TFSServerScheduler and edit TFSServerScheduler.exe.config

Change

[ADD value="http://rtmtgbs001 :8080" key="BisDomainUrl" /]

To

[ADD value="http:// tfs.myorg.mycompany.com:8080" key="TFSNameUrl" /]

This change is necessary to ensure that the scheduler goes to the correct URL to kick the adapters. Note that BisDomainUrl was changed to TFSNameUrl this is not a typo.

Step 5) I would suggest an IISRESET and you should be good to go.

So to recap, make sure you have the new name available in your company DNS before proceeding, try to browse to the new name url like http://tfs.myorg.mycompany.com before proceeding to see if you can see the top level WSS site like before. If you feel confident that the name is resolvable, then proceed with steps 1 to 5.

Posted on Friday, July 28, 2006 11:03 AM Visual Studio Team System | Back to top


Comments on this post: Changing to a friendly Team Foundation Server Name

# Getting ready for TFS SP1
Requesting Gravatar...
As the date for the TFS SP1 Beta approaches, there&rsquo;s one feature&nbsp;that will make TFS much easier...
Left by My VSTS Blog on Jul 28, 2006 9:01 PM

# re: Changing to a friendly Team Foundation Server Name
Requesting Gravatar...
Thanks, this was very useful.
Left by Eric on Sep 08, 2006 2:53 PM

# re: Changing to a friendly Team Foundation Server Name
Requesting Gravatar...
can I change the port too?!.. or works in port 8080?
Left by Junior on Oct 01, 2006 4:25 PM

# re: Changing to a friendly Team Foundation Server Name
Requesting Gravatar...
This should work with the port you used to setup originally. I wouldn't change the TFS port with this procedure. I haven't tried that. Just rereading you would need to change the port in IIS, then do this whole procedure and use the new port. If you try it and it works let me know I will amend the post and add this info to it.

Cheers,

ET
Left by ET on Oct 02, 2006 2:13 PM

# re: Changing to a friendly Team Foundation Server Name
Requesting Gravatar...
Fantastic, thanks for the help...
Left by Martin Hinshelwood on Jan 02, 2007 10:09 AM

# re: Changing to a friendly Team Foundation Server Name
Requesting Gravatar...
You are very welcome.

Cheers,
ET
Left by ET on Jan 02, 2007 1:12 PM

# re: Changing to a friendly Team Foundation Server Name
Requesting Gravatar...
Given SP1 is now out, could you make a tutorial on how to do this with a public DNS?
Left by Albert on Feb 03, 2007 3:57 PM

# re: Changing to a friendly Team Foundation Server Name
Requesting Gravatar...
I think that this is a simplistic approch that is well documented on msdn. If you have the network setup that I do and [servername] does not work, [servername].uk.org.com does, but that a friendly name like tfs.intrnet.org.com does not (proxy setup), then you are looking at selecting which options to change and what not to...

So this option does not work for me. I will requre the new features of SP1 to provide a publiclike url that is availale on our main network that is not the server name.
Left by Martin Hinshelwood on Mar 19, 2007 4:48 PM

# re: Changing to a friendly Team Foundation Server Name
Requesting Gravatar...
I thought I should qualify that this blog DID help me a lot...It pointed me in the right direction and I did find a partial solution because of it...It just did not work for me!

Luck of the draw...
Left by Martin Hinshelwood on Mar 19, 2007 4:55 PM

# re: Changing to a friendly Team Foundation Server Name
Requesting Gravatar...
thanks for you comments Martin. I'd like to qualify also that this is for internal access by VPN or intranet. I will revisit this (when I have a minute like Albert requests) for external access via the internet with SP1. I'm sorry that this did not solve your issue. I'm not sure I understand what you mean by network setup? or proxy setup? are you talking about the TFS Proxy server or an internet proxy?
Left by ET on Mar 19, 2007 10:45 PM

Your comment:
 (will show your gravatar)


Copyright © Etienne Tremblay | Powered by: GeeksWithBlogs.net