Résoudre les problèmes de mise à niveau des bases de données dans SharePoint 2013

S’APPLIQUE À :2013 2016 2019 Édition d’abonnement SharePoint dans Microsoft 365

Même après avoir testé le processus de mise à niveau pour identifier les problèmes potentiels, vous risquez de rencontrer des problèmes inattendus pendant une mise à niveau depuis Produits SharePoint 2010 vers SharePoint 2013. Si vous rencontrez des problèmes après la mise à niveau, plus vite vous les détecterez et les résoudrez, meilleure sera l'expérience de l'utilisateur final.

Cet article comprend une liste des problèmes courants et décrit les principes généraux à suivre pour mieux identifier et traiter les problèmes de mise à niveau. Vous pouvez reprendre la mise à niveau une fois ces problèmes identifiés et traité. Pour plus d'informations sur le moyen de reprendre la mise à niveau, voir Redémarrer une mise à niveau avec liaison des bases de données ou une mise à niveau de collection de sites vers SharePoint 2013.

Principes généraux à suivre pour identifier les problèmes

Vérifiez l’état de la mise à niveau pour déterminer à quel stade celle-ci s’est éventuellement arrêtée et consultez les fichiers journaux pour déterminer s’ils comportent des erreurs ou des avertissements. Ensuite, avant de reprendre la mise à niveau, résolvez les problèmes détectés.

Première phase : vérifier l’état de la mise à niveau et les fichiers journaux

Les indicateurs d’état de mise à niveau et les fichiers journaux précisent ce qui n’a pas fonctionné au cours du processus de mise à niveau. Il est recommandé de passer attentivement en revue toutes les erreurs consignées dans les fichiers journaux de mise à niveau. Les avertissements ne sont pas nécessairement révélateurs d'un problème, mais vous devez tous les passer en revue pour déterminer si ce que signale l'un d'eux est susceptible d'engendrer des problèmes supplémentaires.

1. Passez en revue la page État de la mise à niveau sur le le site Web Administration centrale de SharePoint.

   Pour plus d'informations sur la vérification de l'état de la mise à niveau, voir Vérifier les mises à niveau de base de données dans SharePoint 2013.

2. Passez en revue les fichiers journaux suivants :

• Le fichier journal des erreurs de mise à niveau et le fichier journal de mise à niveau (dont le contenu est plus détaillé que le fichier journal des erreurs de mise à niveau).

• Les fichiers journaux du service ULS ou de suivi.

  Ces fichiers sont stockés dans le dossier %COMMONPROGRAMFILES%\Microsoft Shared\Web Server Extensions\15\LOGS et sont nommés Nom_serveur_ AAAAMMJJ- MMSS.log.

• Le fichier journal des événements de l'application.

  Ce fichier peut être visualisé à l'aide de l'Observateur d'événements.

  Pour plus d'informations sur les fichiers journaux de mise à niveau, voir Vérifier les mises à niveau de base de données dans SharePoint 2013. Pour plus d'informations sur le fichier journal de suivi, consultez la rubrique relative aux journaux de suivi sur MSDN.

Deuxième phase : résoudre les problèmes dans l’ordre

Certains problèmes ont plus d’incidence que d’autres. Par exemple, l'absence d'un fichier côté serveur peut entraîner de nombreuses erreurs apparemment disparates au niveau du site.

Résolvez les problèmes dans l'ordre suivant :

1. Personnalisations ou fichiers côté serveur manquants, tels que des fonctionnalités ou des composants WebPart.

   Veillez surtout à installer l'ensemble des personnalisations côté serveur, notamment les fonctionnalités, les composants WebPart, etc. Pensez à installer les personnalisations au bon endroit dans votre nouvelle batterie de serveurs. Par exemple, les feuilles de style supplémentaires dont vous avez besoin pour les Produits SharePoint 2010 doivent être installées dans le chemin /14, et non le nouveau chemin /15, afin que les collections de sites que vous n'avez pas mises à niveau puissent les utiliser. Assurez-vous aussi de transférer tous les paramètres uniques des fichiers Web.config de chaque application web vers les nouveaux serveurs.

2. Problèmes de configuration dans la batterie de serveurs, l'application web ou les applications de service, tels que les chemins d'accès gérés ou les applications de service qui ne sont pas démarrées.

3. Problèmes supplémentaires que vous détectez site par site, à commencer par les sites à haut profil ou d'une grande importance.

Lorsque vous identifiez et résolvez les problèmes de niveau supérieur, vous pouvez tenter de réexécuter la mise à niveau pour déterminer si tous les problèmes survenus par la suite au cours du processus de mise à niveau ont également été résolus.

Problèmes courants

Vérifiez si les problèmes suivants génèrent une erreur ou un avertissement de mise à niveau.

Q : Je souhaite procéder à une mise à niveau à partir d'une version précommerciale de SharePoint 2013.

• R : La mise à niveau entre une version précommerciale de SharePoint 2013 et une version commerciale de SharePoint 2013 n'est pas prise en charge.

  Les versions précommerciales sont conçues uniquement à des fins de test et ne doivent pas être utilisées dans des environnements de production. Par ailleurs, la mise à niveau d’une version précommerciale vers une autre n’est pas prise en charge.

Q : Le fichier journal indique que des modèles, des fonctionnalités ou d’autres personnalisations côté serveur sont manquants.

• R : Identifiez toutes les personnalisations côté serveur et installez-les avant de procéder à la mise à niveau.

L'une des erreurs couramment rencontrées lors d'une mise à niveau est l'absence de fichiers côté serveur, à savoir des fichiers qui ont été installés avec Produits SharePoint 2010 ou des fichiers personnalisés. Au moment de préparer la mise à niveau, vous devez avoir créé un inventaire des personnalisations côté serveur requises pour vos sites (telles que les définitions de site, les modèles, les fonctionnalités, les composants WebPart et les assemblys). Consultez cet inventaire pour vérifier que tous les fichiers requis pour vos personnalisations sont installés dans votre nouvel environnement.

Vous pouvez utiliser l’applet de commande Microsoft PowerShell test-spcontentdatabase avant de mettre à niveau la base de données pour identifier les fichiers manquants. L'opération enumallwebs dans l'outil Stsadm.exe peut également servir à identifier les personnalisations côté serveur en cours d'utilisation.

Les fichiers journaux de mise à niveau peuvent signaler diverses erreurs, notamment celles qui suivent :

• ERREUR Détection de site(s) web de référence avec un ID de modèle de site web manquant (lcid : code de langue du modèle de site) dans ContentDatabase (nom de la base de données de contenu.

• ERROR Trouvé un ID de fonctionnalité manquant = [Identificateur de fonctionnalité]

• Warning File [Relative File Path] est référencé [Reference Count] fois dans la base de données, mais n’est pas installé sur la batterie actuelle.

• La classe WebPart WARNING [Identificateur de composant WebPart] est référencée [Nombre de références] dans la base de données, mais n’est pas installée sur la batterie de serveurs actuelle.

• WARNING Assembly [Assembly Path] est référencé dans la base de données, mais n’est pas installé sur la batterie actuelle.

• AVERTISSEMENT Impossible de mettre à niveau la fonctionnalité. Exception : L’ID de définition de fonctionnalité « Feature Identifier » est introuvable.

Si vous pouvez obtenir une dépendance ou un fichier côté serveur manquant, installez-le et réexécutez la mise à niveau pour les sites affectés. Si la dépendance ou le fichier (par exemple, un composant WebPart) est déconseillé, vous devez déterminer si vous souhaitez recréer le site, la page ou le composant WebPart pour utiliser un modèle, une fonctionnalité ou un composant WebPart différent. Si vous pouvez recréer la personnalisation à l'aide de dépendances qui ne sont pas déconseillées, vous pouvez réexécuter la mise à niveau pour les sites affectés. Si vous ne pouvez pas supprimer la dépendance, vous ne pouvez pas mettre à niveau le site.

Après avoir installé le fichier ou la dépendance manquants, utilisez l’applet de commande Microsoft PowerShell test-SPContentDatabase sur un serveur de test pour déterminer si d’autres fichiers de cette base de données sont manquants. Si vous n’exécutez de nouveau que l’outil de mise à niveau, il est possible que l’erreur n’apparaisse pas dans les fichiers journaux alors qu’elle se produit toujours.

Q : Le fichier journal indique une anomalie liée à ma batterie de serveurs, une application web ou les paramètres de configuration des applications de service.

• R : Vérifiez les paramètres de votre batterie de serveurs et votre application web.

• R : Créez et démarrez les applications de service manquantes.

• R : Vérifiez que les chemins d'accès gérés (chemins d'accès inclus) sont configurés comme il se doit pour chaque application web.

Les fichiers journaux de mise à niveau peuvent signaler diverses erreurs, notamment les suivantes :

• ERROR Template ID: SPSite ID= Site ID n’a pas pu être accessible en raison d’une exception. SPWeb Id= ID du site web sera ignoré pour la mise à niveau modèle. Exception : System.IO.FileNotFoundException : impossible de trouver le site avec l'ID ID du site.

  Cette erreur indique qu'un chemin d'accès géré est manquant. Ajoutez le chemin d’accès géré pour la collection de sites à l’application web et redémarrez la mise à niveau pour la base de données de contenu qui comporte cette collection de sites.

Q : Des erreurs et des avertissements indiquant des problèmes de connectivité ou des éléments endommagés s’affichent lors de la mise à niveau.

• R : Vérifiez vos connexions d'alimentation et la connexion au réseau et à SQL Server. Toute perte de connectivité avec les sources de données peut provoquer des erreurs. Si vos serveurs ne peuvent pas se connecter aux bases de données, ils ne peuvent pas être mis à niveau.

Q : Je manque d’espace disque.

• R : Libérez de l'espace ou augmentez la taille du fichier journal des transactions avant de reprendre la mise à niveau. Si vous manquez d'espace (notamment pour les fichiers journaux des transactions sur vos serveurs de bases de données), la mise à niveau ne pourra pas se poursuivre.

  Pour plus d'informations, voir Gérer la taille du fichier journal des transactions.

Q : Je reçois une erreur d’authentification.

• R : Assurez-vous que l'application web utilise la méthode d'authentification adéquate.

Une disparité dans les méthodes d'authentification peut poser des problèmes lors de la mise à niveau. Les ressources suivantes peuvent vous être utiles si vous rencontrez cette disparité :

• Authentification classique et authentification basée sur les revendications

  Assurez-vous que les applications web que vous avez créées dans SharePoint 2013 utilisent la même méthode d'authentification que celle utilisée dans Produits SharePoint 2010. L'authentification basée sur les revendications constitue la méthode d'authentification par défaut pour les applications web dans SharePoint 2013. Si l'application web utilisait le mode classique, vous pouvez soit la mettre à jour en mode d'authentification basée sur les revendications avant de mettre la base de données à niveau, soit la créer en mode classique, puis la migrer vers le mode basé sur les revendications. Pour plus d’informations sur la création d’une application web qui utilise le mode classique, puis la migration vers des revendications, voir [Créer des applications web qui utilisent l’authentification en mode classique dans SharePoint Server]/previous-versions/office/sharepoint-server-2010/gg276326(v=office.14)) et Migrer du mode classique à l’authentification basée sur les revendications dans SharePoint 2013

• Authentification basée sur les formulaires

  Des étapes supplémentaires sont nécessaires si vous mettez à niveau un environnement qui utilise l'authentification basée sur les formulaires. Suivez les étapes décrites dans Configurer l’authentification basée sur les formulaires pour une application web basée sur des revendications dans SharePoint Server afin de mettre à niveau les fournisseurs d’authentification basés sur les formulaires.

Q : SQL Server affirme que je n’ai pas les autorisations requises.

• R : Si vous recevez une erreur concernant un compte inconnu ou si une base de données n'est pas mise à niveau, vérifiez les autorisations de la base de données. Pensez tout particulièrement à vérifier que la sécurité est configurée comme il se doit entre les instances SQL Server. Vérifiez que les comptes de connexion que vous utilisez sont dotés des rôles fixes et des autorisations appropriés dans les bases de données et qu'ils resteront valides si vous procédez à des mises à niveau dans les domaines.

• R : Assurez-vous que le compte que vous utilisez pour joindre les bases de données est membre du rôle de base de données fixe db_owner pour les bases de données que vous souhaitez mettre à niveau.

Q : Impossible de mettre à niveau une base de données.

• **R : ** Vérifiez que la base de données n'est pas en lecture seule. Il est impossible de mettre à niveau une base de données accessible en lecture seule. Veillez à définir les bases de données en lecture/écriture avant de joindre et mettre à niveau les bases de données.

Q : J’ai changé le nom d’une base de données lors de la restauration mais je ne trouve pas les fichiers qui portent ce nom.

• **R : ** Lorsque vous renommez une base de données au moment de la restauration, vous devez également renommer les noms de la base de données et du fichier journal dans le système de fichiers (fichiers MDF et LDF) afin qu'ils correspondent.

Q : Impossible de sauvegarder la base de données d’administration des applications de service de recherche

• **R : ** Avant de sauvegarder la base de données d'administration des applications de service de recherche, vous devez arrêter le service de recherche dans votre batterie de serveurs SharePoint Server 2010. Pour arrêter le service de recherche dans la batterie de serveurs d'origine, dans le menu Démarrer, cliquez sur Outils d'administration, puis sur Services. Cliquez avec le bouton droit sur SharePoint Server Search 14, puis cliquez sur Arrêter. Pensez à redémarrer le service après avoir sauvegardé la base de données.

Q : Les connexions approuvées ne fonctionnent pas pour Excel Services après la mise à niveau.

• **R :** Vous devez manuellement créer toutes les connexions de données approuvées Excel Services à l’issue de la mise à niveau.

Q : Mes flux de travail ne sont plus correctement associés.

• **A: ** Verify that the Workflow Auto Cleanup timer job is turned off. If you had disabled the Workflow Auto Cleanup timer job in your SharePoint 2010 Products environment, make sure that you disable this timer job in the new environment also. If this timer job is enabled in the new environment and disabled in the SharePoint 2010 Products environment, you might lose workflow associations when you upgrade.

Q : J’ai migré les utilisateurs de l’authentification classique vers l’authentification basée sur les revendications après la mise à niveau. Mais certains utilisateurs ont des informations obsolètes

• **A: ** For issues with user profiles, make sure that that the User Profile to SharePoint Full Synchronization job was run.

  Si vous avez démarré le travail Synchronisation complète du profil utilisateur avec SharePoint (de manière automatique ou manuelle) avant la fin du processus de migration, certains utilisateurs n'ont peut-être pas été migrés. Vous pouvez exécuter l’applet de commande suivante dans Microsoft PowerShell une fois la migration terminée pour effacer les données de synchronisation, puis vous pouvez réexécuter la tâche de synchronisation complète du profil utilisateur vers SharePoint pour inclure les utilisateurs supplémentaires.

  $database = Get-SPContentDatabase "DatabaseName"
  [Microsoft.Office.Server.UserProfiles.WSSProfileSynch]::ClearSyncDataForContentDatabase($database)
  

  Où DatabaseName est le nom de la base de données de contenu pour la collection de sites associée au profil utilisateur obsolète.

• **A: ** Verify that the user exists in the Active Directory domain.

  Si l'utilisateur n'existe pas, vous pouvez le désigner comme étant supprimé dans la table UserInfo. Si l'utilisateur existe, vous pouvez à nouveau exécuter la migration. Pour plus d'informations, voir Migrer de l'authentification en mode classique vers l'authentification basée sur les revendications dans SharePoint 2013.

Voir aussi

Autres ressources

Utiliser une mise à niveau d’évaluation vers SharePoint 2013 pour rechercher les problèmes éventuels

Vérifier les mises à niveau de base de données dans SharePoint 2013

Examiner les collections de sites mises à niveau vers SharePoint 2013

[Redémarrer une mise à niveau d’attachement de base de données ou une mise à niveau de collection de sites vers SharePoint 2013] (/previous-versions/office/sharepoint-server-2010/ff382638(v=office.14)