Home > administration and configuartion, SharePoint Server 2010 > SharePoint Server 2010 Cannot Load Homepage After upgradeing from MOSS 2007

SharePoint Server 2010 Cannot Load Homepage After upgradeing from MOSS 2007

We have faced an issue while upgrading SharePoint Portal 2003 to SharePoint Server 2010 .

In this case  we have 2 pahse of upgrade , 1st  phase is upgrading from SharePoint Portal 2003 to Microsoft Office SharePoint Server 2007, then 2nd phase in upgrading from Microsoft Office SharePoint Server 2007 to SharePoint Server 2010 .

As we know, there were a huge  differences between Microsoft Office SharePoint Server 2007  version and SharePoint Portal 2003 version in Architecture Information level such as master pages , page layouts , Shared Service Provider ,..  plus there many features added to MOSS 2007 Version such as InfoPath Forms, BCD,..

So when we upgrade from SharePoint Portal 2003 to MOSS 2007 , many  classes and web parts were replaced with a new classes in MOSS 2007 such  as HomePage this class was used in SharePoint Portal 2003 and it’s deprecated in MOSS 2007 ( a reference to this  class in home page  was the reason  in Loading Home Page Exception after upgrading to SharePoint Server 2010)

In our case , we upgrade 1st Phase successfully without any issue except some adjustment in home page UI , the portal after is working fine and all sites and inner page  also.

Moving to SharePoint Server 2010 was a problem , because as I mentioned above many classes come from SharePoint Portal 2003  is deprecated in Moss 2007 and  there are no references to them in SharePoint 2010 Dlls. As we doing an upgrade , the references to these classes are still exist in content DB, so an exception has occurred in loading home Page and inner pages.

So , in 2nd phase of Upgrade ( Upgrade Moss 2007 to SP 2010 ) , below Exception appear in loading Portal home Page

Could not load type ‘Microsoft.SharePoint.Portal.WebControls.HomePage’ from assembly ‘Microsoft.SharePoint.Portal, Version=, Culture=neutral, PublicKeyToken=71e9bce111e9429c’ “

This issue was ‘Microsoft.SharePoint.Portal.WebControls.HomePage’ is obsolete, and it is no longer existing in the ‘Microsoft.SharePoint.Portal, Version=, Culture=neutral, PublicKeyToken=71e9bce111e9429c’, however, it is existing in ‘Microsoft.SharePoint.Portal, Version=, Culture=neutral, PublicKeyToken=71e9bce111e9429c’.
In this case, it seems you are using the ‘Microsoft.SharePoint.Portal.WebControls.HomePage’ control in the SharePoint 2007(I mean Microsoft Office SharePoint Server(MOSS) 2007). After upgrading, the SharePoint 2010 tries to load the ‘Microsoft.SharePoint.Portal.WebControls.HomePage’ from the assembly with version However, it is not existing. That is what the error means.

So to fix the issue, you need to remove the ‘Microsoft.SharePoint.Portal.WebControls.HomePage’ from SharePoint 2007, and then upgrade the site again.

  1. zee
    April 6, 2012 at 7:03 pm

    Thank you! This is really nice info!

  2. April 17, 2012 at 5:23 pm

    Very interesting information!Perfect just what I was searching for!

  3. April 17, 2012 at 5:32 pm

    Very interesting info!Perfect just what I was searching for!

  4. Kamin
    October 16, 2013 at 7:15 am

    How to remove ‘Microsoft.SharePoint.Portal.WebControls.HomePage’ from SharePoint 2007 ?

  5. October 16, 2013 at 9:38 am

    Kamin open your default.aspx page in sharepoint designer 20007, you will find a reference to “Microsoft.SharePoint.Portal.WebControls.HomePage” , just remove it and save what you did then upgrade this ContentDB to sp 2010, it isn’t a problem if MOSS 2007 default page not working in this time, just you want contentDB without reference to “Microsoft.SharePoint.Portal.WebControls.HomePage”

  6. Kamin
    October 25, 2013 at 9:12 am

    Hi Ahmed,
    Thank you for the info, but I am not sure where to find reference “Microsoft.SharePoint.Portal.WebControls.HomePage” in MOSS2007 ?
    Is it a site template, webpart, or feature ? Can explain more specific ?
    Can I remove it from Sharepoint 2010 instead ?

    • October 25, 2013 at 11:15 am

      Hi Kamin,

      “Microsoft.SharePoint.Portal.WebControls.HomePage” this is reference is exist in MOSS 2007 and it is obsolete in SharePoint 2010 so you got this error while upgrading, so before upgrading from MOSS 2007 to SharePoint 2010, you should remove this refernce from your default page. aspx or defualt master page, you need to open your home page in SharePoint Designer 2007, you will find a reference to “Microsoft.SharePoint.Portal.WebControls.HomePage” , just remove it , save, and publish. don’t care if something happened to homepage in MOSS2007 after you removed the reference, take this ContentDB of MOSS2007 and upgrade it.

      hope this help you, plz don’t hesitate to ask me if you have any questions.

  7. Kamin
    October 28, 2013 at 10:36 am

    Hi Ahmed, thank you for your reply.
    I have installed sharepoint designer 2007 and deleted below reference in default page:

    But it has the same error message after upgrade the content db to Sharepoint 2010.
    How the default aspx file is related with contentdb ?
    Changing the default aspx file does not update the contentdb, correct ?
    FYI, after I removed above reference from default aspx file and saved (check-in), the ContentDB “Modified date” is still the same.

    Btw, can I use sharepoint designer 2010 to remove the reference after upgrade the contentdb to Sharepoint 2010 ?
    If I make changes in sharepoint designer 2007, I have to upgrade again to 2010 and it takes a lot of time.

  8. Kamin
    November 1, 2013 at 7:28 am

    Hi Ahmed,
    I have no issue with the HomePage anymore, but we encountered different error in some pages. It shows : Unknown server tag for ‘SPSWC:CategoryNavigationWebPart’ and ‘SPSWC:BreadCrumbTrail’.
    Do you familiar with this error ?

  1. No trackbacks yet.

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s

%d bloggers like this: