Aktualisieren Sie Jitterbit App Builder unter Microsoft Windows (x64)

Einführung

Um App Builder unter Microsoft Windows zu aktualisieren, führen Sie die folgenden Schritte aus:

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

2. Besorgen und auspacken die Software.

3. Wiederherstellen Einstellungen.

4. IIS konfigurieren.

5. (Optional) Crystal Reports aktivieren.

6. Testen und Ausführen.

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-Software zu erhalten.

   Die Software wird als komprimierte Datei bereitgestellt. Windows Benutzer haben folgende Möglichkeiten:

   • vinyl-X.Y.N-win.zip für eine Standardbereitstellung

   • vinyl-X.Y.N-thirdparty-win.zip, die eine Sammlung von Vorlagen für die Anbindung an Dritte enthält

   • vinyl-X.Y.N-thirdpartysap-win.zip, das die gleichen Vorlagen sowie SAP-spezifische Treiber enthält

   Für alle Optionen, X.Y ist die Versionsnummer (zum Beispiel 4.0) Und N ist die Build-Nummer (zum Beispiel 45678).

   Notiz

   Das in Teilen dieser Anleitung verwendete Wort Vinyl ist die frühere Bezeichnung für App Builder.

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 die Datei mit der in Schritt 1 ausgewählten Bereitstellung und wählen Sie Alle extrahieren.

5. Legen Sie als Ziel für den Extrahierungsvorgang einen temporären Ordner fest, z. B. C:\temp\Vinyl.

6. Klicken Sie auf die Schaltfläche Extrahieren.

   Achtung

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

Einstellungen wiederherstellen

So stellen Sie Ihre Einstellungen wieder her:

1. IIS stoppen:

   1. Öffnen Sie den Internetinformationsdienste (IIS)-Manager.

   2. Wählen Sie den Webserver aus.

   3. Klicken Sie oben rechts im Bereich Aktionen auf die Schaltfläche Stoppen.

2. Erstellen Sie eine Sicherungskopie Ihrer Datenbanken.

3. Verschieben Sie den aktuellen Installationsordner an einen temporären Speicherort (z. B. von C:\inetpub\wwwroot\Vinyl Zu C:\temp\OLD_Vinyl).

4. Benennen Sie den neuen Installationsordner um (z. B. von C:\temp\Vinyl Zu C:\inetpub\wwwroot\Vinyl).

5. Kopieren Sie die folgenden Dateien aus Ihrem alten Installationsordner in den neuen:

   Kopieren von	Nach
   C:\temp\OLD_Vinyl\Connection.xml	C:\inetpub\wwwroot\Vinyl\Connection.xml
   C:\temp\OLD_Vinyl\appsettings.json	C:\inetpub\wwwroot\Vinyl\appsettings.json
   C:\temp\OLD_Vinyl\keys\*	C:\inetpub\wwwroot\Vinyl\keys\

   Notiz

   Jitterbit empfiehlt Ihnen, auch Ihre Protokolle und Datenordner vom alten in das neue Verzeichnis zu kopieren. Obwohl dies nicht notwendig ist, bietet es einige Vorteile, z. B. stellt es sicher, dass alle Protokolle an einem Ort gespeichert sind und App Builder alle gespeicherten PDF-Dateien im gleichen Verzeichnispfad wie zuvor anzeigen kann.

Konfigurieren von IIS

Um IIS nach dem Upgrade von App Builder zu konfigurieren, führen Sie die folgenden Schritte aus:

1. Öffnen Sie den Internetinformationsdienste (IIS)-Manager.

2. Erweitern Sie den Ordner Vinyl.

3. Klicken Sie mit der rechten Maustaste auf den Ordner data und wählen Sie die Option Berechtigungen bearbeiten.

4. Wählen Sie die Tab Sicherheit.

5. Klicken Sie auf die Schaltfläche Bearbeiten, um das Dialogfeld Berechtigungen für Daten zu öffnen.

6. Klicken Sie auf die Schaltfläche Hinzufügen..., um das Dialogfeld „Benutzer oder Gruppen auswählen“ zu öffnen.

7. Geben Sie den Namen an IIS AppPool\Vinyl im unteren Feld.

8. Aktivieren Sie im Feld „Berechtigungen“ die Option „Vollzugriff zulassen“ und klicken Sie anschließend auf „OK“, um das Dialogfeld „Datenberechtigungen“ zu schließen.

9. Klicken Sie auf „OK“, um das Dialogfeld „Dateneigenschaften“ zu schließen.

10. Wiederholen Sie die Schritte 3–9 auch für die Verzeichnisse „logs“ und „keys“.

11. Starten Sie IIS neu, indem Sie den Server auswählen und im Aktionsbereich auf „Start“ klicken.

(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

Testen und ausführen

Um App Builder nach einem Upgrade auszuführen, führen Sie die folgenden Schritte aus:

1. Laden Sie ggf. eine neue Lizenzdatei hoch und aktivieren Sie diese:

   Wichtig

   Dies ist obligatorisch, wenn Sie ein Upgrade von Vinyl 3.3 durchführen zu App Builder 4, da die Lizenzen für Vinyl 3.3 nicht auf App Builder 4 übertragbar sind.

   1. Melden Sie sich beim Webserver an, auf dem App Builder installiert ist.

   2. Starten Sie den Windows Explorer.

   3. Suchen Sie das Installationsverzeichnis des App Builder (z. B. C:\inetpub\wwwroot\Vinyl).

   4. Kopieren Sie die Lizenzdatei in das data Verzeichnis.

   5. Benennen Sie die Datei in vinyl.lic um (falls sie anders benannt ist).

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

3. Die Aktualisierung der Datenbank kann einige Minuten dauern. Geben Sie im Anmeldebildschirm Ihre Administratoranmeldeinformationen ein und klicken Sie anschließend auf die Schaltfläche Anmelden.