Documentation is on the project's site:
For detailed instructions please visit our Dev4Side's Project page:
If you prefer italian instructions, you can read this blog post:
One of the most popular ways to migrate SharePoint from 2007 to 2010 is probably using the Database Attach method.
If you have ever tried this kind of approach you will notice that there is a lack of informations in what customizations have been made in the old SharePoint 2007 farm that needs to be migrated.
Using SharePoint's Windows PowerShell cmdlet is possible to test a database attach before performing the attach:
Test-SPContentDatabase –Name <database name> -WebApplication <URL>
This tool display on your screen a report that shows basic informations about all issues that this approach will have. Until you don't solve all the Issues, you should not proceed with the database attach.
Unfortunately you won't obtain informations on where certain issues are located:
- Missing features will be displayed just as a GUID
- Missing webparts will be displayed just as GUID
This means that you won't be able to located them so easly and port them on SharePoint 2010...
Until now!
SharePoint 2010 extended migration db attach report is able to parse this report and generate and extended version for each issue!
A MissingFeature Issue will become from
Category : MissingFeature
Error : True
UpgradeBlocking : False
Message : Database [xxxx] has reference(s) to a missing feature: Id = [xxxxxx].
Remedy : The feature with Idxxxxxx is referenced in the database [xxxx], but ...
Will be transformed in
Feature definition:
<Feature xmlns="http://schemas.microsoft.com/sharepoint/" Id="F5DF760A-EAA5-428b-912D-0BC0D361F771"
Title="Feature Title" Description="Feature Desc" Version="1.0.0.0" Scope="Site" Hidden="false" ImageUrl="Folder\icon.png">
<ElementManifests>
<ElementManifest Location="Location.xml" />
</ElementManifests>
</Feature>
Feature scope: Site
Installed Url: http://YourOldSharepoint2007Url
Feature Id: xxxxxx
And a MissingWebPart issue like
Category : MissingWebPart
Error : True
UpgradeBlocking : False
Message : WebPart class [xxx] is referenced [3] times in the database xxxx], but is not installed on the current farm...
Will be transfomed in:
WebPart Details: CustomWebPart
WebPart name: CustomWebPart
WebPart Type name: CustomWebPart.namespace
Assembly Name: CustomWebPartAssembly, Version=1.1.0.0, Culture=neutral, PublicKeyToken=7668678dcd8080b491
WebPart Id:: xxx
This wep part can be located in the following pages:
SubSite/default.aspx
SubSite1/subsite/page.aspx
Here is how the generated report looks like:
===============================================
Report started at 28/09/2010 9:23:56 PM
===============================================
###############################
### Feature Report ###
###############################
[Informations]
-> 3 Feature issues have been parsed from imput file.
-> 85 Feature have been found into your content db
-> 3 Features have been analized
Feature definition: <Feature xmlns="http://schemas.microsoft.com/sharepoint/"
Id="367B94A9-4A15-42BA-B4A2-32420363E018" Title="Report Server Integration Feature"
Description="Enables rich reporting using Microsoft SQL Server Reporting Services."
Version="12.0.0.0" Scope="Site"
ReceiverAssembly="Microsoft.ReportingServices.SharePoint.UI.ServerPages,Version=9.0.242.0,
Culture=neutral,PublicKeyToken=89845dcd8080cc91"
ReceiverClass="Microsoft.ReportingServices.SharePoint.UI.ReportServerFeature">
<ElementManifests>
<ElementManifest Location="ItemCustomActions\ecbExtension.xml" />
<ElementManifest Location="AdminUI\AdminUIEntryPoints.xml" />
<ElementManifest Location="WebPartsElements.xml" />
<ElementManifest Location="ReportServerContentTypes.xml" />
</ElementManifests>
</Feature>
Feature scope: Site
Installed Url: http://YourOldSharePoint2007.com
Feature Id: 367b94a9-4a15-42ba-b4a2-32420363e018
Feature definition: <Feature Id="bcb59ac1-e1b6-49d0-a91b-9dc99b837c23"
Title="My Custom Feature" Description="My Custom Dec!" Version="12.0.0.0"
Hidden="FALSE" Scope="Site" DefaultResourceFile="core"
xmlns="http://schemas.microsoft.com/sharepoint/">
<ElementManifests>
<ElementManifest Location="elements.xml" />
<ElementFile Location="CustomWebPart.webpart" />
</ElementManifests>
</Feature>
Feature scope: Site
Installed Url: http://YourOldSharePoint2007.com
Feature Id: bcb59ac1-e1b6-49d0-a91b-9dc99b837c23
Feature definition: <Feature Id="9b5429f0-b21e-4590-b44d-a1122646722a" Title="Super Custom Feature"
Description="This is a super Feature" Version="12.0.0.0" Hidden="FALSE" Scope="Site"
DefaultResourceFile="core" xmlns="http://schemas.microsoft.com/sharepoint/">
<ElementManifests>
<ElementManifest Location="elements.xml" />
<ElementFile Location="SuperWebPart.webpart" />
</ElementManifests>
</Feature>
Feature scope: Site
Installed Url: http://YourOldSharePoint2007.com
Feature Id: 9b5429f0-b21e-4590-b44d-a1122646722a
###############################
### WebParts Report ###
###############################
[Informations]
-> 5 WebParts issues have been parsed from imput file.
-> 68 WebParts have been found into your content db
-> 3 WebParts have been analized
==============================================================
[WebPart : CustomWebPart]
==============================================================
WebPart Details: MasterDetailWebPartProps
WebPart name: CustomWebPart.webpart
WebPart Type name: Dev4Side.Sample.CustomWebPart
Assembly Name: Dev4Side.Sample, Version=1.0.0.0, Culture=neutral,
PublicKeyToken=0000000000000000
WebPart Id:: 6b78009e-a658-61f4-9c66-b04fdde52e77
This wep part can be located in the following pages:
Site1/SubSite2/deafault.aspx
Site2/SubSite2/Hello.aspx
Site2/SubSite2/Help.aspx
______________________________________________________________
==============================================================
[WebPart : ReportViewer]
==============================================================
WebPart Details: ReportViewer
WebPart name: ReportViewer
WebPart Type name: Microsoft.ReportingServices.SharePoint.UI.WebParts.ReportViewerWebPart
Assembly Name: Microsoft.ReportingServices.SharePoint.UI.WebParts,
Version=9.0.242.0, Culture=neutral, PublicKeyToken=0000000000000000
WebPart Id:: 7e287d59-ae87-2432-e52a-6420e81ddc91
This wep part can be located in the following pages:
Site3/SubSite5/Pages/Budget.aspx
Site2/Pages/Reports.aspx
Site2/Stats/default.aspx
______________________________________________________________
==============================================================
[WebPart : SuperWebPart]
==============================================================
WebPart Details: SuperWebPart
WebPart name: SuperWebPart
WebPart Type name: Dev4Side.Sample.SuperWebPart
Assembly Name: Dev4Side.Sample, Version=1.0.0.0, Culture=neutral, PublicKeyToken=eaf58ff25bb059f9
WebPart Id:: 2c7df9ff-d5ea-f4e5-d3b4-be74bfc883b4
This wep part can be located in the following pages:
Pages/super.aspx
______________________________________________________________
############################################################################
############### the following web parts could not be analized ##############
############################################################################
==============================================================
[WebPart : a20f6f5f-8aa1-7744-150d-05616d2e2777]
==============================================================
This web part can be located in the follwoing urls:
Site/somewhere/default.aspx
Site/somewhereElse/default.aspx
Site3/somewhere/default.aspx
==============================================================
[WebPart : aa554295-bab4-74a6-5ef6-10cc54c1dcb2]
==============================================================
This web part can be located in the follwoing urls:
Site5/somewhere/default.aspx
Site2/SubSite2/somewhere/default.aspx
===============================================
Report ended at 28/09/2010 9:24:02 PM
===============================================
For detailed instructions please visit our Dev4Side's Project page:
If you prefer italian instructions, you can read this blog post: