Installation de l’assembly dans le GAC

  • Article

Chaque ordinateur dispose d'un GAC (Global Assembly Cache), qui contient les assemblys qu'une ou plusieurs applications de cet ordinateur partagent. Pour que BizTalk Server puisse traiter les messages lors de l'exécution, les assemblys inclus dans une application BizTalk doivent figurer dans les GAC des ordinateurs exécutant l'application.

Si votre application est présente sur un seul serveur, les assemblys ne doivent figurer que dans le GAC de ce serveur. En revanche, si elle est hébergée par plusieurs serveurs, les assemblys de cette application doivent exister dans le GAC de chacun des ordinateurs nécessitant un accès aux artefacts contenus dans les assemblys. Par exemple, si vous déployez Assembly_A sur Server_1, puis que vous inscrivez Assembly_A dans un hôte sur Server_2, Assembly_A devez être installé dans le GAC sur Server_2. Si ce n’est pas le cas, Server_2 ne pourrez pas accéder à Assembly_A pendant l’exécution.

Plus précisément, les assemblys contenant des orchestrations et tout assembly associé doivent toujours être installés dans le GAC des serveurs sur lesquels sont exécutées les instances de l'hôte auquel est liée l'orchestration. En outre, les assemblys contenant les mappages et pipelines utilisés par un port doivent figurer sur les serveurs exécutant les instances de l'hôte faisant office de gestionnaire d'adaptateur pour ce port.

Vous avez la possibilité de spécifier une option de déploiement pour chaque assembly afin que ce dernier soit installé dans le GAC lors du déploiement de l'assembly depuis Visual Studio. Vous pouvez également installer un assembly manuellement. En outre, vous pouvez spécifier que l'assembly soit installé dans le GAC après son déploiement dans une application BizTalk.

Voici un récapitulatif des outils et méthodes permettant d'installer un assembly dans le GAC :

  • Microsoft Visual Studio. Comme mentionné précédemment, vous pouvez définir des propriétés de projet pour installer automatiquement des assemblys dans le GAC lorsque vous les déployez, comme décrit dans Comment définir les propriétés de déploiement dans Visual Studio. Vous pouvez également installer manuellement des assemblys dans le GAC à l’aide de l’outil en ligne de commande Gacutil inclus dans Visual Studio, comme décrit dans Comment installer un assembly dans le GAC.

  • Outil de ligne de commande BTSTask : lorsque vous ajoutez un assembly à une application BizTalk à l'aide de l'outil BTSTask, vous pouvez spécifier que l'assembly soit installé dans le GAC lors de l'importation ou de l'installation de l'application le contenant. Pour plus d’informations, consultez Commande AddResource : Assembly BizTalk. Consultez également Commande AddResource : .NET Assembly.

  • Console Administration de BizTalk : à l'instar de l'outil BTSTask, lorsque vous ajoutez un assembly à une application à l'aide de la console Administration, vous pouvez spécifier que l'assembly soit installé dans le GAC lors de l'importation ou de l'installation de l'application le contenant. Pour plus d’informations, consultez Ajout d’un assembly BizTalk à une application. Consultez également Comment ajouter un assembly .NET à une application.

    En outre, vous pouvez configurer les options de déploiement à tout moment une fois qu’un assembly a été déployé ou ajouté à une application, comme décrit dans Comment modifier les options de déploiement d’un assembly BizTalk. Lorsque les assemblys sont déployés dans une application à partir de Visual Studio pour la première fois, les options de déploiement dans la console Administration sont définies comme suit : GAC lors de l’installation est activé et GAC lors de l’importation est désactivé. Si vous apportez des modifications à ces paramètres, vos modifications seront toujours en vigueur si l’assembly est redéployé à partir de Visual Studio.

  • Glisser-déplacer. À l’aide de Windows Explorer, vous pouvez glisser-déplacer le fichier d’assembly dans le <dossier> Windows\assembly.

  • Autres méthodes : il existe d'autres méthodes et outils permettant d'installer un assembly dans le GAC, notamment le programme d'installation Windows ou les outils créés par des fournisseurs tiers.

Important

Afin de garantir un bon fonctionnement de votre application, assurez-vous que les versions des assemblys contenues dans la base de données de gestion BizTalk sont les mêmes que celles du GAC. Si un assembly ne fait pas l'objet d'une installation systématique dans le GAC lors de son déploiement, il se peut que les versions contenues dans le GAC et dans la base de données de gestion BizTalk diffèrent, avec comme conséquence la génération d'erreurs lors de l'exécution.

Important

Pour plus d’informations sur la numérotation des versions, consultez « Contrôle de version d’assembly » dans l’aide de .NET Framework disponible à partir de Microsoft Visual Studio. Notez que l’utilisation des fichiers de stratégie .NET n’est pas prise en charge par BizTalk Server.

Voir aussi

Déploiement des assemblys BizTalk à partir de Visual Studio dans une application BizTalk
Présentation de la gestion et du déploiement d’une application BizTalk