Gaffer-Tape Engineering

Installing TFS 2010 Beta2 on Windows Home Server

2009-10-30T21:41:40Z

After many attempts to install TFS 2008 on WHS I ended up giving up on the whole idea. Reporting Services and WSS kept throwing up roadblocks periodically and seemed to make it more hassle that it’s worth. From the first rumbling I heard internal regarding TFS 2010 and new configuration options however I had hope that things would be considerably easier. Enter TFS Basics.

TFS 2010 can now be configured with or without SharePoint and Reporting Services, it can also now be installed against SQL Express. In fact, if you install TFS 2010 and follow the steps to install as TFS Basic SQL Express will be installed and configured automatically!

Installation on Home Server is a breeze, get the bits from MSDN and install from the Tfs-x86 folder. Once installation completes the configuration wizard should open, click on “TFS Basic” in the left hand menu and click next a few times. Installation is that simple! The rest of this post will cover how to configure your instance of TFS to use your homeserver.com certificate and enable you to connect via the internet.

Without further adieu…

Open a remote connection to your Home Server using Remote Desktop.
Download and install TFS 2010 Beta2 (easy)
Install TFC 2010 Beta2 somewhere and test local connectivity
Follow these steps to export the Home Server certificate, you will be looking for one that matches your *.homeserver.com (or similar) URL.
http://www.microsoft.com/technet/prodtechnol/WindowsServer2003/Library/IIS/2cfeeba2-511f-47e8-913c-f196b74e6a44.mspx?mfr=true
Open inetmgr and find the "Team Foundation Server" website then right click and open the properties dialog. In the Directory Security tab click on "Server Certificate" and the certificate wizard should show itself. Click on Next.
We will want to import the certificate so click on the radio button then click next.
Navigate to the location of the PFX file from the previous step and click next.
Click next and enter the name of the password you entered for the PFX file.
Enter the port you wish to use for SSL, 8181 for example.
Review the details and click next.
Click on the Web Site tab and if not present, enter the port specified for SSL in the SSL Port text box.
Done.

That should be it, you will need to follow the steps to forward the ports on your router such that a public port on your router passes through to the SSL port on your Home Server and then you will be able to connect locally and remotely. Please be aware that some routers will route their external address to their control panel. If you see issues connecting to TFS using the public name then try to connect to your WHS Remote Access page and ensure it connects to your Home Server rather than the router.

Hopefully your router will play ball and you will be up and running, otherwise likely a bit of Binging will get you the help you need. Enjoy and feel free to add comments if you have any questions.

Jason

Unable to Create Team Projects On a Fresh Install of TFS 2008 SP1 on IIS7; TF201072

2009-09-15T17:13:08Z

I’ve just installed TFS 2008 SP1 (slipstreamed) and could connect to my new server however could not create team projects. Having run the BPA and it come back clean I was a little baffled until I stumbled upon the IIS role and spotted the “HTTP Redirection” was not installed. Installed this and project creation now successful.

For those searching for this issue I’ve included the exception below in the hope that search engines will index it:

Event Description: TF30207: Initialization for plugin "Microsoft.ProjectCreationWizard.WorkItemTracking" failed
Exception Type: Microsoft.TeamFoundation.WorkItemTracking.Client.ImportWorkitemTypeException
Exception Message: TF201072: A user or group could not be found. Verify that the users and groups used in your work item type definition have been added to Team Foundation Server.

Yet again, if step 3 fails it’s because I missed step 2. I should’ve double checked this when installing IIS, I guess overconfidence leads to mistakes!

Hope this helps,
Jason

VSTS 2010 Beta 1 Installation

2009-05-20T20:18:17Z

Is easy. Very easy in fact, upgrade isn’t much more difficult either! There is a fantastic video showing how to download and install the bits need to test VSTS 2010 beta 1 at the 10-4 home on msdn.com

http://channel9.msdn.com/shows/10-4/10-4-Episode-20-Downloading-and-Installing-Visual-Studio-2010-Beta-1/

I’d recommend having a look around the site, 10-4 has some very good videos on there that are worth watching.

http://channel9.msdn.com/shows/10-4/

One last thing before I sign off this post, Reporting Services and SharePoint are no longer requirements for TFS. In fact, if you upgrade to TFS 2010 (in the beta at least) you have an option not to configure these on the upgraded server. I know there are plenty of people using TFS only for source control so the next release should make a lot of people happy. Of course for the people who use everything and have massive instances running, you will not be disappointed either, trust me on that!

Regards,

Jason

Windows Home Server Power Pack 2 and Recorded TV

2009-04-01T13:22:06Z

Power Pack 2 has been released, huzzah! There are a lot of new features in the box for remote access but my favourite has to be the Media Centre Connector. This enables your Media Centre to access your Home Server shares a lot easier, including recorded TV.

Now, your Media Centre will still be recording to a local hard disk so you will need to either manually copy your recorded TV files across to your server or do what I do and use a scheduled task. I have created a scheduled task which calls robocopy using a few switches to move old files.

robocopy.exe “e:\recorded tv” “\\server\recorded tv” /minage:7 /mov /z

The above command will move all recorded TV to the given share from the given local source when it reaches the minimum age. The /z switch makes it restartable in case of network issues.

For me, PP2 has been fantastic for this feature alone. My Media Centre is built using a laptop hard disk to keep things quieter which means that it can get cramped on the disk. This solves that problem superbly.

My thanks to the WHS team :)

Jason

Custom Build Tasks

2009-03-19T18:48:33Z

Just came across a great project to create a number of customer build tasks for TFS Build. It is quite in depth and includes the ability to zip files produced by the build and use FTP to transfer files from within the build definition.

http://msbuildtasks.tigris.org/

Enjoy.

Jason

Troubleshooting the TFS Data Warehouse

2009-03-19T16:55:53Z

A nice guide someone just pointed out to me on MSDN:
http://msdn.microsoft.com/en-us/library/ms244674.aspx

Seems to be a great guide to troubleshooting data warehouse issues, I guess the clue was in the name :)

Jason

TFS Backup to Live Mesh

2009-01-26T18:03:00Z

I’ve been thinking about the “little guys” of late and solutions not always available to the small dev groups, offsite backup being one of these. Windows Live Mesh is a solution I’m using for my photo library as the Live Desktop has 5GB of online storage available, all you need to do is set a folder to sync to it.

So, “how can I sync TFS backup’s to Live Mesh?” you cry! Easy.

Follow this guide to set up a maintenance plan for the TFS databases and specify the folder you want them to be backed up to. Once complete, add the specified folder to Live Mesh to grab the contents of that folder every time a new file is added or updated.

Job done.

One thing to bare in mind when setting this up is the legal ramifications of backing up your data to 3rd party servers. For the hobbyist this isn’t really an issue however for professionals or other parties with business concerns you should look into the legal aspects of hosting your IP in such a manner.

Legal shenanigans aside, enjoy!

Jason

TFS Permissions: Allow vs. Deny (and a fix)

2009-01-21T17:37:25Z

Allow and Deny permissions can cause confusion in TFS, for the most part deny overrides allow which means an Admin can lock themselves out of a project if they are not careful. I’ll reference the other blogs I’ve read with regards to explaining the issue in depth as they have done it better than I could however I will share a solution in case you see yourself in this situation, recently provided to me by one of my customers.

I’ve never been one to let my pride get in the way of good advice so thank you Niels for the fix :)

“TF permission /server:hostname /inherit:Yes”

References:

http://teamfoundation.blogspot.com/2008/07/deny-or-allow-who-wins.html
http://teamfoundation.blogspot.com/2008/07/deny-or-allow-who-wins-sequel.html

Team Foundation Server Permissions
http://msdn.microsoft.com/en-us/library/ms252587.aspx

TF.exe Command-Line Utility Commands
http://msdn.microsoft.com/en-us/library/z51z7zy0.aspx

Resetting Reporting Services 2005 for Team Foundation Server

2008-12-02T17:55:00Z

Nine times out of ten most TFS related Reporting Services 2005 issues can be resolved by resetting everything back to the original settings. Follows is a guide on how to do excatly that. Please ensure you back everything up before doing this and it is at your own risk. Saying that it's vary rare it goes wrong but consider yourselves warned :)

Connect to reporting services using the Reporting Services Configuration tool on the application tier entering the name of the server hosting Reporting Services and the database instance name
In “Report Server Virtual Directory” check “Apply Default Settings” then “Apply”
In “Report Manager Virtual Directory” check “Apply Default Settings” then “Apply”
In “Windows Service Identity” ensure that the identity is either “Local Service” for a single tier machine or “Network Service” for a dual tier machine
In “Web Service Identity” ensure that “Report Server” is selected for both “Report Server” and “Report Manager” then click apply
In “Database Setup” ensure the host name of the data tier is entered (server name if single tier), “ReportServer” for the database name and “Service Credentials” for the credentials type
LEAVE SHAREPOINT INTEGRATION BLANK
On the “Encryption Keys” page click the delete button then OK. The only items encrypted at the data sources and we will rebuild them in a later step
In “Initialization” ensure that the host name of the report server is listed as “Initialized”, if this is not the case select the server and click initialize

Your server is now back to the default settings for Team Foundation Server, all we need to do now is recreate the Reporting Services data sources for Team Foundation Server. Please follow the steps in this post to set them up.

After this should be good and cooking.

Jason

Recreating SQL Server Reporting Services 2005 Data Sources for Team Foundation Server

2008-12-02T17:39:00Z

Under some situations you may come across an issue that requires you to delete and recreate the data sources for Reporting Services 2005 for your instance of TFS. An example would be where you need to rebuild your server from a backup but for whatever reasons the SSRS encryption keys were not backed up themselves. This post will detail how to recreate those data sources.

To confirm or change the details for the connection to the Data Tier from Reporting Services you need to follow these steps, as with most procedures of this nature you need to be logged in as the TFSSETUP user.

Connect to http://apptier/reports and you should see a page with a folder for each team project and two data sources: TfsReportsDS and TfsOlapReportsDS
Click on TfsReportsDS and use the following settings:
Connection Type: Microsoft SQL Server
Connection String: Data source=datatier;initial catalog=TfsWarehouse
Select "Credentials stored securely in the report server" and enter the credentials for the TFSREPORTS account
Tick the "Use as Windows credentials when connecting to the data source" box
Click the apply button then navigate to the home page
Click on the TfsOlapReportsDS data source and enter the same as above though ensuring the Connection Type is set to "Microsoft SQL Server Analysis Services"

If you followed the above you should be back up and running.

Jason

Team Foundation Server 2008 Disaster Recovery

2008-11-27T16:39:00Z

As I mentioned some time ago I have been writing a few documents to compliment the official documentation. I figured I would start with a flourish and post this document first. I have pasted the Abstract below as a taster for the rest of the document:

The purpose of this document is to outline a disaster recovery strategy for Team Foundation Server and provide all the information required to implement the same. The purpose of the plan in this document is to get your TFS back online as soon as possible assuming your servers have been rendered inoperable due to unforeseen circumstances.

The premise is simple, how to setup and configure your instance of TFS for failover if your primary servers go down. The document includes recovering your instance to standby application and data tiers as well rather than just the application tier. This is provided as-is without warranty, please test before implenting!

Comments welcome, enjoy.

Jason

Useful Links

2008-10-22T14:04:00Z

This post is more for myself than anyone, it is a collection of links difficult to find that are nevertheless very useful. If they can help others as well then all the better.

Team Foundation Server

Customizable Team Foundation Build Targets
Team Foundation Build Tasks
Team Build 2008 Build Definitions

Windows Home Server

We Got Served

More to be added over time and feel free to add yours to the comments, I'll add them to the list if useful :)

Regards,
Jason

TFS Activity Logging

2008-09-19T11:58:00Z

There is a feature of TFS that allows all commands run through it logged to an internal database. This is the TfsActivityLogging database and one of its key features is that it can never grow to large. If enabled, activity logging will log all commands with a minimal overhead and will only log the last seven days. Here is how you enable it and a brief tutorial on how to use it.

Enabling TFS Activity Logging

WARNING: Changing the web.config file for a web application in IIS will force an application pool reset! Consider yourself warned!

open the <TFS Instal Path>\Webservices\web.config file
locate the following element <add key="commandLogging" value="None"/> and change "None" to "All"
The application pool will restart and logging will be enabled until the above value is changed back to "None"

Logging is now enabled, how do you use it I hear you cry?

Viewing the TfsActivityLoggging Data

WARNING: Do not touch ANY other databases that TfsActivityLogging, to do so may severly damage your instance of TFS and put your data at risk! Seriously, just don't do it. Even if you have backups. Ever.

Connect to the Data tier using SQL Server Management Studio, right click on "TfsActivityLogging" and run the following SQL query:

Select * from tbl_command c left join tbl_parameter p on c.commandid = p.commandid

This will return all commands. For a Version Control commands append the following to the above;
where c.Application = 'Version Control'

other applications are: Data Warehouse, Integration, WorkItemTracking, Proxy

Have fun,
Jason

PS. Seriously, don't play with your databases, it ends badly!

Windows Home Server and Live Mesh

2008-07-25T15:46:00Z

Regular readers of my blog will know I've been a fan of Foldershare on Home Server for a while now. The main reason for this is a simplified version of "Offline Files" that works across the internet. It also works as a nice backup when remote access fails and I cannot connect normally for some reason, usually on those days when I forget my iPod and have nothing to listen to...

Enter Live Mesh.

I received an invite from a friend and decided to give it a go, as is my want. To say I was a impressed is an understatement, Mesh does a lot that Foldershare does, namely sharing folders, but it also has online backup of folders to the tune of 5GB and remote desktop capabilities as well! Apparently a Mac and Windows Mobile client will be coming soon which will be interesting, I assume the Mac client will offer the same functionalities as the PC client though how it will work on Windows Mobile has me truely intrigued.

I think my favourite feature is similar to Foldershare insofar as it works as a backup for those occastions where remote access fails. Using Mesh on my Home Server I can still get to the server console and my files now rather than just my files.

Mesh will also be exstensible though the SDK is not yet available, apparently it will allow you to add an application to your mesh though which is promising indeed. I'm thinking that media sharing across clients, remote Home Server notifications and a better remote control guide for MC would be a few likely candidates. Lets hope someone reads this and gets a few ideas!

Jason

Win32 Error Codes and HRESULT Definitions

2008-07-25T15:08:00Z

Not the snappiest of titles though if you are debugging Win32 applications, COM servers or just see a random error code in your event log these two mapges may be of help...

HRESULT Values
Win32 Error Codes

I'll try and come up with something more interesting for the next post...

Jason