Meilleures pratiques de déploiement de contenu (SharePoint Server 2010)
S’applique à : SharePoint Server 2010
Dernière rubrique modifiée : 2016-11-30
Cet article est l’un d’une série d’articles de Meilleures pratiques pour Microsoft SharePoint Server 2010. Il décrit les meilleures pratiques applicables au déploiement de contenu. Pour plus d’informations et pour obtenir des ressources sur le déploiement de contenu, voir Gestion de contenu Web dans SharePoint Server 2010 (https://technet.microsoft.com/fr-fr/sharepoint/ff601874.aspx).
Pour plus d’informations sur les articles de cette série, voir Meilleures pratiques (SharePoint Server 2010). Pour plus d’informations et pour obtenir des ressources sur les meilleures pratiques applicables à SharePoint Server 2010, voir le Centre de ressources de meilleures pratiques pour SharePoint Server 2010 (éventuellement en anglais) (https://technet.microsoft.com/fr-fr/sharepoint/hh189420.aspx) (éventuellement en anglais).
1. Assurez-vous que les batteries de serveurs source et de destination ont des mises à jour identiques
Le déploiement de contenu est pris en charge uniquement si les niveaux de mise à jour sur les serveurs sources sont identiques à ceux des serveurs de destination. Pour garantir la réussite des travaux de déploiement de contenu, veillez à respecter les consignes suivantes :
Assurez-vous que toutes les mises à jour de Windows Server 2008 R2, Windows Server 2008 SP2 et SharePoint Server 2010 ont été appliquées aux serveurs de la batterie.
Un travail de déploiement de contenu entre des serveurs ayant des niveaux de mise à jour différents peut échouer si les versions de correctifs logiciels ont modifié le schéma des packages d’exportation de telle sorte que le serveur ait un niveau de mise à jour supérieur au serveur de destination. Cela s’applique aux travaux de déploiement de contenu exécutés à l’aide du site Web d’Administration centrale ou à l’aide des applets de commande Windows PowerShell Export-SPWeb et Import-SPWeb.
Les modules linguistiques utilisés dans la collection de sites source doivent également être installés sur la batterie de destination. Un travail de déploiement de contenu échoue si un module linguistique requis est manquant dans la batterie de destination. Pour plus d’informations, voir Déployer des modules linguistiques (SharePoint Server 2010).
Si le serveur source contient du code personnalisé ou des packages de solutions SharePoint personnalisés, vous devez également déployer ces éléments sur le serveur de destination. Cela comprend tous les assemblys non inclus dans le fichier .wsp qui doivent être installés dans le Global Assembly Cache sur le serveur de destination.
Si certaines fonctionnalités sont installées sur le serveur source, vous devez les installer (sans les activer) sur le serveur de destination avant d’exécuter un travail qui déploie du contenu sur le serveur de destination. En général, le déploiement d’un package de solution doit entraîner l’installation de toutes les fonctionnalités sur le serveur de destination. Toutefois, si vous n’utilisez pas de fichiers .wsp, assurez-vous que toutes les fonctionnalités sont installées mais pas activées.
Durant le processus d’importation sur le serveur de destination, les fonctionnalités de collection de sites qui sont requises par des éléments inclus dans l’importation sont activées. Le travail de déploiement de contenu échoue si des fonctionnalités qu’il requiert ne sont pas installées sur le serveur de destination. Pour plus d’informations, voir « Problème 9 : des fonctionnalités utilisées dans la collection de sites sont manquantes sur le serveur d’exportation » dans Déploiement de contenu - Meilleures pratiques (éventuellement en anglais) (https://blogs.technet.com/b/stefan\_gossner/archive/2009/01/16/content-deployment-best-practices.aspx) (éventuellement en anglais).
2. Assurez-vous que le serveur de destination dispose d’un espace suffisant pour les fichiers CAB de l’importation
Le processus de déploiement de contenu exporte d’abord tout le contenu vers le système de fichiers sous forme de fichiers XML et binaires, puis il empaquète ces fichiers dans des fichiers CAB. Ces derniers sont ensuite envoyés sur le serveur de destination à l’aide d’HTTP POST, où ils sont extraits et importés. La taille maximale préconfigurée des fichiers CAB générés par le processus de déploiement de contenu est de 10 mégaoctets (Mo). Cependant, IIS 7,0 a une limite de téléchargement préconfigurée de 28 Mo. SharePoint Server 2010 ne fractionne pas les fichiers exportés en fichiers CAB multiples. Par conséquent, si un site SharePoint Server 2010 contient des fichiers qui ne peuvent pas être compressés à une taille inférieure à 10 Mo et que la taille du fichier CAB résultant dépasse la limite de téléchargement par défaut d’IIS 7,0 (28 Mo), le travail de déploiement de contenu échoue.
Si la taille des fichiers CAB d’un travail de déploiement de contenu sur le serveur est supérieure à 28 Mo, veillez à ajuster la taille de fichier autorisée sur le serveur de destination en modifiant le fichier Web.config du site Web d’Administration centrale. Pour cela, ajoutez une entrée semblable à la suivante :
<system.webServer>
<security>
<requestFiltering>
<requestLimits maxAllowedContentLength="52428800"/>
</requestFiltering>
</security>
</system.webServer>
La valeur de la propriété maxAllowedContentLength est un nombre, exprimé en octets, qui représente la taille maximale du fichier CAB à télécharger sur le serveur. Dans cet exemple, 52 428 800 correspond à 50 Mo. Vous devez ajuster cette valeur en fonction des besoins spécifiques de l’environnement de déploiement.
Pour plus d’informations, voir l’article 925083 de la Base de connaissances intitulé « Message d’erreur lorsque vous essayez de télécharger un grand fichier dans une bibliothèque de documents sur un site Windows SharePoint Services 3.0 : « Demande expirée » » (https://support.microsoft.com/kb/925083/fr-fr).
3. Assurez-vous que la valeur de la taille maximale de téléchargement sur l’application Web de destination est supérieure ou égale à celle des fichiers déployés
L’application Web qui héberge le site Web d’Administration centrale sur le serveur de destination est souvent créée avec des valeurs par défaut, ce qui signifie que la taille de téléchargement maximale est de 50 Mo. Si la collection de sites source contient des fichiers dont la taille dépasse la limite de téléchargement sur le serveur de destination, le travail de déploiement de contenu échoue.
Assurez-vous que la taille de téléchargement maximale de l’application Web qui héberge le site Web d’Administration centrale sur le serveur de destination est au moins égale au plus grand élément de la collection de sites source. Pour plus d’informations sur la façon de modifier la taille de téléchargement maximale pour une application Web, voir Configurer les paramètres d’une application Web (SharePoint Server 2010).
Notes
Bien que le travail de déploiement de contenu réussisse, il se peut que certaines parties du site ne soient pas déployées ; veillez par conséquent à examiner le rapport de déploiement de contenu pour voir s’il contient des avertissements ou des erreurs non fatales, même si l’état du travail est Réussi. Pour plus d’informations, voir Afficher l’historique et les rapports des travaux de déploiement de contenu.
4. Assurez-vous que les serveurs source et de destination disposent d’un espace disque suffisant pour stoker les fichiers utilisés au cours de l’importation et de l’exportation
Durant l’exportation, tous les fichiers à inclure dans le travail de déploiement de contenu sont stockés dans un répertoire temporaire sur la batterie du serveur d’exportation et sont compressés avant d’être envoyés vers le serveur de destination pour importation. De même, au cours de l’importation, les fichiers à importer dans la base de données sont stockés dans un répertoire temporaire sur la batterie de serveurs de destination. Par défaut, les fichiers compressés et non compressés sont placés dans des répertoires distincts. Assurez-vous que les emplacements des répertoires temporaires pour chaque batterie de serveurs disposent de suffisamment d’espace disque pour recevoir les fichiers inclus dans le travail de déploiement. Pour plus d’informations, voir « Fichiers temporaires » dans Déploiement de contenu - Guide complet - Partie 3 - Configuration (éventuellement en anglais) (https://blogs.technet.com/b/stefan\_gossner/archive/2009/11/02/content-deployment-the-complete-guide-part-3-configuration.aspx) (éventuellement en anglais).
5. Les serveurs d’exportation et d’importation doivent chacun héberger une instance du site Web d’Administration centrale
Lorsque vous configurez les paramètres de déploiement de contenu de votre batterie de serveurs, vous sélectionnez les serveurs de la batterie à désigner comme serveurs d’importation et d’exportation pour le déploiement du contenu. Le site Web d’Administration centrale doit être déployé sur chaque serveur d’exportation et d’importation. Si vous configurez un serveur d’exportation ou d’importation et qu’ultérieurement vous supprimez le site Web d’Administration centrale du serveur, aucun message ne s’affiche et la phase d’exportation ou d’importation du travail de déploiement de contenu ne démarre pas.
6. Déployez toujours un travail de déploiement de contenu initial dans une collection de sites vide
Si une collection de sites comprend déjà du contenu, le travail de déploiement initial du contenu risque d’échouer. Pour créer une collection de sites vide sur le serveur de destination, utilisez l’option < Sélectionner le modèle ultérieurement > sous l’onglet Personnalisé de la page Créer une collection de sites dans l’Administration centrale. Lors de la première exécution du travail de déploiement de contenu, le bon modèle et tous les paramètres de configuration associés sont appliqués au serveur de destination.
Notes
N’utilisez pas le modèle Site vide pour créer une collection de sites de destination. En effet, il ne crée pas une collection de sites vide et peut provoquer l’échec du travail de déploiement de contenu.
7. Si vous n’effectuerez que rarement des travaux de déploiement de contenu, ajustez la durée de conservation des modifications dans le journal des modifications
Par défaut, le journal des modifications est configuré pour conserver l’enregistrement de toutes les modifications effectuées pendant 60 jours. Si l’intervalle de temps entre deux travaux de déploiement incrémentiels dépasse cette durée (par exemple, 70 jours se sont écoulés depuis le dernier travail de déploiement de contenu), le journal des modifications ne contiendra pas d’entrées précédant le dernier jeton de modification. Si les travaux sont espacés de plus de 60 jours, modifiez le nombre de jours indiqués pour l’application Web dans l’Administration centrale. Pour plus d’informations sur la façon de modifier la durée de conservation des entrées dans le journal des modifications, voir Comprendre et configurer la limitation de ressource sur SharePoint Server 2010 (éventuellement en anglais) (https://technet.microsoft.com/fr-fr/magazine/gg491393.aspx).
8. N’exécutez pas de tâches de déploiement de contenu en parallèle si le même chemin d’accès est utilisé par les deux tâches
Les modifications effectuées par un travail peuvent entrer en conflit avec celles effectuées par un autre travail exécuté sur le même chemin simultanément. Si cela vient à se produire, le travail de déploiement de contenu peut échouer.
9. Exécutez les travaux de déploiement personnalisés et les travaux de déploiement de contenu planifiés à différents moments
Ne mélangez pas des travaux de déploiement de contenu planifiés et des travaux de déploiement de contenu personnalisés créés à l’aide de Windows PowerShell 2,0, de l’outil en ligne de commande Stsadm ou de code personnalisé. Si vous essayez d’exécuter ces deux types de travaux de déploiement de contenu simultanément, les travaux échouent.
10. Éduquez les utilisateurs avant d’activer les travaux Déploiement rapide
Un travail Déploiement rapide peut échouer si un auteur de page inclut des références à des sites, des listes ou autres éléments qui n’ont pas encore été déployés par un travail de déploiement ordinaire. Si vous prévoyez d’activer les travaux Déploiement rapide dans une batterie, assurez-vous que les utilisateurs comprennent bien le processus de déploiement de contenu ainsi que le calendrier et la portée des travaux de déploiement de contenu utilisés par votre organisation. Il peut également être judicieux de limiter le nombre d’utilisateurs membres du groupe Déploiement rapide. Pour plus d’informations sur les travaux Déploiement rapide, voir Déploiement de contenu - Guide complet - Partie 5 – Déploiement rapide (éventuellement en anglais) (https://blogs.technet.com/b/stefan\_gossner/archive/2009/11/04/content-deployment-the-complete-guide-part-5-quick-deployment.aspx) (éventuellement en anglais).
11. Ne modifiez pas directement le site de destination
Si vous devez déployer rapidement des modifications de contenu, ne modifiez pas directement le site de destination car il sera remplacé lors du déploiement de contenu suivant. Au lieu de cela, utilisez un travail Déploiement rapide pour mettre rapidement à jour le site. Pour plus d’informations, voir Gérer les travaux de déploiement rapide.
12. Utilisez des instantanés de base de données SQL Server sur le serveur d’exportation
L’option d’instantané de base de données SQL Server vous permet d’éliminer le risque que des utilisateurs modifient du contenu dans la base de données de contenu alors qu’un travail de déploiement de contenu est en cours d’exécution. Lorsque l’option d’instantanés de base de données est activée, un instantané de la base de données de contenu source est créé avant que ne démarre la phase d’exportation du travail de déploiement de contenu. Ce dernier utilise ensuite l’instantané de base de données pour effectuer l’exportation, au lieu d’exporter les données directement à partir de la base de données de contenu active. Une fois que l’exportation s’est correctement déroulée, l’instantané est supprimé. L’option d’instantané de base de données SQL Server est disponible uniquement si le serveur de bases de données exécute Microsoft SQL Server 2008 Enterprise.
13. Faites en sorte que le code soit compatible avec le déploiement de contenu
Il convient d’être prudent lorsque des packages de solutions déploient des fonctionnalités qui ajoutent des données à la base de données de contenu. Les données doivent être ajoutées à la base de données de contenu uniquement sur la batterie source. Le déploiement de contenu déplacera les données nécessaires du site source vers le site de destination durant le travail de déploiement. Pour éviter tout conflit lors de l’opération d’importation, assurez-vous que tous les récepteurs de fonctionnalités ou récepteurs d’événements personnalisés qui modifient du contenu de site sur le site de destination utilisent la classe SPImportContext. Celle-ci permet aux gestionnaires d’événements et au code d’activation de fonctionnalité de détecter s’ils s’exécutent dans le contexte d’une opération d’importation. De cette manière, les développeurs peuvent implémenter du code afin d’éviter les problèmes potentiels lors de la phase d’importation du déploiement de contenu. Par exemple, si un récepteur de fonctionnalité contient du code personnalisé qui ajoute un nouvel élément à une liste, le développeur doit s’assurer que l’algorithme du récepteur de fonctionnalité détecte s’il s’exécute dans le contexte d’une opération de déploiement de contenu et, si c’est le cas, qu’il ignore toute mise à jour des données si le rôle détecté est un site de destination. Durant l’importation, le nouveau récepteur de fonctionnalité d’élément de liste sera activé sur le site de destination. Si le récepteur de fonctionnalité ne détecte pas le rôle du site, il ajoutera le nouvel élément de contenu au site de destination. Le processus d’importation essaiera alors d’importer le même contenu à partir du site source, ce qui peut provoquer une erreur d’importation ou la présence de contenu dupliqué sur le site de destination. Les développeurs qui créent des récepteurs de fonctionnalités doivent avoir connaissance de cette limitation et rédiger du code approprié. Pour plus d’informations, voir Classe SPImportContext (éventuellement en anglais) (https://msdn.microsoft.com/fr-fr/library/microsoft.sharepoint.deployment.spimportcontext.aspx) (éventuellement en anglais) et Écrire du code d’activation de fonctionnalité et des gestionnaires d’événements compatibles avec le déploiement de contenu dans SP2010 (éventuellement en anglais) (https://blogs.technet.com/b/stefan\_gossner/archive/2010/05/25/write-content-deployment-aware-event-handlers-and-feature-activation-code-in-sp2010.aspx) (éventuellement en anglais).
Remerciements
L’équipe de publication de contenu SharePoint Server 2010 remercie les personnes suivantes ayant participé à la rédaction de cet article :
Ethan Gur-Esh, Microsoft Enterprise Content Management
Israel Vega, Jr., Microsoft Consulting Services
Josh Stickler, Microsoft Enterprise Content Management
Stefan Goβner, Microsoft SharePoint Escalation Services
Steve Walker, Microsoft SharePoint Customer Advisory Team