Upgrade Jitterbit App Builder auf Microsoft Windows (x64)

Einführung

Um App Builder auf Microsoft Windows zu aktualisieren, 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 und entpacken Sie die Software.

3. Stellen Sie die Einstellungen wieder her.

4. Konfigurieren Sie IIS.

5. (Optional) Aktivieren Sie Crystal Reports.

6. Testen und ausführen.

Holen Sie sich und entpacken Sie die Software

Um die Software zu holen 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 bereitgestellt. Windows-Benutzer haben folgende Optionen:

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

   • vinyl-X.Y.N-thirdparty-win.zip, die eine Sammlung von Vorlagen zum Verbinden mit Dritten enthält

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

   Für alle Optionen steht X.Y für die Versionsnummer (zum Beispiel 4.0) und N für die Buildnummer (zum Beispiel 45678).

   Hinweis

   Das Wort Vinyl, das in Teilen dieser Anweisungen verwendet wird, ist der frühere Name 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 möglicherweise die Datei 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, die das Deployment enthält, das Sie in Schritt 1 ausgewählt haben, und wählen Sie Alle extrahieren.

5. Setzen Sie das Zielverzeichnis für die Extraktion auf einen temporären Ordner, wie z.B. C:\temp\Vinyl.

6. Klicken Sie auf die Schaltfläche Extrahieren.

   Vorsicht

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

Einstellungen wiederherstellen

Um Ihre Einstellungen wiederherzustellen, befolgen Sie diese Schritte:

1. Stoppen Sie IIS:

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

   2. Wählen Sie den Webserver aus.

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

2. Erstellen Sie eine Sicherungskopie Ihrer Datenbanken.

3. Verschieben Sie den aktuellen Installationsordner an einen temporären Ort (zum Beispiel von C:\inetpub\wwwroot\Vinyl nach C:\temp\OLD_Vinyl).

4. Benennen Sie den neuen Installationsordner um (zum Beispiel von C:\temp\Vinyl nach C:\inetpub\wwwroot\Vinyl).

5. Kopieren Sie die folgenden Dateien von Ihrem alten Installationsordner in Ihren 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\

   Hinweis

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

IIS konfigurieren

Um IIS nach dem Upgrade von App Builder zu konfigurieren, befolgen Sie diese Schritte:

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

2. Erweitern Sie den Vinyl-Ordner.

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

4. Wählen Sie die Registerkarte Sicherheit.

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

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

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

8. Aktivieren Sie Vollzugriff erlauben im Berechtigungsfeld und klicken Sie dann auf die Schaltfläche OK, um das Dialogfeld Berechtigungen für data zu schließen.

9. Klicken Sie auf die Schaltfläche OK, um das Dialogfeld Eigenschaften von data zu schließen.

10. Wiederholen Sie die Schritte 3-9 für die Verzeichnisse logs und keys.

11. Starten Sie IIS neu, indem Sie den Server auswählen und auf die Schaltfläche Start im Aktionsbereich klicken.

(Optional) Crystal Reports aktivieren

App Builder unterstützt Crystal Reports auf Windows-Systemen. Crystal Reports wird in einem COM-Server außerhalb des Prozesses 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

Testen und ausführen

Um App Builder nach einem Upgrade auszuführen, befolgen Sie diese Schritte:

1. Falls erforderlich, laden Sie eine neue Lizenzdatei hoch und aktivieren Sie sie:

   Wichtig

   Dies ist erforderlich, wenn Sie von Vinyl 3.3 auf App Builder 4 upgraden, da die Lizenzen für Vinyl 3.3 nicht auf App Builder 4 übertragbar sind.

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

   2. Starten Sie den Windows-Explorer.

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

   4. Kopieren Sie die Lizenzdatei in das Verzeichnis data.

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

2. Gehe zu http://localhost/Vinyl/.

3. Es kann mehrere Minuten dauern, die Datenbank zu aktualisieren. Wenn der Anmeldebildschirm erscheint, gib die Anmeldedaten deines Administrators ein und klicke dann auf die Schaltfläche Anmelden.