Exécuter l’outil d’analyse préalable à la mise à niveau (Office SharePoint Server)

Mise à jour : 2009-03-05

Dans cet article :

• Problèmes signalés par l’outil d’analyse préalable à la mise à niveau

• Installer et exécuter l’outil d’analyse préalable à la mise à niveau

Vous devez utiliser l’outil d’analyse préalable à la mise à niveau pour analyser vos sites, puis résoudre les éventuelles erreurs avant d’effectuer une mise à niveau. Si vous n’avez pas correctement exécuté cet outil et que vous tentez de mettre à niveau votre environnement, lorsque vous essayez d’exécuter l’Assistant Configuration des produits et technologies SharePoint, l’Assistant se ferme et vous invite à exécuter l’outil. Il est vivement recommandé que l’administrateur du serveur exécute l’outil d’analyse préalable à la mise à niveau avant d’effectuer la mise à niveau et qu’il résolve tous les problèmes possibles avant de planifier la mise à niveau.

Remarque :

Vous devrez peut-être exécuter l’outil d’analyse préalable à la mise à niveau plusieurs fois. Par exemple, si vous exécutez l’outil pour évaluer votre batterie de serveurs, mais que vous n’allez pas effectuer la mise à niveau pendant quelques semaines, vous devrez réexécuter l’outil juste avant d’effectuer la mise à niveau pour analyser tous les nouveaux sites et pour vous assurer qu’aucun problème supplémentaire n’est apparu entre-temps. En outre, après avoir résolu tous les problèmes révélés par votre première analyse, vous devrez réexécuter l’outil ; sinon, lorsque vous essayez d’exécuter l’Assistant Configuration des produits et technologies SharePoint, vous pouvez obtenir un message d’erreur indiquant que l’analyse préalable n’a pas été exécutée.

Pour plus d’informations sur les problèmes ou erreurs signalés par l’outil d’analyse préalable à la mise à niveau, consultez les entrées de blogs suivantes sur le site Web de Microsoft : https://go.microsoft.com/fwlink/?linkid=106424&clcid=0x40C (en anglais)

Problèmes signalés par l’outil d’analyse préalable à la mise à niveau

Pour chaque site SharePoint, les problèmes signalés par cet outil comprennent l’existence des objets suivants :

• Modèles de sites personnalisés    Vous devez savoir quels sont les modèles de sites qui ont été personnalisés pour un site particulier afin de pouvoir vérifier les personnalisations de nouveau après la mise à niveau.

• Objets orphelins   Les objets tels que les éléments de liste, les listes, les documents, les sites Web et les collections de sites peuvent être orphelins ; en d’autres termes, les objets existent, mais ne sont pas associés à un site particulier. Étant donné que les objets orphelins ne fonctionnent pas dans la version précédente, ils ne fonctionneront pas après la mise à niveau. Si vous effectuez une mise à niveau sur place, les éléments orphelins existeront toujours, mais ne fonctionneront pas. Si vous effectuez une mise à niveau progressive, les éléments orphelins ne seront pas copiés vers le nouveau site. Il est recommandé de nettoyer les objets orphelins avant la mise à niveau.

  Conseil :

  Les membres du groupe Administrateurs sur les serveurs Web frontaux peuvent récupérer les éléments orphelins avant la mise à niveau en suivant les étapes décrites dans l’article 918744 de la Base de connaissances, Description d’une nouvelle opération de ligne de commande que vous pouvez utiliser pour réparer des bases de données de contenu dans Windows SharePoint Services 2.0 et SharePoint Portal Server 2003 (https://support.microsoft.com/kb/918744?amp;clcid=0x40C) .

• Composants WebPart personnalisés   Signalez l’existence des composants WebPart personnalisés à l’administrateur ou au développeur de site approprié avant la mise à niveau, afin qu’il ait le temps d’étudier la question.

  Remarque :
  Les composants WebPart personnalisés excessivement obscurcis devront éventuellement être régénérés et redéployés après la mise à niveau.

• Sites basés sur des langues ou utilisant des contrôles qui ne sont pas installés   Si la base de données contient un site Web basé sur un pack de modèles linguistiques qui n’est pas actuellement installé sur les serveurs Web frontaux ou un site Web utilisant des contrôles (tels que Microsoft Office Web Components) qui ne sont pas actuellement installés sur les serveurs Web frontaux, installez les modules linguistiques ou les contrôles manquants avant d’effectuer la mise à niveau.

Utilisez les informations collectées à partir de l’outil d’analyse préalable à la mise à niveau afin de déterminer :

• s’il convient d’effectuer une mise à niveau sur place ou progressive ;

  L’article Déterminer l’approche de mise à niveau (Office SharePoint Server) fournit des informations qui vous aident à déterminer le type de mise à niveau à effectuer. Il est important de prendre en compte le rapport généré par l’outil d’analyse préalable à la mise à niveau lorsque vous prenez cette décision. En général, si vous rencontrez des problèmes significatifs, utilisez une mise à niveau progressive plutôt qu’une mise à niveau sur place pour pouvoir résoudre les problèmes.

• s’il convient de mettre à niveau une partie ou la totalité des collections de sites qui contiennent des sites personnalisés ;

• les sites dont la personnalisation doit être réappliquée ou renouvelée après la mise à niveau et qui, par conséquent, peuvent prendre plus de temps que d’autres au cours de l’étape de révision.

  Important :

  Lorsque vous exécutez l’outil d’analyse préalable à la mise à niveau, les métadonnées de toutes les listes et bibliothèques de vos sites sont mises à jour. Cela signifie que les listes et les bibliothèques de l’environnement indiqueront qu’elles ont été mises à jour après que l’outil d’analyse préalable à la mise à niveau aura été exécuté. Les dates associées aux différents éléments de liste et documents ne sont pas modifiées par ce processus.

Installer et exécuter l’outil d’analyse préalable à la mise à niveau

1. Téléchargez et installez l’outil d’analyse préalable à la mise à niveau à partir du Centre de téléchargement Microsoft (en anglais) (https://go.microsoft.com/fwlink/?linkid=92383&clcid=0x40C) (en anglais) .

   Remarque :
   Vous devez être membre du groupe Administrateurs sur l’ordinateur local pour exécuter cet outil.

2. Dans la ligne de commande, accédez au dossier qui contient les deux fichiers, puis exécutez la commande suivante pour analyser tous les serveurs de votre batterie de serveurs :

   prescan.exe /c preupgradescanconfig.xml /all
   

   Vous pouvez utiliser l’outil d’analyse préalable à la mise à niveau pour analyser tous les sites Web de votre environnement (en utilisant le paramètre /all) ou pour analyser une URL spécifique (à l’aide du paramètre /vURL). Si vous ne fournissez pas un paramètre d’étendue, tous les sites Web seront analysés.

   Remarque :

   Au cours de l’analyse préalable à la mise à niveau, les modèles utilisés par SharePoint Portal Server 2003 peuvent être à tort identifiés en tant que modèles personnalisés, sauf si vous utilisez le fichier preupgradescanconfig.xml lors de l’analyse. Ce fichier contient une logique supplémentaire qui permet d’identifier les modèles du site portail en tant que modèles standard utilisés par SharePoint Portal Server 2003 plutôt qu’en tant que modèles personnalisés basés sur Windows SharePoint Services 2.0.

   Si vous avez déjà installé la nouvelle version, mais n’avez pas encore exécuté l’Assistant Configuration des produits et technologies SharePoint, vous pouvez exécuter l’outil d’analyse préalable à la mise à niveau à partir du dossier suivant : %PROGRAMFILES% \Common Files\Microsoft Shared\web server extensions\12\BIN.

   L’exécution de l’analyse peut prendre de quelques minutes à quelques heures, selon le volume du contenu de votre environnement.

3. Au terme de l’analyse, un rapport de synthèse est affiché dans la fenêtre de ligne de commande.

Si des erreurs se sont produites ou des problèmes de mise à niveau ont été détectés pour vos sites, vous pouvez examiner le rapport complet pour obtenir les informations détaillées. Le rapport est nommé PreupgradeReport_ID_u nique_Log.txt (où ID_unique est une chaîne numérique) et il se trouve dans le répertoire temporaire sur l’ordinateur de l’utilisateur qui a exécuté l’outil (par exemple, %LECTEURSYSTÈME%:\Documents and Settings\Utilisateur1\Local Settings\Temp). Il existe également un fichier prescan.log dans le même répertoire ; ce fichier prescan.log enregistre l’heure ou les heures auxquelles l’outil d’analyse préalable à la mise à niveau a été exécuté.

Après avoir exécuté l’outil d’analyse préalable à la mise à niveau, vous pouvez consulter les rapports pour rechercher et résoudre les problèmes (recherchez « error » dans le rapport pour rechercher les problèmes). Vous pouvez également partager les résultats de test appropriés de l’analyse préalable à la mise à niveau avec d’autres membres de l’équipe de mise à niveau. Par exemple, vous pouvez signaler les problèmes tels que des modèles de sites personnalisés ou des composants WebPart personnalisés au propriétaire de site, concepteur ou développeur de site Web approprié avant la planification de la mise à niveau afin qu’ils aient le temps de rechercher les problèmes et de prendre des mesures préliminaires. Par exemple, un concepteur ou un développeur peut décider qu’il peut être prudent de régénérer un composant WebPart excessivement obscurci avant que la mise à niveau ne se produise. Les propriétaires de sites peuvent ensuite vérifier toutes les personnalisations qui ont été réalisées pour leurs sites, y compris les modèles de sites et les modifications apportées aux fichiers ASPX (Active Server Page Extension) principaux, et peuvent noter les problèmes potentiels.

Télécharger ce livre

Cette rubrique est incluse dans le livre téléchargeable suivant pour une lecture et une impression plus faciles :

• Mise à niveau vers Office SharePoint Server 2007 (en anglais)

Vous trouverez la liste complète des livres disponibles sur Livres à télécharger pour Office SharePoint Server 2007.