DokumentationAEM 6.5Benutzerhandbuch

AEM 6.5 Forms Service Pack – Installationsanweisungen aem-form-patch-installation-instructions

Last update: Thu Apr 25 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

Erstellt für:

  • User
  • Admin
  • Developer

Versionsinformationen

Produkt
Adobe Experience Manager 6.5 Forms
Version
6.5.20.0
Typ
Service Pack-Version
Datum
29. Februar 2024
Download-URL
Neueste AEM Forms-Versionen
NOTE
Eine vollständige Liste der behobenen Probleme finden Sie in den aktuellen AEM Service Pack Versionshinweisen.

Was ist in Experience Manager Forms 6.5 enthalten?

Das Service Pack für Adobe Experience Manager (AEM) Forms enthält neue und aktualisierte Funktionen, darunter wichtige kundenseitig geforderte Erweiterungen sowie Verbesserungen bei Leistung, Stabilität und Sicherheit. AEM Forms veröffentlicht in regelmäßigen Abständen Service Packs mit den neuesten Funktionen und Verbesserungen. Wählen Sie abhängig von Ihrem Technologie-Stack einen der folgenden Pfade, um das Service Pack herunterzuladen und in Ihrer Umgebung zu installieren:

NOTE
  • Adobe veröffentlicht mit jedem sechsten Service Pack ein vollständiges Installationsprogramm. AEM 6.5 Forms Service Pack 18 (6.5.18.0) ist das neueste vollständige Installationsprogramm für JEE. Das vollständige Installationsprogramm unterstützt neue Plattformen, während das reguläre Service Pack-Installationsprogramm neue Funktionen, Fehlerbehebungen und allgemeine Verbesserungen enthält. Wenn Sie eine Neuinstallation durchführen oder die Verwendung der neuesten Software für Ihre AEM 6.5 Forms on JEE-Umgebung planen, empfiehlt Adobe die Verwendung des Vollinstallationsprogramms für AEM 6.5.18.0 Forms on JEE vom 31. August 2023 anstelle des AEM 6.5 Forms-Installationsprogramms vom 08. April 2019 oder des AEM 6.5.12.0 Forms-Installationsprogramms vom 03. März 2022. Nachdem Sie das vollständige Installationsprogramm verwendet haben, installieren Sie das neueste Service Pack.
  • Die im AEM 6.5-Schnellstart verfügbaren AEM Forms-Funktionen, z. B. adaptive Formulare, dienen nur zu Kennenlern- und Evaluierungszwecken. Für die Verwendung in der Produktion ist es unerlässlich, eine gültige Lizenz für AEM Forms zu erwerben.

Service Pack herunterladen und auf einer Umgebung von AEM Forms auf JEE installieren download-and-install-for-jee-service-pack

1. Erstellen Sie ein Backup Ihrer bestehenden Umgebung
  1. Sichern Sie Ihr CRX-Repository, Datenbankschema und GDS (Global Document Storage).
  2. Sichern Sie den Ordner <AEM_forms_root>/deploy.
note note
NOTE
Bevor Sie das AEM Service Pack-Installationsprogramm ausführen, vergewissern Sie sich, dass Sie über Schreibzugriffsrechte für das AEM-Installationsverzeichnis verfügen.
2. Laden Sie die erforderliche Software herunter
3. Installieren Sie Microsoft Visual C++ Redistributable Packages
note note
NOTE
Stellen Sie sicher, dass Sie das Redistributable installieren, auch wenn eine frühere Version bereits installiert ist, um die Verfügbarkeit der neuesten Version zu gewährleisten.
4. Installieren Sie das AEM Forms on JEE Service Pack:

  1. Stoppen Sie den Programm-Server.

  2. Extrahieren Sie das AEM Forms on JEE Service Pack-Installationsarchiv auf Ihrer Festplatte:

    • Windows
      Navigieren Sie zu dem entsprechenden Verzeichnis auf dem Installationsmedium oder dem Ordner auf Ihrer Festplatte, in den Sie das Installationsprogramm kopiert haben, und doppelklicken Sie auf die Datei aemforms65_cfp_install.exe.

      • (Windows 32-Bit) Windows\Disk1\InstData\VM
      • (Windows 64-Bit) Windows_64Bit\ Disk1\InstData\VM

    • Linux®
      Navigieren Sie zum entsprechenden Ordner und geben Sie in einer Shell Folgendes ein./aem65_cfp_install.bin.

      • (Linux®) Linux/Disk1/InstData/NoVM

    Dadurch wird ein Installationsassistent gestartet, der Sie durch die Installation führt.

  3. Klicken Sie im Begrüßungsbildschirm auf Weiter.

  4. Stellen Sie auf dem Bildschirm Installationsordner auswählen sicher, dass der Standardspeicherort, der angezeigt wird, für Ihre bestehende Installation korrekt ist, oder klicken Sie auf Durchsuchen, um den alternativen Ordner auszuwählen, auf dem AEM Forms installiert ist, und klicken Sie auf Weiter.

  5. Lesen Sie die Zusammenfassung der Informationen zum Service Pack und klicken Sie auf Weiter.

  6. Lesen Sie die Informationen in der Zusammenfassung vor der Installation und klicken Sie auf Installieren.

  7. Wenn die Installation abgeschlossen ist, klicken Sie auf Weiter, um die Schnellkorrektur-Updates auf Ihre installierten Dateien anzuwenden.

  8. [Nur für Windows]: Führen Sie einen der folgenden Schritte aus:

    • Sie können entweder die Option Configuration Manager starten deaktivieren, bevor Sie auf Fertig klicken. Führen Sie Configuration Manager durch Verwendung der Datei ConfigurationManager.bat in [aem-forms root]\configurationManager\bin aus.

    • Oder deaktivieren Sie die Option Configuration Manager starten, bevor Sie auf Fertig klicken. Navigieren Sie vor der Ausführung von Configuration Manager mit ConfigurationManager.exe oder ConfigurationManager_IPv6.exe zu <AEMForms_Install_Dir>\configurationManager\bin und ersetzen Sie ConfigurationManager.lax und ConfigurationManager_IPV6.lax durch die neuesten Dateien ConfigurationManager.lax und ConfigurationManager_IPV6.lax und ersetzen Sie in diesen beiden Dateien axis-1.4.1.1.jar überall durch axis-1.4.1.2.jar.

      note note
      NOTE
      • Wenn Sie die Datei ConfigurationManager.bat aktualisieren oder ersetzen, müssen Sie die .lax-Dateien nicht manuell aktualisieren.

  9. [Nur für Unix-basierte Systeme]: Das Kontrollkästchen Configuration Manager starten ist standardmäßig aktiviert. Klicken Sie auf Fertig, um Configuration Manager sofort zu starten. Um Configuration Manager erst später zu starten, deaktivieren Sie die Option Configuration Manager starten, bevor Sie auf Fertig klicken. Sie können Configuration Manager später mit dem entsprechenden Skript im Verzeichnis [AEM_forms_root]/configurationManager/bin starten.

  10. Wählen Sie je nach Anwendungs-Server eines der folgenden Dokumente aus und befolgen Sie die Anweisungen im Bereich Konfigurieren und Bereitstellen von AEM Forms.

note note
NOTE
  • Nach der Installation von AEM Forms on JEE Service Pack müssen Sie das Add-On-Paket für Forms aus dem Ordner crx-repository\install entfernen, bevor Sie den Anwendungs-Server neu starten. Laden Sie das neueste Add-On-Paket für Forms vom Software Distribution-Portal herunter.
  • Es wird empfohlen, den Befehl „Strg + C“ zu verwenden, um das SDK neu zu starten. Das Neustarten des AEM SDK mit anderen Methoden, z. B. dem Beenden von Java-Prozessen, kann zu Inkonsistenzen in der AEM-Entwicklungsumgebung führen.
5. Installation des Servlet-Fragments (AEM Service Pack 6.5.14.0 oder früher)
note note
NOTE
  • Wenn Sie ein Upgrade von AEM Service Pack 6.5.15.0 durchführen, ist die Installation des Servlet-Fragments nicht erforderlich. Für die Versionen AEM Service Pack 6.5.14.0 oder früher ist es zwingend erforderlich, das Servlet-Fragment zu installieren.
  • Die Installation des Servlet-Fragments ist obligatorisch für alle Anwendungs-Server, mit Ausnahme derer, die auf JBoss® EAP 7.4.0 laufen.

So laden Sie das Servlet-Fragment herunter und installieren es:

  1. Wenn Sie das Fragment nicht heruntergeladen haben, laden Sie es von Software Distribution herunter.

  2. Starten Sie den Anwendungs-Server, warten Sie, bis sich die Protokolle stabilisiert haben und überprüfen Sie den Bundle-Status.

  3. Öffnen Sie Web-Konsole Bundles. Die Standard-URL ist http://[Server]:[Port]/system/console/bundles.

  4. Klicken Sie auf „Installieren/Aktualisieren“. Wählen Sie das heruntergeladene Fragment aus, org.apache.felix.http.servlet-api-1.2.0_fragment_full.jar. Klicken Sie auf Installieren oder Aktualisieren. Warten Sie, bis sich der Anwendungsserver stabilisiert hat

  5. Stoppen Sie den Anwendungs-Server.

6. Installieren des AEM Service Pack
  1. Starten Sie die Instanz vor der Installation neu, wenn sich die Instanz im Update-Modus befindet (wenn die Instanz von einer früheren Version aktualisiert wurde). Adobe empfiehlt einen Neustart, wenn die aktuelle Betriebszeit für eine Instanz hoch ist.
  2. Erstellen Sie vor der Installation eine Momentaufnahme oder ein neues Backup Ihrer Experience Manager-Instanz.
  3. Laden Sie das Service Pack von Software Distribution herunter.
  4. Öffnen Sie Package Manager und wählen Sie dann Paket hochladen, um das Paket hochzuladen. Weitere Informationen finden Sie unter Package Manager.
  5. Wählen Sie das Paket aus und klicken Sie auf Installieren.

Automatische Installation

Es gibt zwei verschiedene Methoden, mit denen Sie das Service Pack von ExperienceManager automatisch installieren können.

  • Platzieren Sie das Paket in den Ordner ../crx-quickstart/install, wenn der Server online verfügbar ist.
    Das Paket wird automatisch installiert.

  • Verwenden Sie die HTTP-API von Package Manager. Verwenden Sie cmd=install&recursive=true, damit die verschachtelten Pakete installiert werden.

    note note
    NOTE
    Das Service Pack von Experience Manager unterstützt keine Bootstrap-Installation.

    Validierung der Installation

    Informationen zu den Plattformen, die für diese Version zertifiziert sind, finden Sie in den technischen Anforderungen.

    1. Auf der Seite mit Produktinformationen (/system/console/productinfo) wird die aktualisierte Versionszeichenfolge Adobe Experience Manager (spversion) unter Installierte Produkte angezeigt.
    2. Alle OSGi-Bundles haben in der OSGi-Konsole entweder den Status AKTIV oder FRAGMENT (Verwenden Sie die Web-Konsole: /system/console/bundles).
    3. Das OSGi-Bundle org.apache.jackrabbit.oak-core ist Version 1.22.14 oder höher (zu verwendende Web-Konsole: /system/console/bundles).
7. Installieren des Add-On-Pakets zu AEM Experience Manager Forms
  1. Stellen Sie sicher, dass Sie das Experience Manager Service Pack installiert haben.
  2. Wählen Sie unter den aufgeführten AEM Forms-Versionen das für Ihr Betriebssystem passende Forms-Add-on-Paket aus und laden Sie es herunter.
  3. Installieren Sie das Forms-Add-on-Paket wie unter Installieren des AEM Forms-Add-on-Pakets beschrieben.
  4. Wenn Sie in Experience Manager 6.5 Forms Briefe verwenden, installieren Sie das neueste AEMFD-Kompatibilitätspaket.

Herunterladen und Installieren des Service Packs in einer Umgebung von AEM Forms on OSGi download-and-install-for-osgi-service-pack

1. Erstellen Sie ein Backup Ihrer bestehenden Umgebung
  1. Sichern Sie Ihr CRX-Repository und Datenbankschema.
note note
NOTE
Wenn Sie das AEM Forms Service Pack für eine relationale Datenbank installieren, müssen Sie unbedingt ein Backup von DB_schema erstellen.
2. Laden Sie die erforderliche Software herunter
3. Installieren Sie Microsoft Visual C++ Redistributable Packages
note note
NOTE
Stellen Sie sicher, dass Sie das Redistributable installieren, auch wenn eine frühere Version bereits installiert ist, um die Verfügbarkeit der neuesten Version zu gewährleisten.
4. Installieren des AEM Service Pack
  1. Starten Sie die Instanz vor der Installation neu, wenn sich die Instanz im Update-Modus befindet (wenn die Instanz von einer früheren Version aktualisiert wurde). Adobe empfiehlt einen Neustart, wenn die aktuelle Betriebszeit für eine Instanz hoch ist.
  2. Erstellen Sie vor der Installation eine Momentaufnahme oder ein neues Backup Ihrer Experience Manager-Instanz.
  3. Laden Sie das Service Pack von Software Distribution herunter.
  4. Öffnen Sie Package Manager und wählen Sie dann Paket hochladen, um das Paket hochzuladen. Weitere Informationen finden Sie unter Package Manager.
  5. Wählen Sie das Paket aus und klicken Sie auf Installieren.

Automatische Installation

Es gibt zwei verschiedene Methoden, mit der Sie das Service Pack von Experience Manager automatisch installieren können.

  • Platzieren Sie das Paket in den Ordner ../crx-quickstart/install, wenn der Server online verfügbar ist. Das Paket wird automatisch installiert.

  • Verwenden Sie die HTTP-API von Package Manager. Verwenden Sie cmd=install&recursive=true, damit die verschachtelten Pakete installiert werden.

    note note
    NOTE
    Das Service Pack von Experience Manager unterstützt keine Bootstrap-installation.

    Validierung der Installation

    Informationen zu den Plattformen, die für diese Version zertifiziert sind, finden Sie in den technischen Anforderungen.

    1. Die Seite mit den Produktinformationen (/system/console/productinfo) zeigt die aktualisierte Versionszeichenfolge Adobe Experience Manager (spversion) unter Installierte Produkte an.

    2. Alle OSGi-Bundles sind in der OSGi-Konsole entweder AKTIV oder FRAGMENT (zu verwendende Web-Konsole: /system/console/bundles).

      1. Das OSGi-Bundle org.apache.jackrabbit.oak-core hat die Version 1.22.14 oder höher (zu verwendende Web-Konsole: /system/console/bundles).
5. Installieren des Adobe Experience Manager Forms (AEM)-Add-On-Pakets
  1. Stellen Sie sicher, dass Sie das Experience Manager Service Pack installiert haben.
  2. Wählen Sie unter den aufgeführten AEM Forms-Versionen das für Ihr Betriebssystem passende Forms-Add-on-Paket aus und laden Sie es herunter.
  3. Installieren Sie das Forms-Add-on-Paket wie unter Installieren des AEM Forms-Add-on-Pakets beschrieben.
  4. Wenn Sie in Experience Manager 6.5 Forms Briefe verwenden, installieren Sie das neueste AEMFD-Kompatibilitätspaket.

Fehlerbehebung

  • Wenn das Dialogfeld auf der Package Manager-Oberfläche während der Installation des Service Packs beendet wird, warten Sie, bis sich die Fehlerprotokolle stabilisiert haben, bevor Sie auf die Bereitstellung zugreifen. Warten Sie auf die spezifischen Protokolle im Zusammenhang mit der Deinstallation des Aktualisierungspakets, bevor Sie sich vergewissern, dass die Installationen erfolgreich waren. Dieses Problem tritt in der Regel im Safari-Browser auf, kann aber zeitweise auch in jedem anderen Browser auftreten.

  • Überprüfen Sie die Überwachungsprotokolle (error.log) nach Abschluss der Installation auf Aktivitäten. Warten Sie ein paar Minuten, bis keine Aktivität in den Protokollen zu sehen ist. Starten Sie die AEM-Instanz neu.

  • Falls Sie nach der Installation des neuesten Service Packs von AEM Forms 6.5.15.0 einen Fehler Dienst nicht verfügbar erhalten, installieren Sie das Servlet-Fragment und -Paket, um den Fehler zu beheben.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2