Zum Inhalt springen

Installieren Sie Jitterbit App Builder unter Microsoft Windows (x64)

Einführung

Installieren App Builder Gehen Sie unter Microsoft Windows folgendermaßen vor:

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

  2. Holen 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.

Hinweis

Das Wort Vinyl, das in Teilen der folgenden Anleitung verwendet wird, ist die frühere Bezeichnung für App Builder.

Holen und entpacken Sie die Software

Um die Software zu erhalten und zu entpacken, folgen Sie diesen Schritten:

  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 bereitgestellt 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 dann 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 Alles extrahieren.

  5. Legen Sie als Ziel für das Extrahieren einen Ordner innerhalb des standardmäßigen physischen IIS-Stammordners fest (z. B. C:\inetpub\wwwroot\Vinyl).

  6. Klicken Sie auf die Schaltfläche Extrahieren.

    Achtung

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

Konfigurieren von IIS

Um IIS zu konfigurieren, folgen Sie diesen Schritten:

  1. Fügen Sie einen Anwendungspool hinzu.

  2. Anwendung hinzufügen.

  3. Authentifizierung konfigurieren.

  4. Berechtigungen festlegen.

Hinzufügen eines Anwendungspools

So fügen Sie mithilfe des IIS-Managers einen Anwendungspool hinzu:

  1. Klicken Sie im Fenster Verbindungen 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.

    • 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 diese 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, sollten sie in separaten App-Pools isoliert werden und die Option Benutzerprofil laden sollte aktiviert sein.

Hinzufügen einer Anwendung

So fügen Sie eine Anwendung mit dem IIS-Manager hinzu:

  1. Erweitern Sie im Fenster 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:

    • Sitename: 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"

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\Vinyl 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 Benutzer Vinyl aus.

  7. Aktivieren Sie unter Berechtigungen für Vinyl für die 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) Aktivieren Sie Crystal Reports

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 dann diese Befehle aus:

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

Erstellen einer Verbindungsdatei

Um eine Verbindungsdatei zu erstellen, gehen Sie folgendermaßen vor:

  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 das 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

Laufen App Builder zum ersten Mal verwenden, befolgen Sie diese Schritte:

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

  2. Das erstmalige Einrichten der Datenbank kann mehrere Minuten dauern. Wenn der Anmeldebildschirm angezeigt wird, 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) Konfiguration nach der Installation

  • Sicherheitsanbieter konfigurieren:

    Die App Builder Sicherheitsmodell unterstützt mehrere konfigurierbare Sicherheitsanbieter. Wenn Ihre Organisation 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 läuft nicht, geplante Ereignisse werden nicht ausgeführt.

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

    Um App Builder automatisch nach dem Wiederaufladen eines Anwendungspools oder einem Serverneustart starten, können Sie den IIS 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.

    Es gibt einen Workaround für dieses Szenario, bei dem der Windows Scheduler pingt App Builder alle 5 Minuten, um sicherzustellen, dass es nach der Wiederverwendung des Anwendungspools wieder gestartet wird.

  • Installieren und Konfigurieren der Anwendungsinitialisierung:

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

  • Testen des Always-Running-Verhaltens:

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

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

    Alwaysrunning

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