Installieren Sie Jitterbit App Builder unter Microsoft Windows (x64)

Einführung

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

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

2. Besorgen und auspacken die Software.

3. IIS konfigurieren.

4. (Optional) Crystal Reports aktivieren.

5. Verbindungsdatei erstellen.

6. Testen und ausführen.

7. (Optional) Konfiguration nach der Installation.

Notiz

Das in Teilen der folgenden Anweisungen verwendete Wort Vinyl ist die frühere Bezeichnung für App Builder.

Holen und entpacken Sie die Software

So erhalten und entpacken Sie die Software:

1. Kontaktieren Sie Ihren Customer Success Manager (CSM), um eine Kopie der App Builder 4.0 Software.

   Die Software wird als komprimierte Datei mit dem Namen vinyl-X.Y.N-win.zip, Wo X.Y ist die Versionsnummer (zum Beispiel 4.0) Und N ist die Build-Nummer (zum Beispiel 45678).

2. Kopieren Sie diese Datei in einen Ordner auf dem Host, auf dem IIS ausgeführt wird.

3. Abhängig von 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. Wählen Sie im Dialogfeld Eigenschaften die Tab Sicherheit und dann Entsperren.

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

5. Legen Sie als Ziel für den Extrahierungsvorgang einen Ordner im standardmäßigen physischen IIS-Stammordner fest (z. B. C:\inetpub\wwwroot\Vinyl).

6. Klicken Sie auf die Schaltfläche Extrahieren.

   Achtung

   Fahren Sie erst fort, wenn die Extraktion abgeschlossen ist. Dies kann mehrere Minuten dauern.

Konfigurieren von IIS

So konfigurieren Sie IIS:

1. Anwendungspool hinzufügen.

2. Anwendung hinzufügen.

3. Authentifizierung konfigurieren.

4. Berechtigungen festlegen.

Hinzufügen eines Anwendungspools

So fügen Sie einen Anwendungspool über den IIS-Manager hinzu:

1. Klicken Sie im Bereich „Verbindungen“ mit der rechten Maustaste auf „Anwendungspools“ und wählen Sie „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.

   • Verwalteter Pipeline-Modus: Integriert.

   • Anwendungspool sofort starten: Ausgewählt.

3. Klicken Sie auf die Schaltfläche OK.

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

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

Mehrere Instanzen

Wenn Sie mehrere App Builder Instanzen auf demselben App-Server ausführen möchten, sollten diese in separaten App-Pools isoliert werden und die Option Benutzerprofil laden aktiviert sein.

Hinzufügen einer Anwendung

So fügen Sie eine Anwendung über den IIS-Manager hinzu:

1. Erweitern Sie im Bereich Verbindungen den Ordner Sites, klicken Sie mit der rechten Maustaste auf 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

   • Bewerbungspool: 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 die folgenden 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"

Konfigurieren der Authentifizierung

Um die Authentifizierung mit dem IIS-Manager zu konfigurieren, führen Sie die folgenden Schritte aus:

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

2. Doppelklicken Sie im Abschnitt IIS auf das Symbol Authentifizierung.

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

4. Wählen Sie im Dialogfeld Anonyme Authentifizierungsdaten bearbeiten die Anwendungspoolidentität 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

Festlegen von Berechtigungen

Um Berechtigungen mit dem IIS-Manager festzulegen, führen Sie die folgenden Schritte aus:

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

2. Wählen Sie die Tab 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 auszuwählenden Objektnamen ein Folgendes ein IIS AppPool\Vinylund 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 Benutzer Vinyl aus.

7. Aktivieren Sie unter Berechtigungen für Vinyl in der Zeile Vollzugriff das Kontrollkästchen Zulassen.

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

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

(optional) Crystal Reports aktivieren

App Builder unterstützt Crystal Reports auf Windows Systemen. Crystal Reports wird prozessextern auf einem COM-Server gehostet. Um den Crystal Reports COM-Server zu registrieren, öffnen Sie eine Windows PowerShell als Administrator und führen Sie die folgenden Befehle aus:

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

Erstellen einer Verbindungsdatei

So erstellen Sie eine Verbindungsdatei:

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

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

Tipp

Sie können auch Umfeld oder eine JSON-Datei verwenden, um die Datenbankverbindung anzugeben.

Testen und ausführen

Um App Builder zum ersten Mal auszuführen, führen Sie die folgenden Schritte aus:

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

2. Die erstmalige Einrichtung der Datenbank kann einige Minuten dauern. Geben Sie im Anmeldebildschirm 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. Laden Sie anschließend eine Lizenzdatei hoch.

(optional) Konfiguration nach der Installation

• Sicherheitsanbieter konfigurieren:

  Das Sicherheitsmodell des App Builder unterstützt mehrere konfigurierbare Sicherheitsanbieter. Wenn Ihr Unternehmen Sicherheitsanbieter konfigurieren möchte, lesen Sie bitte die Anbieter Seite.

• Stellen Sie sicher, dass geplante Ereignisse ausgeführt werden, nachdem der Anwendungspool wiederverwendet wurde:

  Sie sollten sicherstellen, dass der Anwendungspool immer ausgeführt wird und dass jedes Ereignis, das zum Stoppen des Anwendungspools führen kann, die Anwendung sofort neu startet.

  Wenn App Builder nicht ausgeführt wird, werden geplante Ereignisse nicht ausgeführt.

  Dies ist wichtig, da IIS den Anwendungspool bei Inaktivität (oft außerhalb der Arbeitszeiten) herunterfährt, wodurch nächtlich geplante Routinen ignoriert werden.

  Damit App Builder nach der Wiederverwendung eines Anwendungspools oder einem Serverneustart automatisch gestartet wird, können Sie den IIS konfigurieren ApplicationInitialization Komponente.

  Notiz

  Die IIS-Anwendungsinitialisierung ist nicht mit Sites kompatibel, die die integrierte Windows Authentifizierung verwenden. Für die Verwendung der integrierten Windows-Authentifizierung muss die anonyme Authentifizierung in IIS deaktiviert sein. Die IIS-Anwendungsinitialisierungskomponente erfordert anonymen Zugriff.

  Für dieses Szenario gibt es eine Problemumgehung, bei der der Windows Scheduler alle 5 Minuten einen Ping an den App Builder sendet, um sicherzustellen, dass er nach der Wiederverwendung des Anwendungspools neu gestartet wird.

  • Problemumgehung für automatischen HTTPS-Start.

• Anwendungsinitialisierung installieren und konfigurieren:

  Die Schritte variieren je nach IIS-Version. Wählen Sie den folgenden Link:

  • Anweisungen zum automatischen Start von IIS 8.5.

  • Anweisungen zum automatischen Start von IIS 7.5.

• Testen des Always-Running-Verhaltens:

  Die folgende Anleitung führt Sie Schritt für Schritt durch das Testen des Always-Running-Verhaltens:

  • Testen des Always-Running-Verhaltens

  Standardmäßig startet IIS alle 29 Stunden neu (damit der Anwendungspool täglich zu unterschiedlichen Zeiten neu gestartet wird). Sie sollten eine bestimmte Uhrzeit für den Neustart des Anwendungspools konfigurieren und sicherstellen, dass diese Uhrzeit nicht mit geplanten Hintergrundjobs kollidiert.

  

  Geben Sie im IIS-Manager Datum und Uhrzeit für die Wiederverwendung des Anwendungspools an. Hier würden Sie 11:42:00 Uhr als eine Uhrzeit festlegen, die nicht mit geplanten Hintergrundjobs kollidiert.