Importieren einer BizTalk-Anwendung

Artikel
05/04/2023

In diesem Thema wird beschrieben, wie Sie eine Anwendung mithilfe der BizTalk Server-Verwaltungskonsole oder der Befehlszeile exportieren. Beim Exportieren einer BizTalk-Anwendung wird eine Windows Installer-Datei (MSI-Datei) erzeugt, die neben der Anwendung auch alle Elemente dieser Anwendung enthält, die Sie für den Export auswählen. Die Standardoption sieht vor, dass Sie alle Elemente der Anwendung auswählen, Sie haben jedoch auch die Möglichkeit, nur eine Untergruppe auszuwählen. Die MSI-Datei können Sie anschließend in eine andere BizTalk-Gruppe importieren, um die Elemente einer vorhandenen Anwendung in der neuen Gruppe hinzuzufügen, die Elemente in einer vorhandenen Anwendung zu aktualisieren, oder eine neue Anwendung in der Gruppe zu erstellen, die die importierten Elemente enthält. Weitere Informationen finden Sie unter Importieren einer BizTalk-Anwendung. Sie verwenden auch die .msi-Datei, um die Anwendung auf den Computern zu installieren, auf denen sie ausgeführt wird, wie unter Installieren einer BizTalk-Anwendung beschrieben. Wenn die Anwendung dateibasierte Elemente enthält, müssen Sie sie zunächst installieren. Andernfalls ist sie nicht funktionsfähig.

Beachten Sie beim Exportieren einer Anwendung die folgenden wichtigen Punkte:

Vorhandene Bindungen werden durch importierte Bindungen automatisch überschrieben. Wenn Sie nicht möchten, dass die Bindungen in der von Ihnen exportierten Anwendung die Bindungen in einer Anwendung, in die Sie eine MSI-Datei importieren, überschreiben, sollten Sie die Bindungsdatei nicht als zu exportierende Ressource auswählen. Wenn Sie eine MSI-Datei mit einer Bindung in eine vorhandene Anwendung importieren, werden die vorhandenen Bindungen von den importierten Bindungen überschrieben. Dies trifft auch dann zu, wenn Sie die Option zum Überschreiben vorhandener Elemente nicht aktiviert haben.
Möglicherweise nimmt ein Benutzer Änderungen an einem Element vor, während Sie die Anwendung exportieren. Wenn ein Benutzer ein datenbankbasiertes Element (z. B. ein virtuelles Verzeichnis, ein Zertifikat oder eine Richtlinie) während eines Exportvorgangs ändert, werden die Änderungen nicht in die exportierte MSI-Datei übernommen. Daher sollten Sie für die Ausführung von Exportvorgängen einen Zeitpunkt wählen, zu dem Benutzer wahrscheinlich keine Änderungen an diesen Elementen vornehmen.
Bei der Installation eines .msi unter Windows Vista kann ein falscher Fehler angezeigt werden. Wenn Sie ein .msi Paket installieren, das mithilfe von BizTalk Server exportiert wird, erhalten Sie möglicherweise die folgende falsche Fehlermeldung: "Beim Installationsprogramm ist ein unerwarteter Fehler beim Installieren dieses Pakets aufgetreten. Dies weist auf ein Problem mit diesem Paket hin. Der Fehlercode ist 2869." Um diesen Fehler zu beheben, importieren Sie zuerst das .msi-Paket mithilfe von BizTalk Server, und exportieren Sie das Paket dann erneut, und installieren Sie es.
Die Anwendung kann von einer anderen Anwendung abhängig sein. Dies kann sich auf die Bereitstellung der Anwendung auswirken. Weitere Informationen finden Sie unter Abhängigkeiten und Anwendungsbereitstellung.
Vor dem Export können Sie das Zielverzeichnis von Ressourcen in Ihrer Anwendung ändern. Wenn Sie den Zielspeicherort ändern möchten, erweitern Sie den Ressourcenknoten Ihrer Anwendung, klicken Sie mit der rechten Maustaste auf die Ressource, die Sie ändern möchten, und wählen Sie dann Ändern aus. Geben Sie im Dialogfeld Ressourcen ändern unter Zielspeicherort einen neuen Speicherort ein.
Wenn die Anwendung eine Richtlinie enthält, die aus der Regel-Engine-Datenbank entfernt wurde, schlägt der Export fehl. Wenn Sie mithilfe des Assistenten zum Bereitstellen der Regel-Engine eine Richtlinie aus der Regel-Engine-Datenbank entfernen, wird diese Richtlinie in der Verwaltungskonsole mit dem Status „Nicht veröffentlicht“ angezeigt, und Sie können die Anwendung nicht exportieren. Weitere Informationen zum Regel-Engine-Bereitstellungs-Assistenten finden Sie unter Bereitstellen und Aufheben der Bereitstellung von Richtlinien und Vokabularen.

Wichtig

Die MSI-Datei kann vertrauliche Daten enthalten. Ergreifen Sie unbedingt Maßnahmen zur Gewährleistung der Sicherheit der Datei. Weitere Informationen finden Sie unter Sicherheit und Windows Installer.

Beim Anwendungsexport werden Kennwörter aus Anwendungsbindungen entfernt. Nachdem Sie die Anwendung aus der .msi-Datei installiert haben, müssen Sie die Kennwörter neu konfigurieren, damit die Anwendung funktioniert. Aus Bindungsdateien, die Sie der Anwendung hinzugefügt haben, werden Kennwörter jedoch nicht entfernt.

Wenn die Anwendung eine Website oder eine Orchestrierung enthält, die einen Webdienst verwendet, müssen Sie beachten, dass die Sicherheitseinstellungen im virtuellen Verzeichnis den Einstellungen entsprechen, die beim Generieren der MSI-Datei während des Anwendungsexports wirksam sind. Wenn Sie eine Anwendung in einer Produktionsumgebung bereitstellen, sollten Sie vor dem Exportieren der Anwendung überprüfen, ob die Einstellungen Ihre Sicherheitsanforderungen erfüllen. Ist das virtuelle Verzeichnis bereits auf dem Hostcomputer vorhanden, werden seine Sicherheitseinstellungen nicht überschrieben, die Dateien in der Anwendung werden ihm jedoch hinzugefügt. Nach dem Import der Anwendung sollten Sie die Sicherheitseinstellungen überprüfen.

Beim Export einer Anwendung werden alle freigegebenen Zugriffssteuerungslisten (DACLs) aus Dateien und Ordnern entfernt. Nach der Installation einer Anwendung müssen Sie alle Sicherheitseinstellungen in den Dateien und Ordnern (einschließlich der virtuellen Verzeichnisse) neu konfigurieren.

Hinweis

Wenn ein Exportvorgang fehlschlägt, löscht BizTalk Server alle temporären Dateien zusammen mit der MSI-Datei (falls erstellt).

Voraussetzungen

Zum Durchführen der Schritte in diesem Thema müssen Sie mit einem Konto angemeldet sein, das Mitglied der Gruppe BizTalk Server-Administratoren ist. Ausführlichere Informationen zu Berechtigungen finden Sie unter Erforderliche Berechtigungen für das Bereitstellen und Verwalten einer BizTalk-Anwendung. Außerdem muss die Geschäftsregel-Engine installiert sein. Weitere Informationen finden Sie unter Installieren BizTalk Server.

Exportieren einer App mithilfe der BizTalk Server-Verwaltung

Klicken Sie auf Start, dann auf Alle Programme, Microsoft BizTalk Server 20xx, und klicken Sie dann auf BizTalk Server Verwaltung.
Erweitern Sie in der Konsolenstruktur BizTalk Server Verwaltung, die Gruppe BizTalk und dann Anwendungen.
Klicken Sie mit der rechten Maustaste auf die Anwendung, die Sie exportieren möchten, zeigen Sie auf Exportieren, und klicken Sie dann auf MSI-Datei.
Klicken Sie auf der Seite Willkommen beim Assistenten zum Exportieren von MSI-Dateien auf Weiter.
Wählen Sie auf der Seite Ressourcen auswählen die Artefakte aus, die in die .msi datei exportiert werden sollen, und klicken Sie dann auf Weiter.
Wenn Sie dazu aufgefordert werden, geben Sie auf der Seite IIS-Hosts angeben den Servernamen des Computers ein, auf dem das virtuelle Verzeichnis gehostet wird, das Sie einschließen möchten, und klicken Sie dann auf Weiter. Sie werden nur dann zur Angabe des Servers aufgefordert, wenn das virtuelle Verzeichnis nicht bereits der BizTalk-Verwaltungsdatenbank hinzugefügt wurde, z. B. wenn es der Anwendung hinzugefügt oder in eine Anwendung importiert wurde.
Überprüfen Sie auf der Seite Abhängigkeiten die Abhängigkeiten für die Anwendung, und klicken Sie dann auf Weiter.
Geben Sie auf der Seite Ziel unter Name der Zielanwendung den Anwendungsnamen ein.
Geben Sie in der zu generierenden MSI-Datei den vollständigen Pfad für die .msi-Datei ein, und klicken Sie dann auf Exportieren. Beispiel: C:\MSI\Errorhandling.msi

Hinweis

Es wird empfohlen, MSI-Dateien in einem sicheren Ordner zu speichern.
Notieren Sie sich auf der Seite Zusammenfassung den Speicherort der Protokolldatei für diesen Vorgang, und klicken Sie dann auf Fertig stellen.

Exportieren einer App über die Befehlszeile

Öffnen Sie eine Eingabeaufforderung wie folgt: Klicken Sie auf Start, klicken Sie auf Ausführen, geben Sie ein cmd, und klicken Sie dann auf OK.

Geben Sie den folgenden Befehl ein, und ersetzen Sie dabei die entsprechenden Werte, wie in der folgenden Tabelle beschrieben:

BTSTask ExportApp [/ApplicationName:value] /Package:value [ResourceSpec:value [/Server:value] [/Database:value]

Hinweis

Auf einem System, das Unterstützung für die Benutzerkontensteuerung (User Account Control, UAC) bietet, müssen Sie das Tool möglicherweise mit Administratorrechten ausführen.

Beispiel:

BTSTask ExportApp /ApplicationName:MyApplication /Package:C:/MSI/MyApplication.msi /ResourceSpec:"C:\My Files\ResourceSpec.xml" /Server:MySQLServer /Database:BizTalkMgmtDb

Die von Ihnen angegebenen Elemente werden in eine MSI-Datei am von Ihnen festgelegten Speicherort exportiert.

Parameter	Wert
/Applicationname	Der Name der zu exportierenden BizTalk-Anwendung. Wenn der Anwendungsname nicht angegeben wurde, wird die BizTalk-Standardanwendung verwendet. Wenn der Name Leerzeichen enthält, muss er in doppelte Anführungszeichen (") eingeschlossen werden.
/Paket	Pfad der zu erstellenden MSI-Datei, einschließlich des Dateinamens.
/ResourceSpec	Pfad der XML-Ressourcenspezifikationsdatei, einschließlich des Dateinamens. Sie können angeben, welche Artefakte exportiert werden sollen, indem Sie die XML-Datei der Ressourcenspezifikation bearbeiten, die erstellt wird, wenn Sie den ListApp-Befehl mit dem ResourceSpec-Parameter ausführen, wie unter ListApp-Befehl beschrieben. Sie müssen diese Datei manuell bearbeiten, um den Namen des IIS-Hostservers für ein virtuelles Verzeichnis hinzuzufügen, das Sie exportieren möchten, wenn sich der Webserver auf einem Remotecomputer befindet.
/Server	Der Name der SQL Server-Instanz, die als Host für die BizTalk-Verwaltungsdatenbank dient, im Format Servername\Instanzname,Port. Der Instanzname ist nur erforderlich, wenn sich der Instanzname vom Servernamen unterscheidet. Der Port ist nur erforderlich, wenn in SQL Server eine andere Portnummer als der Standardwert 1433 verwendet wird. Beispiele: Server=MyServer Server=MyServer\MySQLServer,1533 Bei fehlender Angabe wird der Name der SQL Server-Instanz verwendet, die auf dem lokalen Computer ausgeführt wird.
/Datenbank	Der Name der BizTalk-Verwaltungsdatenbank. Bei fehlender Angabe wird die BizTalk-Verwaltungsdatenbank verwendet, die in der lokalen Instanz von SQL Server ausgeführt wird.

Weitere Informationen

Exportieren von BizTalk-Anwendungen, -Bindungen und -Richtlinien
Befehl „ExportApp“