SharePoint 2007 : Réussir sa mise à jour vers le SP1

J'ai encore très récemment pu voir une question sur le forum MSDN concernant une plateforme SharePoint de production inaccessible suite à l'application du Service Pack 1 pour MOSS 2007. Je le rappelle et je le rappellerai encore, avant d'installer un service Pack :

• Faites toujours un backup de votre plateforme
  • Stsadm -o backup pour la plateforme SharePoint
  • Backup des bases SQL, notamment celles de configuration et d'administration.
  • Backup des serveurs avec des outils adaptés.
• Prenez le temps de tester la mise à jour sur un environnement de validation
• Planifiez la mise à jour, considérez le pire scénario, et prévoyez le temps qu'il vous faudra pour tout rétablir si cela vous arrive.

Pour résumer : ne faites pas de mise à jour si vous n'êtes pas en mesure de faire un retour arrière !

Et parce que le risque 0 n'existe pas, nous sommes nombreux à avoir rencontré des problèmes lors de cette mise à jour (voir le billet de Fabrice Romelard à ce sujet).

Si un retour arrière est possible dès lors que tous les points précédemment cités ont été respectés, il reste à trouver comment recommencer l'opération avec plus de succès. Dans mon cas, c'est une approche systémique qui m'a apporté la solution. Pourquoi une approche systémique ? Tout simplement parce que l'application du Service Pack 1 effectue des modifications Sur les serveurs SharePoint ET Sur les bases de données. Et je suis parti de ce constat pour mettre à jour ces deux éléments séparément : d'abord les serveurs, puis les bases de contenu? et séparément, ces deux mises à jour sont moins complexes qu'une mise à jour globale.

Voici comment procéder :

Avant de commencer

1. Faites tous les backups listés précédemment
2. Assurez vous que votre serveur SQL ait suffisamment d'espace disque.

Première étape : détacher les bases de contenu

1. Connectez-vous à la console d'administration centrale de SharePoint.
2. Cliquez sur l'onglet « Application management »
3. Sélectionnez votre application Web
4. Détachez une à une toutes vos bases de contenu
5. Répétez l'opération pour chacune de vos applications Web (hors celle d'administration)

Remarque : vous pouvez également détacher vos bases de contenu à l'aide de la commande

stsadm -o deletecontentdb -url http://computername -databasename

Seconde étape : appliquer les SP1 à la plateforme SharePoint

1. Exécutez le SP1 WSS sur chacun de vos serveurs.
2. Suivez l'assistant jusqu'à ce que le pop-up ci-dessous apparaisse. Si votre ferme est constituée de plusieurs serveurs, ne cliquez surtout pas sur le bouton « OK ». Répétez cette étape pour chacun des serveurs de la ferme.

   

3. Une fois que vos serveurs ont tous déroulé l'assistant, cliquez sur le bouton OK.
4. Connectez-vous à la console d'administration centrale et regardez le numéro de version indiqué sur la page /_admin/FarmServers.Aspx. La version 12.0.0.6219 indique que la mise à jour s'est bien déroulée

En cas d'anomalie pendant la mise à jour, vous pourrez la retenter en exécutant la commande :

psconfig -cmd upgrade -inplace b2b -wait -force

1. Si vous utilisez des packs de langue, installez les services packs spécifiques pour chacun de vos packs de langue.
2. Si votre plateforme SharePoint est une plateforme MOSS, répétez les opérations 1 à 5 avec le Service Pack 1 de MOSS (Il vous faudra donc installer le SP1 de WSS dans tous les cas).

Troisième étape : rattacher et mettre à jour les bases de contenu.

1. Connectez-vous à la console d'administration centrale de SharePoint.
2. Cliquez sur l'onglet « Application management »
3. Sélectionnez votre application Web
4. Rattachez une à une toutes vos bases de contenu. Les modifications du service Pack impacteront les bases de données pendant l'opération.
5. Répétez l'opération pour chacune de vos applications Web

Remarque : vous pouvez également attacher vos bases de contenu à l'aide de la commande

stsadm -o addcontentdb -url -databasename -databaseserver

Il est alors possible que votre environnement soit mis à jour et pleinement opérationnel. Pourquoi seulement « possible » ? Parce que si vous êtes sous MOSS, il est probable que l'opération ait désynchronisé vos bases de contenu avec celles du SSP, auquel cas vous retrouverez pas mal d'erreurs dans vos logs et un site répondant? parfois bien mal.

Pour remédier, exécutez la commande

stsadm -o preparetomove -contentdb dbname -oldcontentdb

où est le GUID de référence de votre base de contenu dans SharePoint. Il vous faudra donc les lister à l'aide de la commande

stsadm -o sync -listolddatabases 1

Etape optionnelle :

Si vous aviez installé des hot fixes antérieurs au SP1, il est possible qu'ils ne soient plus actifs (tous les hot fixes publié auparavant ne sont pas inclus dans le SP1, et certain d'entre eux disparaissent purement et simplement avec la mise à jour du SP1). Comme je vous le disais dans mon précédent post, c'est l'occasion d'appliquer les hot fixes post SP1 :

• WSS : http://support.microsoft.com/kb/941422/en-us
• MOSS : http://support.microsoft.com/kb/941274/en-us

Remarque : lors de l'application des hot fixes posts SP1, votre plateforme SharePoint passera en version 12.0.6301.5000.

Ressources complémentaires :

• Deploy software updates for Office SharePoint Server 2007
• Le blog de Cory Burns
• Le blog de Gat

... et merci à Julien Chomarat avec qui j'ai fait cette mise à jour ;-).