SharePoint 2007 : Migration et Prescan

L'un sans l'autre, ce serait comme Minus sans Cortex (pour les plus jeunes) ou Laurel sans Hardi.

Plus sérieusement, les posts conjugés de Renaud et Erol m'ont donné l'idée de parler un peu plus de cet outil indispensable qu'est Prescan.

Cet outil de pré-upgrade scanne vos sites et signale les problèmes comme des bases de données orphelines (Database Orphans) ou des définitions de sites manquantes, vous permettant de les réparer avant d'effectuer une migration.

Histoire d'être encore plus précis, voilà ce que dit Technet à son sujet (traduction maison, merci de votre compréhension):

Vous devez utiliser l'outil de préupgrade pour scanner vos sites et ainsi réparer les erreurs avant de lancer une mise à jour. Si vous n'avez pas lancer prescan et que vous tentez de mettre à jour votre environnement, quand vous lancerez l'assistant de configuration de SharePoint, il quittera et vous signalera que vous devez lancer prescan avant. Il est hautement recommandé que l'administrateur du serveur lance l'outil de scan avant l'upgrade et resolve tout les problèmes avant la mise à jour.

Vous aurez peut être besoin de lancer prescan plus d'une fois. En effet, vous devez relancer l'outil après avoir corrigé une erreur signalé dans un précédent scan sinon vous aurez une erreur comme quoi l'outil n'a pas été lancé.

Un lancement de Prescan génère ce type d'informations (en fin de fichier de log, bien sur, le fichier en lui même est bien plus complet) :

06/04/2007 16:08:37 Scan finished without failure.
06/04/2007 16:08:37 Number of sites skipped (already scanned): 0
06/04/2007 16:08:37 Number of sites scanned: 76
06/04/2007 16:08:37 Number of broken sites: 0
06/04/2007 16:08:37 Number of webs scanned: 98
06/04/2007 16:08:37 Number of broken webs: 0
06/04/2007 16:08:37 Number of webs using custom template: 0
06/04/2007 16:08:37 Number of pages scanned: 0
06/04/2007 16:08:37 Number of unghosted pages: 14

Comme vous pouvez le déduire, c'est ce genre de rapport que vous espérez après un scan : Pas de "broken sites", "broken webs", "custom template" et très peu de pages unghosted (au passage, la nouvelle mouture des termes ghosted/unghosted pour la version 2007 est uncustomized/customized).

Petite digression concernant ces pages :

Le fait d'avoir des pages unghosted ou customized n'est pas forcément une mauvaise chose mais si vous le souhaitez, vous pouvez lancer cette commande après le prescan qui vous permettra de lancer une migration gradual ou sidebyside tout en replaçant les sites à leur définition de départ : psconfig.exe -cmd upgrade -sidebyside -reghostonupgrade (ici c'est le paramètre reghostonupgrade qui nous intéresse)

Mais reprenons plutot sur la génération d'erreur du prescan.

D'un autre coté, vous pourriez avoir moins de chance comme moi lors de ma précédente migration et avoir ce genre d'erreurs :

  • Cannot locate list definition required for upgrade. Check to ensure you have all templates and language packs installed.
    Error: Exception scanning web: http://<server>/<path>/<site>
    System.IO.FileNotFoundException: The system cannot find the file specified.
  • [UpgradeDiscussionLists] [3.0.87.0] [ERROR] [12/11/2006 5:06:15 PM]: Data is Null. This method or property cannot be called on Null values.[UpgradeDiscussionLists] [3.0.87.0] [ERROR] [12/11/2006 5:06:15 PM]: Item update failed for list 3cc63b2b-8a42-4ef3-bfa4-6e40f4827ec6, thread 20051208-1643-2400-a3fe-67a3e9495a11, ordering 20051208164324
  • "PRESCAN failed for site /<prefix>/<site>.  The site could not be access through the SharePoint Object Model."

Autant certains messages sont tout à fait compréhensibles et permettent de cibler la cause de l'erreur, autant ce n'est pas toujours le cas et il va falloir mettre les mains dans le cambouis... Ou pas.

En effet grâce à William Baer qui a posté sur son blog un article (mis à jour récemment) très instructif sur les erreurs les plus communément générés par Prescan, c'est désormais bien plus simple de préparer une migration et éviter de perdre trop de temps sur cette étape.

Maintenant que je vous ai présenté rapidement l'outil en question, et ce qu'il est capable de faire, il faut savoir où le trouver sur votre installation SharePoint, voire où le télécharger :

  • Si vous avez une installation "classique", vous le trouverez dans "c:\program files\common files\Microsoft shared\web server extensions\12\bin\" (Install US) ou "c:\Program Files\Fichiers communs\Microsoft Shared\web server extensions\12\BIN (Install FR).
  • Sinon vous pourrez le télécharger ici avec tous les fichiers dont vous aurez besoin (dont le fichier PREUPGRADESCANCONFIG.XML).

Il ne vous reste plus qu'à l'exécuter avec les différents paramètres possibles (/all, /c, /v <webapp>).

la commande de base étant : prescan.exe /c preupgradescanconfig.xml /all

Cette commande génèrera deux fichiers logs (un txt et un xml, même contenu) qui se trouveront sur ce dossier "%SYSTEMDRIVE%:\Documents and Settings\User1\Local Settings\Temp" avec des noms à rallonges comme "PreupgradeReport_633107000703130020_Log.txt". Vous y trouverez aussi un fichier prescan.log qui note les fois où l'outil de migration est lancé.

Une fois toutes ces étapes passées, vous pourrez continuer votre migration "tranquillement".

Pour finir, vous trouverez des compléments d'informations sur ces différents sites/blogs :

<Philippe/>

Publié mercredi 23 mai 2007 12:15 par phil
Classé sous , ,
Ce post vous a plu ? Ajoutez le dans vos favoris pour ne pas perdre de temps à le retrouver le jour où vous en aurez besoin :

Commentaires

About phil

Philippe Sentenac est Consultant SharePoint à Wygwam en région Parisienne. Il intervient essentiellement sur des missions liées à SharePoint (2007 et 2010 ) mais aussi autour du Web 2.0. Plus généralement, il s'intéresse à l'ASP.Net (MVC) , à Silverlight, et à tout ce qui est orienté Web en rapport avec les nouvelles technologies, qu'il pratique depuis 2006. Féru de développement, il est passionné par les problématiques de méthodologies et d'industrialisation du développement.

Les 10 derniers blogs postés

- Merci par Blog de Jérémy Jeanson le 10-01-2019, 20:47

- Office 365: Script PowerShell pour auditer l’usage des Office Groups de votre tenant par Blog Technique de Romelard Fabrice le 04-26-2019, 11:02

- Office 365: Script PowerShell pour auditer l’usage de Microsoft Teams de votre tenant par Blog Technique de Romelard Fabrice le 04-26-2019, 10:39

- Office 365: Script PowerShell pour auditer l’usage de OneDrive for Business de votre tenant par Blog Technique de Romelard Fabrice le 04-25-2019, 15:13

- Office 365: Script PowerShell pour auditer l’usage de SharePoint Online de votre tenant par Blog Technique de Romelard Fabrice le 02-27-2019, 13:39

- Office 365: Script PowerShell pour auditer l’usage d’Exchange Online de votre tenant par Blog Technique de Romelard Fabrice le 02-25-2019, 15:07

- Office 365: Script PowerShell pour auditer le contenu de son Office 365 Stream Portal par Blog Technique de Romelard Fabrice le 02-21-2019, 17:56

- Office 365: Script PowerShell pour auditer le contenu de son Office 365 Video Portal par Blog Technique de Romelard Fabrice le 02-18-2019, 18:56

- Office 365: Script PowerShell pour extraire les Audit Log basés sur des filtres fournis par Blog Technique de Romelard Fabrice le 01-28-2019, 16:13

- SharePoint Online: Script PowerShell pour désactiver l’Option IRM des sites SPO non autorisés par Blog Technique de Romelard Fabrice le 12-14-2018, 13:01