Installieren Sie den Jitterbit App Builder auf Microsoft Windows (x64)

Einführung

Um den App Builder auf Microsoft Windows zu installieren, befolgen Sie diese Schritte:

1. Erfüllen Sie die Softwareanforderungen sowohl für den Webserver als auch für den Datenbankserver.

2. Holen Sie sich die Software und entpacken Sie sie.

3. Konfigurieren Sie IIS.

4. (Optional) Aktivieren Sie Crystal Reports.

5. Erstellen Sie eine Verbindungsdatei.

6. Testen und ausführen.

7. (Optional) Nach der Installation konfigurieren.

Holen Sie sich die Software und entpacken Sie sie

Um die Software zu erhalten und zu entpacken, befolgen Sie diese Schritte:

1. Kontaktieren Sie Ihren Customer Success Manager (CSM), um eine Kopie der App Builder 4-Software zu erhalten.

   Die Software wird als komprimierte Datei mit dem Namen vinyl-X.Y.N-win.zip bereitgestellt, wobei X.Y die Versionsnummer (zum Beispiel 4.0) und N die Buildnummer (zum Beispiel 45678) ist.

2. Kopieren Sie diese Datei in einen Ordner auf dem Host, auf dem IIS läuft.

3. Je nach den Sicherheitseinstellungen Ihres Systems müssen Sie die Datei möglicherweise entsperren. Klicken Sie dazu mit der rechten Maustaste auf die Datei und wählen Sie Eigenschaften. Im Dialogfeld Eigenschaften wählen Sie die Registerkarte Sicherheit und dann Entsperren:

   

4. Klicken Sie mit der rechten Maustaste auf die Datei vinyl-X.Y.N-win.zip und wählen Sie Alle extrahieren.

5. Setzen Sie das Zielverzeichnis für die Extraktion auf einen Ordner innerhalb des standardmäßigen physischen IIS-Stammordners (zum Beispiel C:\inetpub\wwwroot\Vinyl).

6. Klicken Sie auf die Schaltfläche Extrahieren.

   Vorsicht

   Fahren Sie nicht fort, bis die Extraktion abgeschlossen ist. Dies kann viele Minuten dauern.

IIS konfigurieren

Um IIS zu konfigurieren, befolgen Sie diese Schritte:

1. Fügen Sie einen Anwendungspool hinzu.

2. Fügen Sie eine Anwendung hinzu.

3. Konfigurieren Sie die Authentifizierung.

4. Setzen Sie Berechtigungen.

Anwendungspool hinzufügen

Um einen Anwendungspool mit dem IIS-Manager hinzuzufügen, befolgen Sie diese Schritte:

1. Klicken Sie im Verbindungen-Panel mit der rechten Maustaste auf Anwendungspools und wählen Sie dann Anwendungspool hinzufügen.

2. Legen Sie im Dialogfeld Anwendungspool hinzufügen Werte für die folgenden Felder fest:

   • Name: Vinyl

   • .NET CLR-Version: .NET CLR-Version v4.0.30319.

   • Managed Pipeline Mode: Integriert.

   • Anwendungspool sofort starten: Ausgewählt.

3. Klicken Sie auf die Schaltfläche OK.

Um einen Anwendungspool über die Befehlszeile hinzuzufügen, geben Sie diese Befehle ein:

cd 'C:\Program Files\IIS'
.\appcmd.exe add apppool /name:"Vinyl" /managedPipelineMode:Integrated /autoStart:true /managedRuntimeVersion:"v8.0"

Anwendung hinzufügen

Um eine Anwendung mit dem IIS-Manager hinzuzufügen, befolgen Sie diese Schritte:

1. Klicken Sie im Verbindungen-Panel auf den Ordner Websites und klicken Sie mit der rechten Maustaste auf die Standardwebsite, und wählen Sie dann Website hinzufügen.

2. Legen Sie im Dialogfeld Website hinzufügen Werte für die folgenden Felder fest:

   • Site-Name: Vinyl

   • Anwendungspool: Vinyl

   • Physischer Pfad: C:\inetpub\wwwroot\Vinyl

   • Website sofort starten: Ausgewählt.

3. Klicken Sie auf die Schaltfläche OK.

Um eine Anwendung über die Befehlszeile hinzuzufügen, geben Sie diese Befehle ein:

.\appcmd.exe add site /name:"Vinyl" /id:1 /bindings:http://*:80 /physicalPath:"C:\inetpub\wwwroot\Vinyl"
.\appcmd.exe add app /site.name:"Vinyl" /path:"/" /physicalPath:"C:\inetpub\wwwroot\Vinyl"

Authentifizierung konfigurieren

Um die Authentifizierung mit dem IIS-Manager zu konfigurieren, befolgen Sie diese Schritte:

1. Wählen Sie im Verbindungen-Panel unter dem Sites-Ordner den Eintrag Vinyl aus.

2. Doppelklicken Sie auf das Authentifizierung-Symbol im IIS-Bereich.

3. Wählen Sie Anonyme Authentifizierung und klicken Sie auf die Aktion Bearbeiten.

4. Wählen Sie im Dialogfeld Anonyme Authentifizierungsanmeldeinformationen bearbeiten die Identität des Anwendungs-Pools aus und klicken Sie dann auf die Schaltfläche OK.

Um die Authentifizierung über die Befehlszeile zu konfigurieren, geben Sie diesen Befehl ein:

appcmd.exe set config -section:anonymousAuthentication /username:"" --password

Berechtigungen festlegen

Um Berechtigungen mit dem IIS-Manager festzulegen, befolgen Sie diese Schritte:

1. Klicken Sie im Verbindungen-Panel unter dem Sites-Ordner mit der rechten Maustaste auf Vinyl und wählen Sie Berechtigungen bearbeiten.

2. Wählen Sie die Registerkarte Sicherheit und klicken Sie dann auf die Schaltfläche Bearbeiten.

3. Klicken Sie im Dialogfeld Berechtigungen für Vinyl auf die Schaltfläche Hinzufügen.

4. Geben Sie im Dialogfeld Benutzer oder Gruppen auswählen im Feld Geben Sie die Objektnamen ein, um sie auszuwählen IIS AppPool\Vinyl ein und klicken Sie dann auf die Schaltfläche Namen überprüfen.

5. Klicken Sie auf die Schaltfläche OK.

6. Wählen Sie im Dialogfeld Berechtigungen für Vinyl unter Gruppen- oder Benutzernamen den neuen Vinyl-Benutzer aus.

7. Wählen Sie unter Berechtigungen für Vinyl für die Zeile Vollzugriff das Kontrollkästchen Zulassen aus.

8. Klicken Sie auf die Schaltfläche OK, um das Dialogfeld zu schließen.

9. Klicken Sie im Dialogfeld Vinyl-Eigenschaften auf die Schaltfläche OK.

(Optional) Crystal Reports aktivieren

App Builder unterstützt Crystal Reports auf Windows-Systemen. Crystal Reports wird außerhalb des Prozesses in einem COM-Server gehostet. Um den Crystal Reports COM-Server zu registrieren, öffnen Sie eine Windows PowerShell als Administrator und führen Sie diese Befehle aus:

Set-ExecutionPolicy RemoteSigned
cd C:\inetpub\wwwroot\Vinyl\Scripts
.\RegisterCrystalReports.ps1

Eine Verbindungsdatei erstellen

Um eine Verbindungsdatei zu erstellen, befolgen Sie diese Schritte:

1. Kopieren Sie eines der Beispiele im Ordner Sample_Connection_Files und fügen Sie es mit dem Namen Connection.xml im Stammverzeichnis von Vinyl ein. Welches Sie kopieren, hängt von Ihrem Datenbanktyp ab.

2. Bearbeiten Sie die Datei C:\inetpub\wwwroot\Vinyl\Connection.xml und setzen Sie Werte für die Parameter DatabaseName, UserName und Password. (Der Benutzer UserName muss über eine Systemadministrationsrolle verfügen.)

Testen und Ausführen

Um den App Builder zum ersten Mal auszuführen, befolgen Sie diese Schritte:

1. Gehen Sie zu http://localhost/Vinyl/.

2. Es kann mehrere Minuten dauern, die Datenbank zum ersten Mal einzurichten. Wenn der Anmeldebildschirm erscheint, geben Sie die folgenden Standardanmeldeinformationen ein:

   • Benutzername: admin

   • Passwort: P@55w0rd

3. Klicken Sie auf die Schaltfläche Anmelden und folgen Sie den Anweisungen zum Ändern des Passworts und zum Hochladen einer Lizenzdatei.

(Optional) Nachinstallationskonfiguration

• Konfigurieren Sie Sicherheitsanbieter:

  Das Sicherheitsmodell des App Builders unterstützt mehrere, konfigurierbare Sicherheitsanbieter. Wenn Ihre Organisation Sicherheitsanbieter konfigurieren möchte, lesen Sie bitte die Seite Anbieter.

• Stellen Sie sicher, dass geplante Ereignisse nach dem Recycling des Anwendungs-Pools ausgeführt werden:

  Sie sollten sicherstellen, dass der Anwendungs-Pool immer läuft und dass jedes Ereignis, das dazu führen könnte, dass der Anwendungs-Pool stoppt, die Anwendung sofort neu startet.

  Wenn der App Builder nicht läuft, werden geplante Ereignisse nicht ausgeführt.

  Dies ist wichtig, da IIS den Anwendungs-Pool im Leerlauf herunterfährt (häufig außerhalb der Arbeitszeiten), was dazu führt, dass nächtliche geplante Routinen ignoriert werden.

  Um den App Builder automatisch zu starten, nachdem ein Anwendungs-Pool recycelt oder ein Server neu gestartet wurde, können Sie die IIS-Komponente ApplicationInitialization konfigurieren.

  Hinweis

  IIS ApplicationInitialization ist nicht mit Websites kompatibel, die Windows Integrated Authentication verwenden. Die Verwendung von Windows Integrated Authentication erfordert, dass die anonyme Authentifizierung in IIS deaktiviert ist. Die IIS ApplicationInitialization-Komponente erfordert anonymen Zugriff.

Es gibt eine Lösung für dieses Szenario, bei dem der Windows Scheduler alle 5 Minuten App Builder anpingt, um sicherzustellen, dass es nach dem Recycling des Anwendungs-Pools wieder gestartet wird.

• Auto-Start HTTPS-Lösung.

• Installieren und konfigurieren Sie die Anwendungsinitialisierung:

  Die Schritte variieren je nach Version von IIS. Wählen Sie einen der folgenden Links:

  • IIS 8.5 Auto-Start-Anweisungen.

  • IIS 7.5 Auto-Start-Anweisungen.

• Testen des Verhaltens "Immer aktiv":

  Der folgende Leitfaden beschreibt, wie das Verhalten "Immer aktiv" getestet werden kann:

  • Testen des Verhaltens "Immer aktiv"

  Standardmäßig ist IIS so eingestellt, dass es alle 29 Stunden neu gestartet wird (damit der Anwendungs-Pool zu unterschiedlichen Zeiten jeden Tag neu gestartet wird). Sie sollten eine bestimmte Tageszeit konfigurieren, zu der der Anwendungs-Pool neu gestartet wird, und sicherstellen, dass diese Zeit nicht mit geplanten Hintergrundjobs in Konflikt steht.

  

  Geben Sie ein Datum und eine Uhrzeit zum Recycling des Anwendungs-Pools im IIS-Manager an. Hier sollten Sie 11:42:00 auf eine Zeit einstellen, die nicht mit geplanten Hintergrundjobs in Konflikt steht.