App Builder auf Microsoft Windows (x64) aktualisieren

Einführung

Führen Sie diese Schritte aus, um App Builder auf Microsoft Windows zu aktualisieren:

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

2. Rufen Sie die Software ab und entpacken Sie sie.

3. Stellen Sie die Einstellungen wieder her.

4. Konfigurieren Sie IIS.

5. (Optional) Aktivieren Sie Crystal Reports.

6. Testen und ausführen.

Software abrufen und entpacken

Führen Sie diese Schritte aus, um die Software abzurufen und zu entpacken:

1. Wenden Sie sich an 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 die folgenden Optionen:

   • 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 Verbindung mit Drittanbietern enthält

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

   Bei allen Optionen ist X.Y die Versionsnummer (z. B. 4.0) und N ist die Build-Nummer (z. B. 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. Je nach 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 Registerkarte 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 das Extraktionsziel auf einen temporären Ordner fest, 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 viele Minuten dauern.

Einstellungen wiederherstellen

Führen Sie diese Schritte aus, um Ihre Einstellungen wiederherzustellen:

1. Beenden Sie IIS:

   1. Öffnen Sie Internet Information Services (IIS) Manager.

   2. Wählen Sie den Webserver aus.

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

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\

IIS konfigurieren

Um IIS nach dem Upgrade von App Builder zu konfigurieren, führe diese Schritte aus:

1. Öffne Internet Information Services (IIS) Manager.

2. Erweitere den Ordner Vinyl.

3. Klicke mit der rechten Maustaste auf den Ordner data und wähle die Option Edit Permissions (Berechtigungen bearbeiten).

4. Wähle die Registerkarte Security (Sicherheit).

5. Klicke auf die Schaltfläche Edit (Bearbeiten), um das Dialogfeld „Permissions for data" (Berechtigungen für data) zu öffnen.

6. Klicke auf die Schaltfläche Add... (Hinzufügen...), um das Dialogfeld „Select Users or Groups" (Benutzer oder Gruppen auswählen) zu öffnen.

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

8. Aktiviere Allow Full Control (Vollzugriff zulassen) im Feld „Permissions" (Berechtigungen) und klicke dann auf die Schaltfläche OK, um das Dialogfeld „Permissions for data" (Berechtigungen für data) zu schließen.

9. Klicke auf die Schaltfläche OK, um das Dialogfeld „data Properties" (Eigenschaften von data) zu schließen.

10. Wiederhole die Schritte 3–9 auch für die Verzeichnisse logs und keys.

11. Starte IIS neu, indem du den Server auswählst und im Bereich „Actions" (Aktionen) auf die Schaltfläche Start klickst.

(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, öffne Windows PowerShell als Administrator und führe 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, führe diese Schritte aus:

1. Lade bei Bedarf eine neue Lizenzdatei hoch und aktiviere sie:

   Wichtig

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

   1. Melde dich auf dem Webserver an, auf dem App Builder installiert ist.

   2. Öffne Windows Explorer.

   3. Suche das App Builder-Installationsverzeichnis (z. B. C:\inetpub\wwwroot\Vinyl).

   4. Kopiere die Lizenzdatei in das Verzeichnis data.

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

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

3. Die Aktualisierung der Datenbank kann mehrere Minuten dauern. Wenn der Anmeldebildschirm angezeigt wird, gib die Anmeldedaten deines Administrators ein und klicke dann auf die Schaltfläche Sign In (Anmelden).