Vorlage (Beispiel für die Anwendungsbereitstellung)
In diesem Thema wird erläutert, wie Sie das Vorlagenbeispiel für die Anwendungsbereitstellung verwenden.
Sie können zwei Arten von Bereitstellungsskripts erstellen und verwenden, um die BizTalk-Anwendungsbereitstellung anzupassen: Vorverarbeitungsskripts und Nachverarbeitungsskripts. Vorab verarbeitete Skripts werden vor der Installation und dem Import der Anwendung und nach der Deinstallation aufgerufen. Nachträglich verarbeitete Skripts werden nach der Installation und dem Import der Anwendung und vor der Deinstallation aufgerufen.
Sie können vorab und nachträglich verarbeitete Skripts so schreiben, dass sie für jeden dieser Vorgänge aufgerufen werden. Alternativ dazu können Sie Skripts auch so konfigurieren, dass sie nur nach einem der Vorgänge ausgeführt werden. Weitere Informationen zum Schreiben von Skripts finden Sie unter Verwenden von Vor- und Nachverarbeitungsskripts zum Anpassen der Anwendungsbereitstellung.
In diesem Thema wird erläutert, wie Sie ein Skript schreiben und bereitstellen, das vor bzw. nach nur einem Vorgang aufgerufen wird. Sie schreiben dazu ein Skript, das die Werte von Umgebungsvariablen prüft, um den Vorgang festzustellen, in dessen Kontext es aufgerufen wird. Auf der Basis dieses Kontexts setzt das Skript die Ausführung fort bzw. beendet sie.
In diesem Thema werden die folgenden Schritte beschrieben:
Festlegen des Speicherorts für die Protokolldatei, um eine Protokolldatei der Skriptvorgänge zu erstellen
Hinweis
Es hat sich bewährt, eine Protokolldatei zu erzeugen, damit Skriptvorgänge überprüft und Probleme behoben werden können.
Erstellen einer neuen BizTalk-Anwendung und Hinzufügen der Beispielskripts zu dieser Anwendung
Exportieren einer MSI-Datei mit den Anwendungselementen
Löschen der Anwendung aus der BizTalk-Gruppe, damit Sie die MSI-Datei wieder in dieselbe Gruppe importieren und die Anwendung aus der MSI-Datei installieren können
Importieren der Anwendung und Prüfen der Protokolldatei, um festzustellen, ob der Importvorgang protokolliert wurde
Installieren der Anwendung und Prüfen der Protokolldatei, um festzustellen, ob das Installationsprotokoll an die Protokolldatei angefügt wurde
Anzeigen der Protokolldateien und Prüfen, welche Vorgänge die Skripts zu welchem Zeitpunkt durchgeführt haben
Ziel des Beispiels
Zwei für dieses Beispiel bereitgestellte BAT-Dateien enthalten die Werte der Umgebungsvariablen für Import, Installation und Deinstallation. Die Datei SamplePreProcessing.bat enthält Variablen für ein vorab verarbeitetes Skript. SamplePostProcessing.bat enthält Variablen für ein nachträglich verarbeitetes Skript. Die Dateien veranschaulichen zudem, wie Nachrichten aus Skripts protokolliert werden. Sie können die relevanten Abschnitte aus diesen Dateien in Ihre Skripts kopieren.
Wichtig
Einige Kommentare in den Skriptdateien sind fehlerhaft:
In der Datei SamplePreProcessing.bat sollte der Skriptkommentar „Pre uninstall part of the script called for an existing application“ eigentlich „Post uninstall part of the script called for an existing application“ lauten.
In der Datei SamplePostProcessing.bat sollte der Skriptkommentar „Post uninstall part of the script called for an existing application“ eigentlich „Pre uninstall part of the script called for an existing application“ lauten.
Speicherort dieses Beispiels
Das Beispiel befindet sich wie folgt im Installationsordner BizTalk Server:
<Beispielpfad>\Anwendungsbereitstellung\Vorlage
Wie bereits erwähnt, enthält das Beispiel die beiden folgenden Dateien:
SamplePreProcessing.bat
SamplePostProcessing.bat
Verwenden dieses Beispiels
Führen Sie zum Ausführen des Beispiels die folgenden Schritte aus.
So legen Sie den Speicherort der Protokolldatei fest
Öffnen Sie beide Skriptbeispiele, und ändern Sie die Variable LogFile so ab, dass sie auf den gewünschten Speicherort für die Protokolldateien zeigt. Sie müssen den vollständigen Pfad der Datei einschließlich des Dateinamens angeben. Wenn er Leerzeichen enthält, müssen Sie den Pfad in doppelte Anführungszeichen (") einschließen.
Beispiel:
set LogFile="<Samples Path>\ApplicationDeployment\Templates\SampleLogOut.txt"
So erstellen Sie eine neue Anwendung
Klicken Sie auf Start, alle Programme, Microsoft BizTalk Server 20xx und dann auf BizTalk Server Verwaltung.
Erweitern Sie in der Konsolenstruktur den Eintrag BizTalk Server-Verwaltung, und erweitern Sie dann die Gruppe „BizTalk“.
Klicken Sie mit der rechten Maustaste auf Anwendungen , und klicken Sie dann auf Neu.
Geben Sie unter Anwendungsname den Namen ein
SamplesTemplate, und klicken Sie dann auf OK.
So fügen Sie die Skripts zur Anwendung hinzu
Erweitern Sie den Ordner der soeben erstellten SamplesTemplate-Anwendung, und klicken Sie im linken Bereich mit der rechten Maustaste auf Ressourcen .
Zeigen Sie auf Hinzufügen, und klicken Sie auf Vorverarbeitungsskripts.
Klicken Sie auf Hinzufügen , und navigieren Sie zu SamplePreProcessing.bat.
Wählen Sie die Datei aus, und klicken Sie auf Öffnen.
Klicken Sie unter Dateityp auf System.BizTalk:PreprocessingScript, und klicken Sie dann auf OK.
Das Skript SamplePreProcessing.bat wird zur Anwendung hinzugefügt und im Ordner Ressourcen der Anwendung angezeigt.
Klicken Sie erneut mit der rechten Maustaste auf Ressourcen, zeigen Sie auf Hinzufügen, und klicken Sie dann auf Skripts nach der Verarbeitung.
Klicken Sie auf Hinzufügen , und navigieren Sie zu SamplePostProcessing.bat.
Wählen Sie die Datei aus, und klicken Sie auf Öffnen.
Klicken Sie unter Dateityp auf System.BizTalk:PostprocessingScript, und klicken Sie dann auf OK.
Das Skript SamplePostProcessing.bat wird zur Anwendung hinzugefügt und im Ordner Ressourcen der Anwendung angezeigt.
So exportieren Sie eine MSI-Datei
Klicken Sie in der BizTalk Server Verwaltungskonsole mit der rechten Maustaste auf die Anwendung SamplesTemplate, zeigen Sie auf Exportieren, und klicken Sie dann auf MSI-Datei.
Klicken Sie auf der Seite Willkommen beim Export-Assistenten auf Weiter.
Klicken Sie auf der Seite Ressourcen auswählen auf Weiter.
Klicken Sie auf der Seite IIS-Hosts angeben auf Weiter.
Klicken Sie auf der Seite Abhängigkeiten 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\SamplesTemplate.msi
Klicken Sie auf der Zusammenfassungsseite auf Fertig stellen.
Löschen der Anwendung
- Klicken Sie in der BizTalk Server Verwaltungskonsole mit der rechten Maustaste auf die Anwendung SamplesTemplate, und klicken Sie dann auf Löschen.
So importieren Sie die MSI-Datei
Klicken Sie in der BizTalk Server Verwaltungskonsole mit der rechten Maustaste auf Anwendungen, zeigen Sie auf Importieren, und klicken Sie dann auf MSI-Datei.
Geben Sie auf der Seite Willkommen beim Import-Assistenten in der zu importierenden MSI-Datei den Pfad der zuvor exportierten .msi-Datei ein, und klicken Sie dann auf Weiter. Bei Bedarf können Sie nach der MSI-Datei suchen, indem Sie auf die Schaltfläche (....) klicken.
Wählen Sie auf der Seite Anwendungseinstellungen in der Dropdownliste Anwendungsname den Anwendungsnamen aus.
Wählen Sie unter Verfügbare Anwendungen, zu denen Verweise hinzugefügt werden sollen, die Anwendungen aus, denen Verweise hinzugefügt werden sollen, falls vorhanden, und klicken Sie dann auf Weiter.
Klicken Sie auf der Seite Anwendungszielumgebungseinstellungen auf Weiter.
Hinweis
Bei diesem Beispiel müssen Sie keine Zielumgebung angeben. Hintergrundinformationen zu diesem Feature finden Sie unter Bindungsdateien und Anwendungsbereitstellung. Anweisungen zum Hinzufügen von Bindungsdateien finden Sie unter Hinzufügen einer Bindungsdatei zu einer Anwendung.
Vergewissern Sie sich auf der Seite Zusammenfassung importieren, dass die Zusammenfassungsinformationen korrekt sind, und klicken Sie dann auf Importieren.
Klicken Sie auf der Seite Ergebnisse auf Fertig stellen.
Öffnen Sie die Protokolldatei, die bei der Ausführung der Skripts erstellt wurde, und prüfen Sie, ob der Importvorgang protokolliert wurde.
So installieren Sie die Anwendung
Doppelklicken Sie auf die MSI-Datei, und führen Sie den Installations-Assistenten aus.
Öffnen Sie die Protokolldatei, und prüfen Sie, ob der Installationsvorgang zu den Protokollinformationen hinzugefügt wurde.
So überprüfen Sie, ob die Skripts ordnungsgemäß funktioniert haben
- Öffnen Sie die Protokolldateien, und überprüfen Sie, ob die Skripts während der festgelegten Vorgänge ausgeführt wurden.
Weitere Informationen
Anwendungsbereitstellung (Ordner für BizTalk Server-Beispiele)
Bereitstellen von BizTalk-Anwendungen