Installation von Assemblys im GAC

Jeder Computer verfügt über einen globalen Assemblycache (GAC), der die Assemblys enthält, die von einer oder mehreren Anwendungen auf diesem Computer verwendet werden. Damit Nachrichten während der Laufzeit durch BizTalk Server verarbeitet werden können, müssen die in einer BizTalk-Anwendung enthaltenen Assemblys im GAC des Computers vorhanden sein, auf dem die Anwendung ausgeführt wird.

Wenn die betreffende Anwendung auf einem Server isoliert ist, müssen die Assemblys nur im GAC dieses Servers vorliegen. Wenn die Anwendung jedoch von mehreren Servern gehostet wird, müssen die Assemblys dieser Anwendung in den GACs sämtlicher Computer vorliegen, die Zugriff auf die Elemente in dieser Assembly benötigen. Wenn Sie beispielsweise Assembly_A für Server_1 bereitstellen und dann Assembly_A auf einem Host auf Server_2 eintragen, müssen Assembly_A im GAC auf Server_2 installiert sein. Andernfalls kann Server_2 während der Laufzeit nicht auf Assembly_A zugreifen.

Insbesondere Assemblys, die Orchestrierungen enthalten, sowie sämtliche Assemblys, von denen diese abhängig sind, müssen immer im GAC der Server installiert sein, auf denen Instanzen des Hosts ausgeführt werden, an die die Orchestrierung gebunden ist. Darüber hinaus müssen Assemblys, die die von einem Port verwendeten Zuordnungen und Pipelines enthalten, auf Servern installiert sein, auf denen Instanzen des dem Port als Adapterhandler dienenden Hosts ausgeführt werden.

Wenn Sie die Assembly über Visual Studio bereitstellen, können Sie für jede Assembly eine Bereitstellungsoption angeben, um sie im GAC zu installieren. Sie können eine Assembly auch manuell im GAC installieren. Darüber hinaus können Sie Bereitstellungsoptionen festlegen, um die Assembly im GAC zu installieren, nachdem sie in einer BizTalk-Anwendung bereitgestellt wurde.

Im Folgenden werden die Tools und Methoden zusammengefasst, die zum Installieren einer Assembly im GAC zur Verfügung stehen:

• Microsoft Visual Studio. Wie bereits erwähnt, können Sie Projekteigenschaften so festlegen, dass Assemblys automatisch im GAC installiert werden, wenn Sie sie bereitstellen, wie unter Festlegen von Bereitstellungseigenschaften in Visual Studio beschrieben. Sie können Assemblys auch manuell im GAC installieren, indem Sie das in Visual Studio enthaltene Befehlszeilentool Gacutil verwenden, wie unter Installieren einer Assembly im GAC beschrieben.

• Das Befehlszeilenprogramm "BTSTask". Wenn Sie einer BizTalk-Anwendung mithilfe von BTSTask eine Assembly hinzufügen, können Sie festlegen, dass die Assembly im GAC installiert wird, während die zugehörige Anwendung importiert oder installiert wird. Weitere Informationen finden Sie unter AddResource-Befehl: BizTalk Assembly. Weitere Informationen finden Sie unter AddResource-Befehl: .NET Assembly.

• BizTalk Server-Verwaltungskonsole. Ähnlich wie bei BTSTask können Sie beim Hinzufügen einer Assembly zu einer Anwendung über die Verwaltungskonsole festlegen, dass eine Assembly im GAC installiert wird, wenn die zugehörige Datei importiert oder installiert wird. Weitere Informationen finden Sie unter Hinzufügen einer BizTalk-Assembly zu einer Anwendung. Weitere Informationen finden Sie unter Hinzufügen einer .NET-Assembly zu einer Anwendung.

  Darüber hinaus können Sie Bereitstellungsoptionen jederzeit konfigurieren, nachdem eine Assembly in einer Anwendung bereitgestellt oder hinzugefügt wurde, wie unter Ändern der Bereitstellungsoptionen einer BizTalk-Assembly beschrieben. Wenn Assemblys zum ersten Mal aus Visual Studio in einer Anwendung bereitgestellt werden, werden die Bereitstellungsoptionen in der Verwaltungskonsole wie folgt festgelegt: GAC bei der Installation ist aktiviert, und GAC beim Import ist deaktiviert. Wenn Sie Änderungen an diesen Einstellungen vornehmen, sind Ihre Änderungen weiterhin wirksam, wenn die Assembly von Visual Studio erneut bereitgestellt wird.

• Drag & Drop. Mithilfe von Windows Explorer können Sie die Assemblydatei in den <Windows-Ordner>\assembly ziehen und ablegen.

• Andere Methoden. Zum Installieren einer Assembly im GAC stehen noch weitere Tools und Methoden zur Verfügung, darunter Windows Installer oder Tools von Drittanbietern.

Wichtig

Damit die Anwendung ordnungsgemäß funktioniert, müssen Sie sicherstellen, dass die Assemblys in der BizTalk-Verwaltungsdatenbank und dem GAC dieselbe Version aufweisen. Wenn Sie Assemblys nicht bei jeder Bereitstellung auch im GAC installieren, liegen im GAC und in der BizTalk-Verwaltungsdatenbank möglicherweise unterschiedliche Versionen vor, die während der Laufzeit zu Verarbeitungsfehlern führen können.

Wichtig

Informationen zur Versionsnummerierung finden Sie unter "Assemblyversionsverwaltung" in der .NET Framework Hilfe von Microsoft Visual Studio. Beachten Sie, dass die Verwendung von .NET-Richtliniendateien von BizTalk Server nicht unterstützt wird.

Weitere Informationen

Bereitstellen von BizTalk-Assemblys aus Visual Studio in einer BizTalk-Anwendung
Grundlegendes zur Bereitstellung und Verwaltung von BizTalk-Anwendungen