Migration de SharePoint 2010

vers SharePoint 2013 (v3.21)

Tutorial conçu et rédigé par Michel de CREVOISIER - Août 2013








SOURCES


SharePoint migration :
 Posters : http://technet.microsoft.com/en-us/sharepoint/fp142375.aspx
 Overview process : http://technet.microsoft.com/en-us/library/cc262483.aspx
 Checklist de migration d’une base de données : http://technet.microsoft.com/en-
us/library/ff607663.aspx
 Mise à jour des bases de données : http://technet.microsoft.com/en-us/library/cc303436.aspx

Mise à jour des collections :
 Processus générale de mise à jour vers SharePoint 2013 : http://technet.microsoft.com/en-
us/library/cc262483.aspx
 Gestion de la mise à jour des collections : http://technet.microsoft.com/en-us/library/jj219599

Modules explicatifs de présentation : http://technet.microsoft.com/en-us/sharepoint/fp123606.aspx



2

INDEX


SOURCES .............................................................................................................................................................. 1
INDEX ................................................................................................................................................................... 2
Préambule ........................................................................................................................................................... 3
1. Préparation de la migration ....................................................................................................................... 4
1.1 Informations à récupérer .................................................................................................................... 4
1.2 Base de données à transférer .............................................................................................................. 4
2. Exportation des données ............................................................................................................................ 5
2.1 Exportation des solutions .................................................................................................................... 5
2.2 Copie des bases de données ............................................................................................................... 5
3. Importation des données ........................................................................................................................... 6
3.1 Création des WebApp .......................................................................................................................... 6
3.2 Importation des solutions ................................................................................................................... 6
3.3 Restauration des bases de données .................................................................................................... 7
4. Mise à jour des bases de données ............................................................................................................. 8
4.1 Test d’association ................................................................................................................................ 8
4.2 Association des bases de données ...................................................................................................... 8
4.3 Passage en authentification « Claims » ............................................................................................... 8
4.4 Version des bases de données ............................................................................................................ 9
5. Mise à jour des collections de sites (sauf « My Sites ») .......................................................................... 10
5.1 « Etat de santé » de la collection ...................................................................................................... 10
5.2 Mise à jour de la collection ................................................................................................................ 10
6. Mise à jour d’une collection « My Sites » ................................................................................................ 11
6.1 Changement des propriétaires de la collection ................................................................................ 11
6.2 Mise à jour visuelle ............................................................................................................................ 11
7. Erreurs ....................................................................................................................................................... 11
7.1 Feature upgrade incomplete for Feature […] .................................................................................... 11





3

Préambule



Ce tutorial va pour expliquer comment migrer SharePoint 2010 vers SharePoint 2013. Avant de
migrer, vous devez impérativement disposer d’une architecture SharePoint 2013 opérationnelle.
Pour cela, il vous faut tout d’abord installer SharePoint 2013 sur l’ensemble des serveurs de votre
ferme et ensuite passer à la phase de configuration. D’une façon plus générale, une migration
SharePoint peut être qualifiée comme une migration de bases de données « content » associées à
vos sites.

Parmi les nouveautés notables de SharePoint 2013, on citera :
 La fonctionnalité Search (ex Fast-Search) :
o Intégrée nativement à SharePoint
o Nouvelle algorithme d’indexation
o Nouveau mode de Crawl continu
o Nouveaux composants: Content et Analytics
o Support natif des documents PDF
o Nouveaux outils graphiques de statistiques
 Le service Request Management
 Les services Reporting Services (SSRS) et Analysis Services (SSAS) sont nativement intégrés
dans SharePoint 2013. Aucune configuration n’est donc nécessaire côté serveur SQL
 Une meilleure optimisation des requêtes et de la bande passante (source)


Vous trouverez d’autres tuto en relation avec ce sujet sur mon blog :
 Installation de SharePoint 2013 (tuto)
 Configuration de SharePoint 2013 (tuto)
 Activation et mise en place de FastSearch 2013 (tuto)
 Configuration du service de cache (tuto)
 Configuration du service UPS (tuto)
 Configuration des fonctionnalités « BI » : Reporting, PowerPivot, Analysis, Excel… (tuto)
 Migration de SharePoint 2010 vers 2013 (tuto)



4

1. Préparation de la migration

1.1 Informations à récupérer

Pour préparer au mieux votre migration, récupérez les informations suivantes. Elles vous seront utiles
pour la configuration de votre nouvelle ferme :
 Chemins d’accès alternatif
 Fournisseurs d’authentification
 « Managed paths »
 Paramètres entrants et sortants de courrier
 Certificats IIS
 WebApp existantes

1.2 Base de données à transférer

Les bases de données ci-dessous sont « migrables » vers SharePoint 2013. Si vous comptez les migrer,
ne configurez surtout pas les « services applications » de votre nouvelle ferme. Toutefois, sachez que
leur migration n’est pas nécessaire dans la mesure où les informations qu’elles contiennent seront
automatiquement recréées (sauf les « DB content » bien évidemment).




5

2. Exportation des données

2.1 Exportation des solutions

Pour exporter les solutions existantes (format WSP), exécutez le script suivant sur votre ancien
serveur SharePoint :
foreach($sol in Get-SPSolution)
{
$file = $sol.SolutionFile
$filename = "D:\WSP\"+$sol.name
$file.SaveAs($filename)
}

Copiez-les ensuite dans un répertoire sur un de vos serveurs frontaux. Nous verrons au point 3.2
comment les déployer sur votre nouvelle architecture.

2.2 Copie des bases de données

En accord avec le point 1.2, copiez les bases de données « Content » sur votre nouveau serveur SQL.
Pour cela :
 Démontez la base au « niveau » SharePoint (le site sera inaccessible durant ce processus):
Dismount-SPContentDatabase <DB name>

 Mettez ensuite la base hors-ligne pour être en mesure de la copier. Effectuez cette tâche
directement depuis le serveur SQL local et non à distance :
o Depuis Management Studio : clic droit sur votre base > Take offline
 Une fois la base hors ligne, copiez les fichiers MDF et LDF sur votre nouveau serveur SQL
 Le point 3.3.1 vous expliquera comment attacher vos bases de données sur votre nouveau
serveur SQL

Note : une sauvegarde peut également être utilisée pour restaurer les données sur votre nouvel
environnement. Toutefois, cette solution s’avère plus longue et plus contraignante que celle décrite
précédemment.


6

3. Importation des données

3.1 Création des WebApp

Pour commencer, créez vos WebApp. Contrairement à ce qu’il se dit, il n’est strictement pas
nécessaire d’utiliser la même URL et le même port que la WebApp d’origine. Par ailleurs sachez que
l’authentification par défaut sous SharePoint 2013 est « Claims ». Il vous faudra donc créer vos
WebApp en utilisant la méthode d’authentification basique (NLTM) et procéder ultérieurement au
changement de méthode d’authentification (point 4.3). Pour créer une WebApp avec
authentification classique :
New-SPWebApplication -Name "<WebApp>" -Port <port> -HostHeader <site header> -
ApplicationPool "<IIS pool name>" -ApplicationPoolAccount (Get-SPManagedAccount
"domaine\pool account") -AuthenticationMethod NTLM –Databasename <DB name> [ -
SecureSocketsLayer]

3.2 Importation des solutions

3.2.1 Ajout

Pour ajouter les solutions extraites au point 2.1 sur votre nouveau serveur SharePoint, il est
nécessaire d’exécutez le script suivant :
$Files = Get-ChildItem "D:\\WSP\\" *.wsp
foreach($file in $Files)
{
Add-SPSolution -LiteralPath $file.FullName
}

Consultez ensuite les solutions ajoutées en allant dans :
 Central administration > System settings > Manage farm solutions

3.2.2 Installation

Avant d’installer une application, assurez qu’elle ne présente pas de dépendances avec une Web
Application. Pour connaître ses dépendances, cliquez simplement sur la solution :



7

Selon les paramètres obtenus, adaptez le script à la suite avec les paramètres ci-dessous :
 -AllWebApplications : déploiement sur toutes les Web Application de la ferme. Ajoutez cette
option uniquement si votre application présente la dépendance Contains Web Application
Resource
 -WebApplication : déploiement sur une seule Web Application. Ajoutez cette option
uniquement si votre application présente la dépendance Contains Web Application Resource
 -Local : déploiement sur le serveur actif. Cette solution s’avère très intéressante lorsq’uil s’agit
de déployer une solution sur un serveur frontal sans exécuter des « IISreset » sur l’ensemble
des serveurs frontaux de la ferme. Toutefois, la solution sera marquée comme « déployée »
uniquement lorsqu’elle l’aura été sur tous les serveurs frontaux

$Files = Get-ChildItem "D:\\WSP\\" *.wsp
foreach($file in $Files)
{
Install-SPSolution $file.Name -GACDeployment
}

Attention : la durée de ce processus varie selon le nombre de solutions à installer. De même,
l’ensemble des sites de la ferme risquent ne répondront plus en raison des IISreset exécutés durant
chaque processus. Exécutez la commande Get-SPSolution pour connaître leur l’état d’avancement.

3.2.3 Erreur lors de l’installation d’une solution

Une fois l’ensemble des solutions déployées, retournez dans Central administration > System
settings > Manage farm solutions et vérifiez leur statut. Si certaines solutions présentaient une
erreur, relancez le processus d’installation avec la commande -force.

3.3 Restauration des bases de données

3.3.1 Attachement des bases de données

Après avoir copié les bases de données « Content » (point 2.2), il vous faut maintenant les
« attacher » depuis Management Studio. Pour cela :
 Connectez-vous à votre nouveau serveur SQL
 Clic droit sur le serveur > Attach
 Indiquez l’emplacement des fichiers MDF et LDF
 Validez et vérifiez la présence de la base de données

3.3.2 Nettoyage des droits

Quand une base de données est copiée, tous les anciens comptes de sécurité associés à la base de
données sont conservés. Assurez-vous donc de supprimer ces anciens comptes. Lors de son
association avec SharePoint (point 4.2), les droits nécessaires lui seront automatiquement ajoutés
(en l’occurrence les comptes Pool et Farm).



8

4. Mise à jour des bases de données

4.1 Test d’association

Avant d’associer vos bases de données à leurs WebApp respectives, il est nécessaire de s’assurer
qu’elles ne présentent pas d’erreurs. Pour cela :
Test-SPContentDatabase -Name <DB name> -WebApplication http://<url:port>

Il se peut alors que les erreurs suivantes apparaissent :
 Missing Feature : script de « nettoyage » ici ou outils en GUI dédié (source)
 Missing Web Part : script de « nettoyage » ici ou ici. Vérifiez toutefois que toutes vos solutions
aient correctement été déployées sur les WebApp adéquates
 Missing Setup File : script de « nettoyage » ici. Notez que cette erreur peut être également
liée à l’absence de certains packs de langues
 Missing Assembly : script de « nettoyage » ici
 Configuration : The [WebApp] web application is configured with claims authentication
mode however […]. Référez-vous au point 4.3 pour changer le mode d’authentification

Important : ces erreurs ne vous empêcheront pas de mettre à jour vos bases de données, sauf
indication contraire. Il s’agit ni plus ni moins de vous informer des éventuelles références
manquantes.

4.2 Association des bases de données

Après avoir corrigé les erreurs d’association, vous pouvez associer votre base de données à votre
WebApp (source). Attention, la durée de ce processus varie selon la taille de la base de données :
Mount-SPContentDatabase "<ContentDb>" -DatabaseServer "<alias>" -WebApplication <WebApp
URL>

4.3 Passage en authentification « Claims »

Sous SharePoint 2013, l’authentification basique (NTLM) est « dégradée » et il convient d’utiliser
l’authentification « claims » (informations). Il ne vous reste donc plus qu’à exécuter la commande ci-
dessous pour modifier le mode d’authentification (source) :
Convert-SPWebApplication -Identity <URL WebApp> –To Claims –RetainPermissions

Notez que cela active les modes d’authentifications Anonymous et Forms dans IIS. De base, seules les
authentifications Windows et ASP.NET sont activées.


9

Attention : cette action rajoute temporairement votre compte dans l’User Policy de la WebApp. Vous
devrez obligatoirement retirer ce compte après être passé en Claims. Dans le cas contraire une erreur
d’accès refusé sera affichée.

4.4 Version des bases de données

Il est également recommandé de changer le mode de compatibilité des bases de données
« Content ». Effectuez cette opération depuis Management Studio :
 Clic droit sur la base de données « Content » > Properties > Options




10

5. Mise à jour des collections de sites (sauf « My Sites »)

5.1 « Etat de santé » de la collection

Avant de passer en style visuel 2013, vous devez vous assurer qu’il n’existe pas de sites incompatibles
pouvant empêcher la mise à jour. Pour cela :
 Allez dans les paramètres de votre collection
 Cliquez sur Site collection health checks :

 Cliquez sur Start checks :

Une fois les erreurs critiques (en rouge) corrigées, passez à l’étape suivante :

5.2 Mise à jour de la collection

La mise à jour d’une collection de sites s’effectue via des plusieurs commandes (source). Pour
commencer, il vous faut connaître la version de vos sites (14 pour SharePoint 2010 et 15 pour
SharePoint 2013) :
Get-SPSite -Limit all [-CompatibilityLevel 14]

Il ensuite s’assurer qu’aucun problème de compatibilité vous empêchera de mettre à jour la
collection :
Test-SPSite <URL site>

Pour terminer, mettez à jour la collection :
Upgrade-SPSite <URL site> –VersionUpgrade

Plus détails ici.



11

6. Mise à jour d’une collection « My Sites »

6.1 Changement des propriétaires de la collection

Pour mettre à jour les sous-sites membres d’une collection de type « My sites », vous devez modifier
le second propriétaire (le premier étant l’utilisateur) de chacun d’entre eux. Pour cela :
$scadmin = "<domaine\Farm Acct>"
$Sites = Get-SPSite -ContentDatabase "<database>" -Limit all
foreach ($site in $Sites)
{
Set-SPSite -Identity $site -SecondaryOwnerAlias $scadmin
Write-host $site -foreground yellow
}

6.2 Mise à jour visuelle

Maintenant que vous disposez des droits nécessaires sur l’ensemble des sous-sites, récupérez
l’ensemble des URL des sites « My sites » à mettre à jour. Pour cela :
Get-SPSite -ContentDatabase "<database>" -Limit all -CompatibilityLevel 14 | ft URL > mysites-v14.txt

Après avoir copié ces URL dans un tableur, concaténez à chacune d’elles la commande suivante tout
en étirant votre formule. Une fois l’ensemble des commandes générées, exécutez-les :
Upgrade-SPSite <URL my site> –VersionUpgrade

Le processus prend en moyenne 3 minutes par site.

7. Erreurs

7.1 Feature upgrade incomplete for Feature […]

SPFeatureDefinition ERROR Feature upgrade action
'CustomUpgradeAction.VariationsInfrastructure' threw an exception upgrading Feature
'PublishingResources' (Id: 14/'aebc918d-b20f-4a11-a1db-9ed84d79c87e') in Site [site]': Object
reference not set to an instance of an object.22dad29f-ed44-4ca8-8b38-ce0d370fd7cb

Cette erreur est causée par la non activation de la fonctionnalité « Publishing cache ». Solution :
stsadm -o activatefeature -name PublishingSite -url <url> -force
stsadm -o activatefeature -name PublishingResources -url <url> -force


N’hésitez pas à m’envoyer vos commentaires ou retours à l’adresse suivante :
m . decrevoisier A-R-0-B-A-5 outlook . com


Soyez-en d’ores et déjà remercié

Sign up to vote on this title
UsefulNot useful