Freigeben über

Installieren einer BizTalk-Anwendung

  • Artikel

In diesem Thema wird beschrieben, wie Sie eine Anwendung auf dem lokalen Computer installieren, indem Sie in der Windows-Oberfläche auf die Windows Installer-Datei (MSI-Datei) für die Anwendung doppelklicken oder "msiexec" an der Befehlszeile ausführen. Sie können auch den Installations-Assistenten als letzten Schritt des Import-Assistenten starten, wie unter Importieren einer BizTalk-Anwendung beschrieben.

Achtung

Wenn diese Anwendung bereits auf dem Computer installiert ist, können Sie die Option zum Reparieren auswählen. Diese Option wird nur unterstützt, wenn für diese Anwendung eine einzelne MSI-Datei installiert wurde. Wenn auf diesem Computer mehrere MSI-Dateien für die Anwendung installiert sind, sollten Sie diese Option nicht auswählen. Der Grund dafür ist, dass durch die Option zum Reparieren alle Änderungen, die eventuell an nach dieser MSI-Datei installierten MSI-Dateien vorgenommen wurden, rückgängig gemacht werden. Dies kann zu Fehlfunktionen der Anwendung führen.

Bevor Sie eine Anwendung in Betrieb nehmen können, müssen Sie sie auf den BizTalk Server-Computern installieren, auf denen sie ausgeführt werden soll. Durch Installation einer Anwendung werden deren Ressourcen im lokalen Dateisystem abgelegt. Je nach der Anwendung, ihrem Inhalt und ihrer Konfiguration können bei der Installation folgende Schritte ausgeführt werden:

  • Hinzufügen von Assemblys zum globalen Assemblycache (GAC)

  • Installieren von Zertifikaten und virtuellen Verzeichnissen

  • Hinzufügen von Komponenten zur Windows-Registrierung

  • Ausführen von vorab oder nachträglich verarbeiteten Skripts, sofern diese in der MSI-Datei vorhanden sind

    Hintergrundinformationen finden Sie unter Was geschieht mit Artefakten während der Installation und Deinstallation?

Voraussetzungen

Sie können die in diesem Thema beschriebenen Arbeitsschritte nur ausführen, wenn Sie unter einem Konto angemeldet sind, das über Schreibberechtigungen im lokalen Dateisystem verfügt. In Abhängigkeit von den Elementen in der Anwendung benötigen Sie unter Umständen auch Schreibberechtigungen für die Windows-Registrierung, den globalen Assemblycache (GAC), den Zertifikatspeicher und die Internetinformationsdienste. Das Administratorkonto auf dem lokalen Computer verfügt über diese Berechtigungen. Ausführlichere Informationen zu Berechtigungen finden Sie unter Erforderliche Berechtigungen für das Bereitstellen und Verwalten einer BizTalk-Anwendung.

Überlegungen zum Installieren einer Anwendung

Beim Installieren einer Anwendung sollten Sie die folgenden Aspekte berücksichtigen:

  • Sie müssen außerdem alle Anwendungen installieren, von denen diese Anwendung abhängig ist. Wenn Sie eine Anwendung installieren, die von einem Element (z. B. einer BizTalk-Assembly) abhängig ist, das sich in einer anderen Anwendung befindet, müssen Sie die Anwendung, die das Element enthält, ebenfalls installieren. Sie können die Anwendung erst dann ausführen, wenn Sie diesen Schritt durchgeführt haben. Wenn Anwendung A beispielsweise von einer Assembly in Anwendung B abhängt, müssen Sie auch Anwendung B installieren. Anschließend können Sie Anwendung A installieren. Hintergrundinformationen finden Sie unter Abhängigkeiten und Anwendungsbereitstellung.

  • Eine Anwendung, die aktualisiert wird, sollte beendet werden. Wenn Sie die Installation durchführen, um ein Element in der Anwendung zu aktualisieren, müssen Sie die Anwendung nur beenden, wenn die Aktualisierung mindestens eine Assembly enthält, deren Version mit der Version vorhandener Assemblys übereinstimmt. In diesem Fall müssen Sie die Anwendung vor der Installation der Aktualisierung beenden. Es empfiehlt sich jedoch, die Anwendung in allen Fällen zu beenden. Nur wenn Sie absolut sicher sind, dass die ausgeführte Anwendung von der Aktualisierung nicht beeinträchtigt wird, können Sie von dieser Regel abweichen. Weitere Informationen finden Sie unter Aktualisieren von BizTalk-Anwendungen.

  • Wenn Sie mehrere MSI-Dateien für dieselbe Anwendung installieren, wird in der Systemsteuerung unter "Software" nur ein Eintrag vorgenommen. Dies empfiehlt beispielsweise zur Aktualisierung einer vorhandenen Anwendung. Mithilfe der Option "Software" (in der Systemsteuerung) können Sie dann die Anwendung komplett deinstallieren, einschließlich aktualisierter Elemente. Beachten Sie, dass die Deinstallation einer Anwendung durch Doppelklicken auf die MSI-Datei oder über den Befehl "msiexec" nicht unterstützt wird. Weitere Informationen finden Sie unter Deinstallieren einer BizTalk-Anwendung.

  • Auf allen Computern, die als Hosts für Sendeports dienen, müssen vor der Ausführung der Anwendung Zertifikate vorhanden sein. Im Zertifikatsspeicher "Andere Personen" sind die Zertifikate gespeichert, die von Sendeports verwendet werden.

  • Sie können Anwendungselemente in verschiedene MSI-Dateien für die Installation einbeziehen. Es ist nicht erforderlich, alle Anwendungselemente auf jedem einzelnen Computer zu installieren, auf dem die Anwendung ausgeführt werden soll. Stattdessen können Sie Untergruppen von Anwendungselementen in verschiedene MSI-Dateien exportieren, die auf verschiedenen Computern installiert werden sollen. Anweisungen finden Sie unter Exportieren einer BizTalk-Anwendung.

  • Wenn die MSI-Datei der Anwendung ein virtuelles Verzeichnis enthält, müssen Internetinformationsdienste (IIS) auf dem lokalen Computer ausgeführt werden. Ist dies nicht der Fall, schlägt die Installation fehl.

  • Wenn die Anwendung ein virtuelles Verzeichnis enthält, dessen Name mit dem Namen eines bereits auf dem lokalen Computer vorhandenen Verzeichnisses übereinstimmt, werden diesem Ressourcen aus der Anwendung hinzugefügt. Andernfalls wird das virtuelle Verzeichnis erstellt. Dateien mit identischen Namen werden überschrieben. Die Sicherheitseinstellungen für ein vorhandenes virtuelles Verzeichnis bleiben unverändert, und Sie sollten diese auf ausreichende Sicherheit überprüfen.

  • Erstellen Sie Anwendungspools für virtuelle Verzeichnisse, bevor Sie eine Anwendung installieren. Wenn Ihre Anwendung ein virtuelles Verzeichnis enthält und der Anwendungspool nicht bereits in IIS vorhanden ist, sollten Sie den Anwendungspool vor der Installation manuell erstellen. Auf diese Weise stellen Sie sicher, dass das virtuelle Verzeichnis während des Installationsvorgangs an den Anwendungspool gebunden wird. Wenn Sie die Anwendung nicht erstellen, wird das virtuelle Verzeichnis bei der Installation an den Standardanwendungspool gebunden.

  • Stellen Sie sicher, dass "BTSHttpReceive.dll" als eine Handlerzuordnung in IIS 7.0 (Internet Information Services, Internetinformationsdienste) registriert ist. Dieser Schritt muss ausgeführt werden, wenn die Anwendung ein virtuelles Verzeichnis enthält, damit der HTTP-Empfangsspeicherort funktioniert.

  • Beim Installieren einer Anwendung mit 64-Bit-Elementen auf einem 32-Bit-Computer können Probleme auftreten. Weitere Informationen finden Sie unter Hinzufügen eines 64-Bit-Artefakts zu einer Anwendung.

  • Wenn die Länge des Zielverzeichnisses 260 Zeichen überschreitet, können Probleme auftreten. Wenn die Anzahl der Zeichen im Zielverzeichnis, das während der Installation eines MSI-Pakets festgelegt wird, 260 überschreitet, schlägt die Installation fehl. Um dieses Problem zu lösen, müssen Sie sicherstellen, dass die Zahl der für das Zielverzeichnis festgelegten Zeichen 260 nicht überschreitet.

  • Installationsordner sollten nicht verschoben werden. Nach der Installation einer Anwendung sollten Sie weder den Installationsordner noch die darin enthaltenen Dateien verschieben. Andernfalls ist es möglich, dass Sie die Anwendung nicht entfernen (deinstallieren) können, wenn Sie dies zu einem späteren Zeitpunkt versuchen. Der Installationsordner der Anwendung enthält beispielsweise von BizTalk Server generierte Dateien, die für die Deinstallation erforderlich sind. Diese Dateien dürfen Sie weder umbenennen, verschieben noch entfernen. Dies sind die Dateien:

    • ApplicationDefinition.adf

    • Microsoft.BizTalk.CustomInstaller.dll

    • Microsoft.BizTalk.CustomInstaller.InstallState

Hinweis

Wenn Sie den Installationsvorgang vor Abschluss abbrechen, führt BizTalk Server ein Rollback für die Installation durch, mit Ausnahme aller Aktionen, die von Vor- oder Nachverarbeitungsskripts ausgeführt wurden, bevor der Vorgang abgebrochen wurde.

Wichtig

Stellen Sie vor der Installation jeder Anwendung sicher, dass die MSI-Datei aus einer vertrauenswürdigen Quelle stammt. Ein böswilliger Benutzer kann Code in eine .msi-Datei einschließen, die unerwünschte Auswirkungen auf Ihr System oder Netzwerk haben kann. Weitere Informationen finden Sie unter Sicherheit und Windows Installer.

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. Dies gilt allerdings nicht, wenn ein virtuelles Verzeichnis vorhanden ist. In diesem Fall werden die vorhandenen Einstellungen verwendet. Nach der Installation der Anwendung sollten Sie prüfen, ob die Einstellungen Ihren Sicherheitsanforderungen genügen.

AllDiscretionary Access Control Lists (DACLs) werden aus Dateien und Ordnern entfernt, wenn eine Anwendung exportiert wird. Nach der Installation einer Anwendung in einer Hostinstanz müssen Sie alle Sicherheitseinstellungen in den Dateien und Ordnern (einschließlich der virtuellen Verzeichnisse) neu konfigurieren.

  • Eventuell müssen Sie die Zuweisung des lokalen Pfads für ein virtuelles Verzeichnis ändern, auf das von einem HTTP-Empfangsspeicherort verwiesen wird, nachdem es auf dem Zielcomputer erstellt wurde.

    Wenn das virtuelle Verzeichnis auf dem Zielcomputer erstellt wird, verweist es auf eines der folgenden physischen Verzeichnisse:

    <Installationslaufwerk>\Programme\Microsoft BizTalk Server\HttpReceive

    - oder –

    <Installationslaufwerk>\Programme (x86)\Microsoft BizTalk Server\HttpReceive

    Wenn sich die ISAPI-Erweiterung "BTSHTTPReceive.dll" für den BizTalk HTTP-Empfang nicht im angegebenen Verzeichnis befindet oder wenn der Zielcomputer ein 64-Bit-Betriebssystem ausführt, müssen Sie die Zuweisung des lokalen Pfads für das virtuelle Verzeichnis ändern, sodass sie auf das physische Verzeichnis zeigt, das die ISAPI-Erweiterungs-Datei für den BizTalk HTTP-Empfang enthält. Wenn auf dem Zielcomputer beispielsweise die 64-Bit-Version von Windows Vista ausgeführt wird, sollte die Bezeichnung Lokaler Pfad: Bezeichnung des virtuellen Verzeichnisses in <Installationslaufwerk>\Programme (x86)\Microsoft BizTalk Server\HttpReceive64 geändert werden.

So installieren Sie eine BizTalk-Anwendung

Verwenden der Windows-Benutzeroberfläche

  1. Kopieren Sie die MSI-Datei für die Anwendung auf den lokalen Computer.

  2. Wenn Sie eine vorhandene BizTalk-Anwendung neu installieren oder aktualisieren und die neue Installation eine Assembly enthält, die die gleiche Version aufweist wie eine Assembly, die bereits in der Anwendung vorhanden ist, oder mit einem Artefakt interagiert, das Sie aktualisieren, stellen Sie sicher, dass die Anwendung beendet wird, indem Sie mit der rechten Maustaste auf den Anwendungsordner klicken und dann auf Beenden klicken.

  3. Doppelklicken Sie in Windows Explorer auf die MSI-Datei, um den Installations-Assistenten zu starten.

  4. Geben Sie auf der Seite Installationsordner auswählen unter Ordner den vollständigen Installationspfad für die BizTalk-Anwendung ein. Beispiel: C:\Programme\Generated by BizTalk\MyApplication.

  5. Klicken Sie vierMal auf Weiter , und klicken Sie dann auf der Seite Installation abgeschlossen auf Schließen.

  6. Wenn die Anwendung auf mehreren Computern ausgeführt werden soll, wiederholen Sie die genannten Schritte auf jedem einzelnen Computer.

    Nachdem die Anwendung auf allen Computern installiert ist, auf denen sie ausgeführt wird, und die Anwendung in die BizTalk-Gruppe importiert wurde, können Sie die Anwendung über die BizTalk Server-Verwaltungskonsole starten, indem Sie mit der rechten Maustaste auf den Ordner der Anwendung klicken und auf Start klicken. Vollständige Anweisungen finden Sie unter Starten und Beenden einer BizTalk-Anwendung.

Verwenden der Befehlszeile

  1. Kopieren Sie die MSI-Datei für die Anwendung auf den lokalen Computer.

  2. Klicken Sie auf Start, klicken Sie auf Ausführen, geben Sie ein cmd, und drücken Sie dann die EINGABETASTE.

  3. Wechseln Sie zu dem Verzeichnis, in dem die MSI-Datei gespeichert ist.

  4. Geben Sie folgenden Befehl ein, um die Anwendung zu installieren. Setzen Sie dabei die entsprechenden Parameter und Werte ein, wie in der folgenden Tabelle beschrieben:

    Wichtig

    Nur die in der folgenden Tabelle angezeigten msiexec-Parameter werden unterstützt.

    msiexec [/i] Package [/qn] TARGETDIR="value"]

    Beispiel: msiexec /i MyApplication.msi

    Parameter Wert
    /Ich Installiert die Anwendung.
    Pakete Name der Windows Installer-Datei (MSI-Datei).
    /Qn Führt die Installation aus, ohne eine Benutzeroberfläche anzuzeigen.
    TARGETDIR="value" Gibt den Installationsordner der Anwendung an. Dieser Wert wird auch in der Umgebungsvariable "%BTAD_InstallDir%" festgelegt.

    Beispiel: TARGETDIR="C:\Programme\BizTalk Applications\My Application"

  5. Wenn die Anwendung auf mehreren Computern ausgeführt werden soll, wiederholen Sie die genannten Schritte auf jedem einzelnen Computer.

    Nachdem die Anwendung auf allen Computern installiert ist, auf denen sie ausgeführt wird, können Sie die Anwendung über die BizTalk Server-Verwaltungskonsole starten, indem Sie mit der rechten Maustaste auf den Ordner der Anwendung klicken und auf Start klicken. Vollständige Anweisungen finden Sie unter Starten und Beenden einer BizTalk-Anwendung.

Weitere Informationen

Bereitstellen von BizTalk-Anwendungen
Deinstallieren einer BizTalk-Anwendung