Installation et déploiement d'une solution de batterie de serveurs

Dernière modification : mercredi 3 août 2011

S’applique à : SharePoint Foundation 2010

Dans cet article
Principales étapes d'installation d'une solution de batterie de serveurs
Magasin de solutions de batterie de serveurs
Détails de l'étape du déploiement
Annulation d'un travail de déploiement
Échecs des installations

L'installation d'une solution de batterie de serveurs dans Microsoft SharePoint Foundation est un système qui permet aux développeurs d'empaqueter des solutions de batterie de serveurs personnalisées et aux administrateurs de les déployer de façon directe, sécurisée et homogène. L'installation fait plus particulièrement référence au processus de téléchargement et de décompression de packages de solutions (fichiers .wsp) sur les serveurs Web frontaux, puis de déploiement du contenu.

Principales étapes d'installation d'une solution de batterie de serveurs

Il existe deux ou trois étapes principales à l'installation d'une solution de batterie de serveurs :

  1. Ajout : un package de solution est ajouté par un administrateur de la batterie de serveurs au magasin de solutions de cette batterie de serveurs, qui se trouve dans sa base de données de configuration. Cette opération s'effectue à l'aide du SharePoint Management Shell (ou du modèle objet). Il n'est pas possible de l'effectuer dans l'Administration centrale.

  2. Déploiement : le package de solution est décompressé et ses éléments sont copiées à leurs emplacements appropriés.

    Cette étape requiert également un administrateur de la batterie de serveurs et peut s'effectuer à l'aide de l'Administration centrale, du SharePoint Management Shell ou du modèle objet. Exemples de la manière de déployer certains éléments : les fichiers de contrôle utilisateur (.ascx) sont copiés dans %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\ControlTemplates ou un sous-dossier et les assemblys sont déployés dans le Global Assembly Cache ou dans le dossier \bin d'une application Web. S'il existe des fonctionnalités dans la solution de batterie de serveurs, ils sont copiés lors de cette étape dans un sous-dossier de %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES et installés dans la galerie de fonctionnalités de la batterie de serveurs, de l'application Web, de la collection de sites ou du site Web, en fonction de l'étendue de la fonctionnalité.

    Les administrateurs n'ont pas besoin de déployer une solution immédiatement après l'avoir ajouté au magasin de solutions. Celle-ci peut être enregistrée indéfiniment dans un état non déployé.

  3. Activation des fonctionnalités : les fonctionnalités doivent être déployées pour pouvoir être utilisées ; leur activation constitue donc une troisième étape d'installation pour les solutions qui en contiennent. Les fonctionnalités peuvent contenir des types de contenu, des contrôles, des actions personnalisées, des champs personnalisés, des fichiers, des flux de travail, des instances de listes, des modèles de listes, des récepteurs d'événements et des convertisseurs de documents ; bien qu'il ne soit pas possible d'inclure certains de ces derniers dans certaines étendues.

Notes

SharePoint Foundation n'est pas cohérent dans sa terminologie liée à l'installation et à la désinstallation des solutions de batterie de serveurs. Les termes Ajout, Déploiement et Activation sont les plus couramment utilisés pour se référer aux trois étapes d'installation, mais en fonction de l'outil utilisé pour effectuer une étape, la terminologie peut varier. La deuxième étape, par exemple, est appelée déploiement dans l'Administration centrale, mais installation dans SharePoint Management Shell. Il existe une incohérence similaire dans les termes utilisés pour les étapes d'inversion, mais en principe, l'inversion de la deuxième étape est appelée retrait (alors qu'elle est appelée désintallation dans SharePoint Management Shell) et l'inversion de la première étape est appelée suppression. La troisième étape, qui s'applique uniquement aux fonctionnalités, est toujours désignée par activation et son inversion s'appelle toujours désactivation.

Magasin de solutions de batterie de serveurs

Le magasin de solutions de batterie de serveurs est une table dans la base de données de configuration de SharePoint Foundation qui contient des packages de solution.

Les administrateurs peuvent ajouter des solutions de batterie de serveurs au magasin de solutions de batterie de serveurs, en procédant de l'une des deux façons suivantes :

  • Ligne de commande : un administrateur peut ajouter et supprimer des fichiers de solution dans le magasin de solutions de batterie de serveurs en utilisant SharePoint Management Shell. Pour plus d'informations, voir Applets de commande pour les fonctionnalités et les solutions (SharePoint Server 2010).

  • Modèle objet : lorsque vous ajoutez une solution de batterie de serveurs au magasin, le contenu du fichier de solution est contrôlé par rapport à un fichier .xsd, afin de vérifier si les fichiers qu'il contient sont conformes aux schémas de SharePoint Foundation. Si la vérification échoue, un message d'erreur est renvoyé. Si la vérification aboutit, le processus d'ajout de la solution de batterie de serveurs se poursuit.

    Notes

    Il est possible de déployer une solution sur un seul serveur, même en cas de batterie de serveurs multiserveur, à l'aide la propriété DeployLocal. Cette opération doit être effectuée provisoirement en tant qu'étape de résolution des problèmes. Dans tous les autres cas, les serveurs Web frontaux doivent être configurés de manière identique.

Détails de l'étape du déploiement

L'étape du déploiement d'une solution de batterie de serveurs crée un travail de minuteur. Ce travail de minuteur est utilisé par le service de minuterie sur chaque serveur Web de la batterie de serveurs. Le travail de minuteur utilise également le service Web d'administration de SharePoint Foundation pour accéder aux privilèges requis permettant de déployer des fichiers de solution sur chaque ordinateur, par conséquent, les deux services doivent s'exécuter sur tous les serveurs pour que le déploiement soit réussi.

Au départ, le manifeste du package est analysé pour rechercher les assemblys, les pages d'application, les fichiers ECMAScript et autres qui ne font pas partie d'une fonctionnalité. Ces fichiers sont copiés aux emplacements appropriés spécifiés dans le manifeste. Tous les fichiers contenus dans une fonctionnalité sont copiés dans le répertoire des fonctionnalités, un sous-répertoire de %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES. Une fois les fichiers de solutions copiés sur les ordinateurs cibles, une réinitialisation de la configuration est planifiée pour l'ensemble des serveurs Web frontaux ; la réinitialisation entraîne le déploiement des fichiers et le redémarrage de Microsoft Internet Information Services (IIS). Les administrateurs de batterie de serveurs peuvent spécifier le moment où se produit cette opération.

Enfin, les fonctionnalités de la solution de batterie de serveurs sont enregistrées et les fichiers de schéma et de définition sont validés dans le magasin de configurations.

Les administrateurs de batterie de serveurs peuvent choisir de déployer une solution sur seulement quelques applications Web de la batterie de serveurs.

Annulation d'un travail de déploiement

Si l'étape du déploiement se trouve dans sa phase de configuration initiale et si le travail de minuterie de déploiement n'a pas encore été exécuté sur les cibles de déploiement, alors le travail de déploiement peut être annulé. Dans ce cas, le travail de minuterie est supprimé.

Toutefois, une fois qu'un travail de minuterie de déploiement commence à être exécuté sur un ordinateur cible, le travail de minuterie de déploiement ne peut plus être annulé.

Échecs des installations

Au cours de l'installation sur les serveurs Web frontaux, les problèmes suivants peuvent se produire :

  • Si le service de minuterie n’est pas activé sur le serveur Web frontal, le travail de déploiement reste arrêté. Dans la page des travaux en attente dans l’interface utilisateur, le travail apparaît en attente mais non traité. L’administrateur doit intervenir sur le service de minuterie ou annuler le travail de déploiement.

  • Si le service d'administration de SharePoint Foundation n'est pas activé sur un ordinateur en particulier, un code d'erreur est défini dans l'objet SPRunningJob pour marquer l'étape comme ayant échoué et empêcher d'autres opérations. Le déploiement qui a échoué est converti en alerte d'administration pour signaler à l'administrateur que le travail a échoué car aucun service Web d'administration SharePoint Foundation n'était en cours d'exécution.

  • Si l'extraction d'un package de solution (.wsp) échoue sur un serveur en particulier, l'étape est marquée comme ayant échoué et le traitement est interrompu. « Erreur » apparaît en rouge dans le champ Statut de la solution dans la page Gestion des solutions de l'Administration centrale.

  • Si la copie d'un ou de plusieurs fichiers échoue, par exemple, si un fichier existant est marqué en lecture seule, alors l'étape est marquée comme ayant échoué et le traitement est interrompu.

  • Si le code de la phase de déploiement provoque une exception, une alerte d'administration est créée avec l'exception et le déploiement s'arrête. Les définitions des travaux sous-jacents sont supprimées.

  • Si une erreur externe se produit (par exemple, une coupure de courant), le déploiement final s'arrête, mais peut ensuite être réexécuté.

Voir aussi

Concepts

Désinstallation et retrait d’une solution de batterie de serveurs

Mise à niveau à partir d’une solution de batterie