Installing eScrum 1.1 for TFS 2008

I just wanted to take a few moments to note some of the struggle points I encountered while installing the eScrum 1.1 template on my company’s TFS 2008 box. The environment is a single-server TFS2008 install on a Windows 2008 server and a separate Windows 2008 Server running a MOSS farm that will serve up the SharePoint bits for our TeamProjects.

One issue I had was that the configuration utility that launches at the end of the install didn’t seem to let me do anything – I would either get an exception window or an error that the “website installed unsuccessfully” (huh?).

I decided to just close the utility and dig through the eScrum_readme.rtf file to see if I could figure out what was up. This file is your best friend while you’re fumbling though the eScrum configuration.

Not seeing anything in particular about none of the configuration utility tools working, I relaunched the configuration utility as Administrator and this time succeeded in install the website, but not the SharePoint template.

Getting the eScrum Website working

I then referred back to the read-me document and followed the post-installation steps to configure the app-pool. The only confusing item there is that the example script command they show actually had the website ID in the sample, instead of “<website>” as the next step hints at how to locate, but no biggie, it was pretty clear what they meant. The shortcut for locating this on a Vista/Windows 2008 box is at the very bottom of the read-me.

When I then tried to browse the local site, I kept getting errors about the Session member in the httpModules section of the web.config being a duplicate, so I removed that entry and then received a new error (I forgot to write down the exact error unfortunately). However, this time, the webpage had a command that it indicated I should run from a command-window, and this command cleared up my issue and I had the website running.

Getting the SharePoint Template Uploaded

Our environment had an existing MOSS Farm that we wanted to utilize, so I ran the STSADM utility from the SharePoint box and added the eScrum_tfs2008.stp template. Quick and easy.

Uploading the eScrum Project Template for TFS

At this point, the last thing I had to do was upload the eScrum template to the TFS machine. I couldn’t get the Configuration Tool to upload this for me, so I had to do things manually. I ended up expanding the contents of eScrumProcessTemplate.zip into a folder and pointing to that in order to get the project template uploaded to my TFS server. The read-me indicated that I should have been able to do the upload from the zip file, but the upload manager wouldn’t enable the Upload button so I used the unzip then upload method.

Adding your project to the eScrum website project list

The last thing you’ll need to do in order to use the eScrum website with your project(s) is edit the eScrum UI’s web.config as outlined in the read-me. After that, you’re off and running.