Migration de SharePoint 2010

vers SharePoint 2013 (v3.21)

Tutorial conu et rdig par Michel de CREVOISIER - Aot 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 dune base de donnes : http://technet.microsoft.com/en-
us/library/ff607663.aspx
Mise jour des bases de donnes : http://technet.microsoft.com/en-us/library/cc303436.aspx

Mise jour des collections :
Processus gnrale 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 prsentation : http://technet.microsoft.com/en-us/sharepoint/fp123606.aspx



2

INDEX


SOURCES .............................................................................................................................................................. 1
INDEX ................................................................................................................................................................... 2
Prambule ........................................................................................................................................................... 3
1. Prparation de la migration ....................................................................................................................... 4
1.1 Informations rcuprer .................................................................................................................... 4
1.2 Base de donnes transfrer .............................................................................................................. 4
2. Exportation des donnes ............................................................................................................................ 5
2.1 Exportation des solutions .................................................................................................................... 5
2.2 Copie des bases de donnes ............................................................................................................... 5
3. Importation des donnes ........................................................................................................................... 6
3.1 Cration des WebApp .......................................................................................................................... 6
3.2 Importation des solutions ................................................................................................................... 6
3.3 Restauration des bases de donnes .................................................................................................... 7
4. Mise jour des bases de donnes ............................................................................................................. 8
4.1 Test dassociation ................................................................................................................................ 8
4.2 Association des bases de donnes ...................................................................................................... 8
4.3 Passage en authentification Claims ............................................................................................... 8
4.4 Version des bases de donnes ............................................................................................................ 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 dune collection My Sites ................................................................................................ 11
6.1 Changement des propritaires de la collection ................................................................................ 11
6.2 Mise jour visuelle ............................................................................................................................ 11
7. Erreurs ....................................................................................................................................................... 11
7.1 Feature upgrade incomplete for Feature [] .................................................................................... 11





3

Prambule



Ce tutorial va pour expliquer comment migrer SharePoint 2010 vers SharePoint 2013. Avant de
migrer, vous devez imprativement disposer dune architecture SharePoint 2013 oprationnelle.
Pour cela, il vous faut tout dabord installer SharePoint 2013 sur lensemble des serveurs de votre
ferme et ensuite passer la phase de configuration. Dune faon plus gnrale, une migration
SharePoint peut tre qualifie comme une migration de bases de donnes content associes
vos sites.

Parmi les nouveauts notables de SharePoint 2013, on citera :
La fonctionnalit Search (ex Fast-Search) :
o Intgre nativement SharePoint
o Nouvelle algorithme dindexation
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 intgrs
dans SharePoint 2013. Aucune configuration nest donc ncessaire ct serveur SQL
Une meilleure optimisation des requtes et de la bande passante (source)


Vous trouverez dautres 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 fonctionnalits BI : Reporting, PowerPivot, Analysis, Excel (tuto)
Migration de SharePoint 2010 vers 2013 (tuto)



4

1. Prparation de la migration

1.1 Informations rcuprer

Pour prparer au mieux votre migration, rcuprez les informations suivantes. Elles vous seront utiles
pour la configuration de votre nouvelle ferme :
Chemins daccs alternatif
Fournisseurs dauthentification
Managed paths
Paramtres entrants et sortants de courrier
Certificats IIS
WebApp existantes

1.2 Base de donnes transfrer

Les bases de donnes 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 nest pas ncessaire dans la mesure o les informations quelles contiennent seront
automatiquement recres (sauf les DB content bien videmment).




5

2. Exportation des donnes

2.1 Exportation des solutions

Pour exporter les solutions existantes (format WSP), excutez 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 rpertoire sur un de vos serveurs frontaux. Nous verrons au point 3.2
comment les dployer sur votre nouvelle architecture.

2.2 Copie des bases de donnes

En accord avec le point 1.2, copiez les bases de donnes Content sur votre nouveau serveur SQL.
Pour cela :
Dmontez 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 tche
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 donnes sur votre nouveau
serveur SQL

Note : une sauvegarde peut galement tre utilise pour restaurer les donnes sur votre nouvel
environnement. Toutefois, cette solution savre plus longue et plus contraignante que celle dcrite
prcdemment.


6

3. Importation des donnes

3.1 Cration des WebApp

Pour commencer, crez vos WebApp. Contrairement ce quil se dit, il nest strictement pas
ncessaire dutiliser la mme URL et le mme port que la WebApp dorigine. Par ailleurs sachez que
lauthentification par dfaut sous SharePoint 2013 est Claims . Il vous faudra donc crer vos
WebApp en utilisant la mthode dauthentification basique (NLTM) et procder ultrieurement au
changement de mthode dauthentification (point 4.3). Pour crer 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
ncessaire dexcutez le script suivant :
$Files = Get-ChildItem "D:\\WSP\\" *.wsp
foreach($file in $Files)
{
Add-SPSolution -LiteralPath $file.FullName
}

Consultez ensuite les solutions ajoutes en allant dans :
Central administration > System settings > Manage farm solutions

3.2.2 Installation

Avant dinstaller une application, assurez quelle ne prsente pas de dpendances avec une Web
Application. Pour connatre ses dpendances, cliquez simplement sur la solution :



7

Selon les paramtres obtenus, adaptez le script la suite avec les paramtres ci-dessous :
-AllWebApplications : dploiement sur toutes les Web Application de la ferme. Ajoutez cette
option uniquement si votre application prsente la dpendance Contains Web Application
Resource
-WebApplication : dploiement sur une seule Web Application. Ajoutez cette option
uniquement si votre application prsente la dpendance Contains Web Application Resource
-Local : dploiement sur le serveur actif. Cette solution savre trs intressante lorsquil sagit
de dployer une solution sur un serveur frontal sans excuter des IISreset sur lensemble
des serveurs frontaux de la ferme. Toutefois, la solution sera marque comme dploye
uniquement lorsquelle laura t sur tous les serveurs frontaux

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

Attention : la dure de ce processus varie selon le nombre de solutions installer. De mme,
lensemble des sites de la ferme risquent ne rpondront plus en raison des IISreset excuts durant
chaque processus. Excutez la commande Get-SPSolution pour connatre leur ltat davancement.

3.2.3 Erreur lors de linstallation dune solution

Une fois lensemble des solutions dployes, retournez dans Central administration > System
settings > Manage farm solutions et vrifiez leur statut. Si certaines solutions prsentaient une
erreur, relancez le processus dinstallation avec la commande -force.

3.3 Restauration des bases de donnes

3.3.1 Attachement des bases de donnes

Aprs avoir copi les bases de donnes 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 lemplacement des fichiers MDF et LDF
Validez et vrifiez la prsence de la base de donnes

3.3.2 Nettoyage des droits

Quand une base de donnes est copie, tous les anciens comptes de scurit associs la base de
donnes sont conservs. Assurez-vous donc de supprimer ces anciens comptes. Lors de son
association avec SharePoint (point 4.2), les droits ncessaires lui seront automatiquement ajouts
(en loccurrence les comptes Pool et Farm).



8

4. Mise jour des bases de donnes

4.1 Test dassociation

Avant dassocier vos bases de donnes leurs WebApp respectives, il est ncessaire de sassurer
quelles ne prsentent pas derreurs. 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 ddi (source)
Missing Web Part : script de nettoyage ici ou ici. Vrifiez toutefois que toutes vos solutions
aient correctement t dployes sur les WebApp adquates
Missing Setup File : script de nettoyage ici. Notez que cette erreur peut tre galement
lie labsence de certains packs de langues
Missing Assembly : script de nettoyage ici
Configuration : The [WebApp] web application is configured with claims authentication
mode however []. Rfrez-vous au point 4.3 pour changer le mode dauthentification

Important : ces erreurs ne vous empcheront pas de mettre jour vos bases de donnes, sauf
indication contraire. Il sagit ni plus ni moins de vous informer des ventuelles rfrences
manquantes.

4.2 Association des bases de donnes

Aprs avoir corrig les erreurs dassociation, vous pouvez associer votre base de donnes votre
WebApp (source). Attention, la dure de ce processus varie selon la taille de la base de donnes :
Mount-SPContentDatabase "<ContentDb>" -DatabaseServer "<alias>" -WebApplication <WebApp
URL>

4.3 Passage en authentification Claims

Sous SharePoint 2013, lauthentification basique (NTLM) est dgrade et il convient dutiliser
lauthentification claims (informations). Il ne vous reste donc plus qu excuter la commande ci-
dessous pour modifier le mode dauthentification (source) :
Convert-SPWebApplication -Identity <URL WebApp> To Claims RetainPermissions

Notez que cela active les modes dauthentifications Anonymous et Forms dans IIS. De base, seules les
authentifications Windows et ASP.NET sont actives.


9

Attention : cette action rajoute temporairement votre compte dans lUser Policy de la WebApp. Vous
devrez obligatoirement retirer ce compte aprs tre pass en Claims. Dans le cas contraire une erreur
daccs refus sera affiche.

4.4 Version des bases de donnes

Il est galement recommand de changer le mode de compatibilit des bases de donnes
Content . Effectuez cette opration depuis Management Studio :
Clic droit sur la base de donnes 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 quil nexiste pas de sites incompatibles
pouvant empcher la mise jour. Pour cela :
Allez dans les paramtres de votre collection
Cliquez sur Site collection health checks :

Cliquez sur Start checks :

Une fois les erreurs critiques (en rouge) corriges, passez ltape suivante :

5.2 Mise jour de la collection

La mise jour dune collection de sites seffectue via des plusieurs commandes (source). Pour
commencer, il vous faut connatre la version de vos sites (14 pour SharePoint 2010 et 15 pour
SharePoint 2013) :
Get-SPSite -Limit all [-CompatibilityLevel 14]

Il ensuite sassurer quaucun problme de compatibilit vous empchera de mettre jour la
collection :
Test-SPSite <URL site>

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

Plus dtails ici.



11

6. Mise jour dune collection My Sites

6.1 Changement des propritaires de la collection

Pour mettre jour les sous-sites membres dune collection de type My sites , vous devez modifier
le second propritaire (le premier tant lutilisateur) de chacun dentre 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 ncessaires sur lensemble des sous-sites, rcuprez
lensemble des URL des sites My sites mettre jour. Pour cela :
Get-SPSite -ContentDatabase "<database>" -Limit all -CompatibilityLevel 14 | ft URL > mysites-v14.txt

Aprs avoir copi ces URL dans un tableur, concatnez chacune delles la commande suivante tout
en tirant votre formule. Une fois lensemble des commandes gnres, excutez-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 cause 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


Nhsitez pas menvoyer vos commentaires ou retours ladresse suivante :
m . decrevoisier A-R-0-B-A-5 outlook . com


Soyez-en dores et dj remerci