Nach einem ersetzenden Upgrade sollten folgende Schritte durchgeführt werden, um das Upgrade abzuschließen. Es wird davon ausgegangen, dass AEM mit der 6.5-JAR-Datei gestartet wurde und die aktualisierte Codebasis bereitgestellt wurde.
upgrade.log
Bisher mussten diverse Protokolldateien, Teile des Repositorys und das Launchpad sorgfältig überprüft werden, um den Status Ihrer Instanz nach einem Upgrade zu bestimmen. Durch das Generieren von Berichten nach einer Aktualisierung können defekte Upgrades erkannt werden, bevor Instanzen zum Einsatz kommen.
Der primäre Zweck dieser Funktion besteht darin, den manuellen Interpretationsaufwand zu reduzieren oder eine komplexe Parsing-Logik für mehrere Endpunkte zu vermeiden, die erforderlich sind, um den Erfolg eines Upgrades zu qualifizieren. Die Lösung zielt darauf ab, für externe Automatisierungssysteme eindeutige Informationen bereitzustellen, damit diese auf den Erfolg oder das festgestellte Fehlschlagen einer Aktualisierung reagieren können.
Insbesondere wird Folgendes sichergestellt:
Um dies zu berücksichtigen, wurden Änderungen an der Art und Weise vorgenommen, wie Protokolle in der upgrade.log
-Datei.
Im Folgenden finden Sie einen Beispielbericht, der während der Aktualisierung keine Fehler anzeigt:
Dies ist ein Beispielbericht mit einem Paket, das beim Upgrade-Vorgang nicht installiert wurde:
error.log
Die Datei error.log sollte während und nach dem Start der AEM mit der Zielversion jar sorgfältig geprüft werden. Alle Warnungen und Fehler müssen dabei geprüft werden. Im Allgemeinen ist es am besten, am Anfang des Protokolls nach Problemen zu suchen. Fehler, die weiter unten im Protokoll aufgeführt werden, sind u. U. Nebeneffekte einer Grundursache, die sich am Dateianfang findet. Wenn wiederholte Fehler und Warnungen auftreten, finden Sie im nachfolgenden Abschnitt Analysieren von Problemen beim Upgrade weitere Informationen.
Navigieren Sie zur OSGi-Konsole unter /system/console/bundles
und überprüfen Sie, ob irgendwelche Pakete nicht gestartet wurden. Wenn sich Pakete in einem installierten Zustand befinden, lesen Sie den Abschnitt error.log
, um das Problem zu ermitteln.
Nach dem Upgrade sollten Sie sehen, dass die Oak-Version auf 1,10,2. Um die Oak-Version zu überprüfen, navigieren Sie zur OSGi-Konsole und sehen Sie sich die Version an, die Oak-Bundles zugeordnet ist: Oak-Kern, Oak-Commons, Oak-Segment-Tar.
Während des Upgrades versucht AEM, Anpassungen zu sichern und unter /var/upgrade/PreUpgradeBackup/<time-stamp-of-upgrade>
. Um diesen Ordner in CRXDE Lite anzuzeigen, müssen Sie möglicherweise vorübergehend CRXDE Lite aktivieren.
Der Ordner mit dem Zeitstempel sollte die Eigenschaft mergeStatus
mit dem Wert COMPLETED
aufweisen. Der Ordner to-process sollte leer sein und der Knoten overwritten zeigt an, welche Knoten beim Upgrade überschrieben wurden. Der Inhalt unter dem Knoten links zeigt Inhalte an, die während der Aktualisierung nicht sicher zusammengeführt werden konnten. Wenn Ihre Implementierung von einem der untergeordneten Knoten abhängig ist (und noch nicht von Ihrem aktualisierten Code-Paket installiert wurde), müssen diese manuell zusammengeführt werden.
Deaktivieren Sie die CRXDE Lite nach dieser Übung, wenn Sie sich in einer Staging- oder Produktionsumgebung befinden.
Führen Sie in AEM eine Erstüberprüfung mithilfe von mehreren Seiten durch. Wenn eine Autorenumgebung ein Upgrade erhält, öffnen Sie die Startseite und die Begrüßungsseite (/aem/start.html
, /libs/cq/core/content/welcome.html
). Öffnen Sie in der Autoren- und Veröffentlichungsumgebung einige Anwendungsseiten und testen Sie, ob sie korrekt dargestellt werden. Wenn Probleme auftreten, finden Sie in der Datei error.log
weitere Informationen zur Fehlerbehebung.
Wenden Sie alle relevanten AEM 6.5 Service Packs an, falls diese veröffentlicht wurden.
Für eine Reihe von Funktionen in AEM sind nach einem Upgrade zusätzliche Schritte erforderlich. Eine vollständige Liste dieser Funktionen und Schritte zur Migration in AEM 6.5 finden Sie im Aktualisieren von Code und Anpassungen Seite.
Stellen Sie bei Verwendung eines Dateidatenspeichers sicher, dass die Aufgabe "Datenspeicherbereinigung"aktiviert ist und der Liste "Wöchentliche Wartung"hinzugefügt wird. Anweisungen hierzu finden Sie hier.
Dies wird für benutzerdefinierte S3-Datenspeicherinstallationen oder bei Verwendung eines freigegebenen Datenspeichers nicht empfohlen.
Wenn Sie MongoMK oder das neue TarMK-Segmentformat verwenden, stellen Sie sicher, dass die Aufgabe "Revisionsbereinigung"aktiviert und zur Liste "Tägliche Wartung"hinzugefügt ist. Anleitungen here.
Ausführlichen Testplan gemäß Definition ausführen Aktualisieren von Code und Anpassungen unter Testverfahren Abschnitt.
Wenn eine Veröffentlichungsumgebung vollständig upgegradet und überprüft wurde, aktivieren Sie die Replikationsagenten in der Autorenumgebung. Vergewissern Sie sich, dass die Agenten eine Verbindung mit den jeweiligen Veröffentlichungsinstanzen herstellen können. Weitere Einzelheiten zur Reihenfolge der Ereignisse finden Sie unter Aktualisierungsverfahren
Alle geplanten Aufträge, die Teil der Codebasis sind, können zu diesem Zeitpunkt aktiviert werden.
In diesem Abschnitt sind einige Problemszenarien enthalten, die möglicherweise im Zuge des Upgrades auf AEM 6.3 auftreten.
Diese Szenarien sollten dazu beitragen, die Grundursache von Aktualisierungsproblemen zu ermitteln, und dabei helfen, Projekt- oder produktspezifische Probleme zu identifizieren.
Die Datenmigration von CRX2 zu Oak sollte für alle Szenarien möglich sein, die mit Quellinstanzen auf Grundlage von CQ 5.4 beginnen. Achten Sie darauf, dass Sie genau die Aktualisierungsanweisungen in diesem Dokument befolgen, die die Vorbereitung der repository.xml
, stellen Sie sicher, dass kein benutzerdefinierter Authentifizierer über JAAS gestartet wurde und die Instanz vor dem Starten der Migration auf Inkonsistenzen überprüft wurde.
Wenn die Migration weiterhin fehlschlägt, können Sie die Grundursache ermitteln, indem Sie die upgrade.log
. Wenn das Problem noch nicht bekannt ist, melden Sie es dem Support.
Bevor Sie mit den vorbereitenden Schritten beginnen, müssen Sie die source -Instanz zuerst mit dem Java™ -jar-Befehl aem-quickstart.jar ausführen. Dies ist erforderlich, um sicherzustellen, dass die Datei "quickstart.properties"ordnungsgemäß generiert wird. Fehlt diese Datei, wird das Upgrade nicht durchgeführt. Alternativ dazu können Sie im Installationsordner der Quellinstanz unter crx-quickstart/conf
prüfen, ob die Datei vorhanden ist. Wenn Sie mit dem Starten des Upgrades AEM, muss dieses mit dem Java™ -jar aem-quickstart.jar -Befehl ausgeführt werden. Beim Starten mit einem Startskript wird AEM nicht im Upgrade-Modus gestartet.
Wenn Pakete während des Upgrades nicht installiert werden können, werden die darin enthaltenen Pakete ebenfalls nicht aktualisiert. Diese Kategorie von Problemen wird durch eine Fehlkonfiguration des Datenspeichers verursacht. Sie werden auch als FEHLER und WARN Meldungen in der Datei error.log. Da in den meisten dieser Fälle die Standardanmeldung möglicherweise nicht funktioniert, können Sie CRXDE direkt verwenden, um die Konfigurationsprobleme zu untersuchen und zu finden.
Wenn Bundles nicht gestartet werden, überprüfen Sie, ob nicht zufrieden gestellte Abhängigkeiten vorliegen.
Wenn dieses Problem auftritt, jedoch auf eine fehlerhafte Paketinstallation zurückzuführen ist, wodurch Pakete nicht aktualisiert werden, werden diese für die neue Version als inkompatibel angesehen. Weitere Informationen über die entsprechende Fehlerbehebung finden Sie oben unter Fehlerhafte Aktualisierung von Pakete.
Es wird außerdem empfohlen, die Bundle-Liste einer neuen AEM 6.5-Instanz mit der aktualisierten zu vergleichen, um die Bundles zu erkennen, die nicht aktualisiert wurden. Dadurch kann der Bereich der zu suchenden Elemente in der Datei error.log
eingegrenzt werden.
Wenn Ihre benutzerdefinierten Bundles nicht zum aktiven Status wechseln, gibt es höchstwahrscheinlich Code, der die API für Änderungen nicht importiert. Dies führt meist zu nicht zufrieden stellenden Abhängigkeiten.
Eine gelöschte API sollte in einer der vorherigen Versionen als veraltet markiert werden. In diesem Hinweis zur veralteten Version finden Sie u. U. Anweisungen über eine direkte Migration Ihres Codes. Die Adobe zielt nach Möglichkeit auf die semantische Versionierung ab, sodass die Versionen auf brechende Änderungen hinweisen können.
Es ist auch am besten zu überprüfen, ob die Änderung, die das Problem verursacht hat, notwendig war, und sie zurückzusetzen, wenn dies nicht der Fall ist. Überprüfen Sie außerdem, ob die Versionssteigerung des Package-Exports nach strikter semantischer Versionierung mehr als nötig erhöht wurde.
Wenn bestimmte Funktionen der Benutzeroberfläche nach dem Upgrade nicht ordnungsgemäß funktionieren, sollten Sie zunächst nach benutzerdefinierten Überlagerungen der Benutzeroberfläche suchen. Einige Strukturen haben sich möglicherweise geändert und die Überlagerung muss möglicherweise aktualisiert werden oder ist veraltet.
Überprüfen Sie anschließend, ob JavaScript-Fehler vorliegen, die auf benutzerdefinierte hinzugefügte Erweiterungen, die mit Client-Bibliotheken verknüpft sind, nachverfolgt werden können. Dasselbe kann für benutzerdefiniertes CSS gelten, das möglicherweise Probleme beim AEM-Layout verursacht.
Überprüfen Sie abschließend, ob JavaScript möglicherweise nicht in der Lage ist, mit Fehlkonfigurationen umzugehen. Dies ist normalerweise bei falsch deaktivierten Erweiterungen der Fall.
Normalerweise sind die Grundursachen für diese Probleme dieselben wie für Pakete, die nicht gestartet werden oder nicht installiert werden, mit dem einzigen Unterschied, dass die Probleme beim erstmaligen Verwenden der Komponenten auftreten.
Um mit fehlerhaftem benutzerdefiniertem Code umzugehen, führen Sie zuerst Rauch-Tests durch, um die Ursache zu identifizieren. Anschließend sollten Sie in diesem Abschnitt [Link] des Artikels nach Empfehlungen suchen, wie das Problem behoben werden kann.
/apps
und /libs
werden bei einem Upgrade problemlos verarbeitet. Änderungen unter /etc
müssen jedoch möglicherweise nach dem Upgrade manuell aus /var/upgrade/PreUpgradeBackup
wiederhergestellt werden. Überprüfen Sie diesen Speicherort auf Inhalte, die manuell zusammengeführt werden müssen.
In den meisten Fällen müssen die Protokolle bei Fehlern konsultiert werden, um die Ursache eines Problems zu finden. Bei Upgrades ist es jedoch auch erforderlich, Abhängigkeitsprobleme zu überwachen, da alte Bundles möglicherweise nicht ordnungsgemäß aktualisiert werden.
Dafür sollten Sie alle Meldungen aus der Datei „error.log“ entfernen, die erwartungsgemäß nicht mit Ihrem Problem in Zusammenhang stehen. Dies ist mit einem Tool wie grep möglich, indem Sie Folgendes verwenden:
grep -v UnrelatedErrorString
Einige Fehlermeldungen sind möglicherweise nicht sofort selbsterklärend. In diesem Fall kann die Anzeige des Kontexts, in dem sie auftreten, verdeutlichen, wo der Fehler verursacht wurde. Sie können den Fehler wie folgt trennen:
grep -B
für das Hinzufügen von Zeilen vor dem Fehleroder
grep -A
für das Hinzufügen von Zeilen nach dem Fehler.In einigen Fällen können Fehler auch in WARN-Meldungen gefunden werden, da gültige Fälle vorliegen können, die zu diesem Status führen. Die Anwendung kann darüber hinaus nicht immer entscheiden, ob ein tatsächlicher Fehler vorliegt. Stellen Sie sicher, dass Sie auch diese Nachrichten konsultieren.
Wenn Sie die Ratschläge auf dieser Seite befolgt haben und weiterhin Probleme auftreten, wenden Sie sich an den Support von Adobe. Stellen Sie sicher, dass Sie die Datei upgrade.log aus Ihrem Upgrade einbeziehen, damit Sie dem Support-Mitarbeiter, der an Ihrem Fall arbeitet, möglichst viele Informationen zur Verfügung stellen können.