SharePoint 2013 : Migration d’un site SharePoint 2010 simple

Cet article fait partie d’un ensemble d’articles traitant de la migration d’environnements SharePoint (2007 et 2010) vers SharePoint 2013.

La page d’accueil de cette série d’articles se trouve ici :  Comment migrer sous SharePoint 2013 ?

Nous allons voir dans cet article comment migrer un site SharePoint 2010 simple vers SharePoint 2013.

Introduction

La  collection de sites utilisée dans cet article est la suivante, un site d’équipe dans lequel j’ai :

• Créé une bibliothèque « Docs techniques »,
• Ajouté quelques documents à la bibliothèque « Shared Documents »,
• Ajouté une image,
• Ajouté un événement dans le calendrier.

La base de données associée à cette collection se nomme « SP_Content_2010 ».

Prérequis

• Une ferme SharePoint 2010,
• Une ferme SharePoint 2013.

Préparation de l’upgrade SP2010 vers SP2013

1. Sur le serveur SharePoint 2010, lancez le « pre-upgrade checker », et utilisez le rapport pour préparer la migration.

Je considère ici que c’est OK.

2. Répertoriez les customisations utilisées dans la ferme.

Ici : RAS

3. Nettoyez votre environnement :

• Sites orphelins ou collections de site plus utilisées,
• Listes contenant un nombre très élevés d’éléments,
• Bases de contenu contenant un grand nombre de collections de site (> 5000),
• Listes ou bibliothèques ayant un grand nombre des droits mis en place au niveau des items,
• Documents ayant un nombre de versions important,
• Templates, features et webparts inutilisés.

Ici : RAS

4. Réorganisez les collections de site dans les bases de contenu

Ici : RAS

Préparation de la ferme SharePoint 2013

1.  Installez et configurez votre ferme SharePoint 2013,

2. Installez les language packs nécessaires,

3. Mettez à jour la ferme avec les dernières mises à jour disponibles,

4. Configurez les applications de service nécessaires,

5. Recréez l’application web (au singulier ici) , idéalement avec la même URL que celle de départ et avec le même mode d’authentification que pour SharePoint 2010 (Classic ou Claims),

6. Installez les développements spécifiques et déployez les sur l’application web (ici : RAS).

Pour ce dernier point, il va vous falloir utiliser le nouveau paramètre « CompatibilityLevel » de la commande « Install-SPSolution » (voir l’article SharePoint 2013 : Nouveauté concernant le déploiement des solutions – Le CompatibilityLevel).

Procédure d’upgrade vers SharePoint 2013

Pour migrer de 2010 à 2013, vous devez rattacher votre base de contenu sur une application web créée sous SharePoint 2013 afin de l’upgrader.

L’exemple est pris ici avec la base de données nommée « SP_Content_2010″.

1. Backupez la base depuis le serveur SQL de SharePoint 2010 (alors mise en lecture seule),

2. Restaurez la base sur le serveur SQL de SharePoint 2013,

3. Lancez la commande ‘Test-SPContentDatabase » afin d’identifier les éléments manquants.

Le seul point remonté ici est que notre application web utilise le mode « Classic » et non « Claims », désormais par défaut dans SharePoint 2013.

Voir :

• Paragraphe « Migration de l’application web vers le mode Claims » plus bas dans cet article,
• L’article SharePoint 2013 : Création et migration d’une application web (et nouveautés sur l’authentification)

4. Rattachez la base à une application web SharePoint 2013

Vérification de l’upgrade

1. Dans l’administration centrale vérifiez que la base est rattachée à l’application web et que la collection de site est bien comptée

2. Vérifiez dans le répertoire »\15\LOGS »  les fichier de logs Upgrade-YYYYMMDD-HHMMSS-SSS.log et Upgrade-YYYYMMDD-HHMMSS-SSS-error.log) que la migration s’est bien déroulée.

Cherchez les « ERROR » et les « WARNING »

En bas du fichier Upgrade-YYYYMMDD-HHMMSS-SSS.log se trouve un récapitulatif de la migration :

1 warning pour notre site simplissime ? Et oui, le même point identifié par la commande ‘Test-SPContentDatabase » :

Texte complet : « The [Migration2010] web application is configured with claims authentication mode however the content database you are trying to attach is intended to be used against a windows classic authentication mode. »

3. Sinon (ou en plus !) vérifiez le statut de la migration via l’administration centrale (Update and Migration / Check upgrade status) et en cliquant sur le statut de la ligne à vérifier

Je ne mets qu’ici une partie des informations affichées dans le tableau :

Test du site et finalisation de la migration

1. La collection « 2010 style » est accessible

2. Le processus de migration via l’interface se trouve dans l’article SharePoint 2013 : Procédure d’upgrade des collections de site.

Cliquez sur le fichier de logs pour voir l’état de la migration (ici 0 erreurs et 0 warnings, le rêve !)

Ce fichier de logs est stocké dans le site, dans une bibliothèque nommée « Maintenance Log Library ».

En bas du fichier de logs est affiché le statut de la migration, ici le plan s’est déroulé sans acrocs

3. En complément, un autre fichier de logs se trouve dans le répertoire « 15\LOGS »

4. Au final, le site migré s’affiche correctement en version « SharePoint 2013 ».

Migration de l’application web vers le mode « Claims »

Ce point sera détaillé dans un autre article mais sur le principe :

Comme je l’avais expliqué dans l’article « SharePoint 2013 : Création et migration d’une application web (et nouveautés sur l’authentification) » :

le provider l’authentification par défaut est désormais Claims; le mode « Classic » est néanmoins toujours supporté mais il est obsolète.

Il va donc nous falloir (dans notre exemple) – si vous avez créé votre application web sous SharePoint 2010 en mode Claims c’est bien sûr OK – convertir notre application web en mode « Claims ».

Pour cela, plusieurs choix sont possibles :

• Sous SharePoint 2010, passez de « Classic » à « Claims », puis migrez sous SharePoint 2013,
• Sous SharePoint 2013, migrez l’application web SP2010 en la passant de « Classic » à « Claims »,
• Sous SharePoint 2013, migrez l’application web SP2013 en la passant de « Classic » à « Claims ».

Conclusion

La collection de sites utilisée ici est simpliste, dans le cas d’utilisation de développements spécifiques les choses peuvent rapidement se compliquer …

Références

• Comment migrer sous SharePoint 2013 ?
• SharePoint 2013 : Création et migration d’une application web (et nouveautés sur l’authentification),
• SharePoint 2013 : Procédure d’upgrade des collections de site,
• Upgrade databases from SharePoint 2010 to SharePoint 2013,
  
• Migrate from classic-mode to claims-based authentication in SharePoint 2013