Instalación de ensamblado en la GAC

Todos los equipos tienen una caché de ensamblados global (GAC) que contiene los ensamblados que una o varias aplicaciones del equipo usan. Para que BizTalk Server procese mensajes durante el tiempo de ejecución, los ensamblados incluidos en una aplicación de BizTalk deben estar presente en las GAC de los equipos que ejecutan la aplicación.

Si la aplicación se encuentra aislada en un servidor, solo será necesario que haya ensamblados en la GAC de ese servidor. En cambio, cuando hay varios servidores que alojan la aplicación, los ensamblados de esa aplicación deben existir en la GAC de cada equipo que necesite obtener acceso a los artefactos que el ensamblado contiene. Por ejemplo, si implementa Assembly_A en Server_1 y, a continuación, inscribe Assembly_A en un host en Server_2, Assembly_A debe instalarse en la GAC en Server_2. Si no es así, Server_2 no podrá acceder a Assembly_A durante el tiempo de ejecución.

En concreto, los ensamblados que contienen orquestaciones y ensamblados de los que dependen siempre deben estar instalados en la GAC de los servidores que ejecutan instancias del host al que la orquestación está enlazada. Además, los ensamblados que contienen las asignaciones y las canalizaciones que un puerto usa deben estar instalados en los servidores que ejecutan instancias del host que hace de controlador de adaptador para el puerto.

Puede especificar una opción de implementación para cada ensamblado con el fin de instalarlo en la GAC cuando implemente el ensamblado desde Visual Studio. De forma alternativa, puede instalar ensamblados en la GAC de forma manual. Además, puede especificar opciones de implementación para instalar el ensamblado en la GAC después de que se implemente en una aplicación de BizTalk.

A continuación, se resumen las herramientas y los métodos disponibles para instalar ensamblados en la GAC:

  • Microsoft Visual Studio. Como se mencionó anteriormente, puede establecer las propiedades del proyecto para instalar ensamblados en la GAC automáticamente al implementarlos, como se describe en Cómo establecer propiedades de implementación en Visual Studio. También puede instalar manualmente ensamblados en la GAC mediante la herramienta de línea de comandos Gacutil incluida con Visual Studio, como se describe en Instalación de un ensamblado en la GAC.

  • Herramienta de la línea de comandos BTSTask. Cuando se agrega un ensamblado a una aplicación de BizTalk mediante BTSTask, puede especificar las opciones para instalar el ensamblado en la GAC cuando se importa o instala la aplicación que contiene. Para obtener más información, vea AddResource Command: BizTalk Assembly. Consulte también AddResource Command: .NET Assembly.

  • Consola de administración de servidor BizTalk Server. De la misma manera que con BTSTask, cuando se agrega un ensamblado a una aplicación mediante la consola de administración, puede especificar las opciones para instalar un ensamblado en la GAC cuando se importa o instala la aplicación que contiene. Para obtener más información, vea Cómo agregar un ensamblado de BizTalk a una aplicación. Consulte también How to Add a .NET Assembly to an Application (Cómo agregar un ensamblado de .NET a una aplicación).

    Además, puede configurar opciones de implementación en cualquier momento después de implementar o agregar un ensamblado a una aplicación, como se describe en Cómo modificar las opciones de implementación de un ensamblado de BizTalk. Cuando los ensamblados se implementan en una aplicación desde Visual Studio por primera vez, las opciones de implementación en la consola de administración se establecen de la siguiente manera: GAC en la instalación está habilitada y GAC en la importación está deshabilitada. Si realiza cambios en esta configuración, los cambios seguirán en vigor si el ensamblado se vuelve a implementar desde Visual Studio.

  • Arrastrar y colocar. Con el Explorador de Windows, puede arrastrar y colocar el archivo de ensamblado en la <carpeta>\ensamblado de Windows.

  • Otros métodos. Existen otras herramientas y métodos, como el instalador de Windows o herramientas de otros proveedores, que se pueden usar para instalar un ensamblado en la GAC.

Importante

Para que la aplicación funcione correctamente, asegúrese de que las versiones de los ensamblados son las mismas en la base de datos de administración de BizTalk y en la GAC. Si sigue el procedimiento de no instalar siempre un ensamblado en la GAC cuando lo implementa, es posible que tenga diferentes versiones en la GAC y en la base de datos de administración de BizTalk, hecho que producirá errores de procesamiento durante el tiempo de ejecución.

Importante

Para obtener información sobre la numeración de versiones, vea "Control de versiones de ensamblado" en la ayuda de .NET Framework disponible en Microsoft Visual Studio. Tenga en cuenta que el uso de archivos de directiva de .NET no es compatible con BizTalk Server.

Consulte también

Implementación de ensamblados de BizTalk en una aplicación de BizTalk desde Visual Studio
Descripción de la implementación y administración de aplicaciones de BizTalk