SharePoint gradual migration “gotcha” to be aware of…

Written by Cornelius J. van Dyk on . Posted in Blog

When installing MOSS 2007 into an existing SPS 2003 environment, you undoubtedly have already decided on a migration strategy i.e. In Place, Database or Gradual. One of the little gotchas to be aware of if you decided to choose the Gradual migration strategy affects pre-existing web applications. If you look at this screen shot:

You will notice the default state of our web server BEFORE in installation and configuration of the Gradual migration. In our case, we have a web application installed on the web server that is leveraged by the portal. As expected, the web application is installed in a virtual directory under the Default Web Site, in this case called SPSWebApp. Furthermore, it shares the web traffic port i.e. port 80, with the Default Web Site, as it should in order for the WEB application to work properly.

After installing MOSS, successfully running through the Config Wizard and commencing a gradual migration, we see the following in the IIS Manager:

As you know, SharePoint will create a web site called “Default Web Site_Pair” for the new MOSS portal. That web site will be assigned port 80. The old “Default Web Site” web site will have a new TCP port assigned to it, the port you specified in the Gradual Upgrade configuration steps. In our case we used port 8000 and as you can see above, port 8000 is where it now sits.

The problem with this is that any and all web applications such as our SPSWebApp that are installed into virtual directories under the Default Web Site also now have a new port under which they run. Since most web application references and code simply reference the URL without any port specification, IIS would default to port 80 on said web application requests. Given that the web application does not exist on port 80 anymore, such requests would fail with 404 errors.

So, be aware of this little gotcha. The way to work through this is to uninstall your web applications before you commence the gradual upgrade, but after the Config Wizard was done. Then once the new port 80 web site was created, reinstall your web applications to the Default Web Site_Pair web site on port 80. That should about do it. 



Tags: ,

Trackback from your site.

Cornelius J. van Dyk

Born and raised in South Africa during the 70's I got my start in computers when a game on my Sinclair ZX Spectrum crashed, revealing it's BASIC source code. The ZX had a whopping 48K of memory which was considered to be a lot in the Commodore Vic20 era, but more importantly, it had BASIC built into the soft touch keyboard. Teaching myself to program, I coded my first commercial program at age 15.

After graduating high school at 17, I joined the South African Air Force, graduating the Academy and becoming a Pilot with the rank of First Lieutenant by age 20. After serving my country for six years, I made my way back into computer software.

Continuing my education, I graduated Suma Cum Laude from the Computer Training Institute before joining First National Bank where my work won the Smithsonian Award for Technological Innovation in the field of Banking and Insurance. Soon I met Will Coleman from Amdahl SA, who introduced me to a little known programming language named Huron/ObjectStar. As fate would have it, this unknown language and Y2K brought me to the USA in 1998.

I got involved with SharePoint after playing around with the Beta for SharePoint Portal Server 2003. Leaving my career at Rexnord to become a consultant in 2004, I was first awarded the Microsoft Most Valuable Professional Award for SharePoint in 2005, becoming only the 9th MVP for WSS at the time. I fulfilled a life long dream by pledging allegiance to the Flag as a US citizen in 2006. I met the love of my life and became a private consultant in 2008. I was honored to receive my ninth MVP award for SharePoint Server in 2013.

Leave a comment

You must be logged in to post a comment.