Controles en probleemoplossing na upgrade

Laatste update: 2023-07-14
  • Onderwerpen:
  • Upgrading
    Meer informatie over dit onderwerp

Controles na upgrade

Na de Upgrade op locatie de volgende activiteiten moeten worden uitgevoerd om de upgrade af te ronden . Men veronderstelt AEM is begonnen met 6.5 jar en dat de promotiecode basis is opgesteld.

Logboeken controleren voor upgrade voltooid

upgrade.log

In het verleden was voor het inspecteren van de status van uw instantie na de upgrade zorgvuldige inspectie vereist van verschillende logbestanden, onderdelen van de opslagplaats en het startpad. Het genereren van een rapport na de upgrade kan u helpen defecte upgrades te detecteren voordat u live gaat.

Het belangrijkste doel van deze functie is om de behoefte aan handmatige interpretatie of complexe parseringslogica over veelvoudige eindpunten te verminderen die worden vereist om het succes van een verbetering te kwalificeren. De oplossing is bedoeld om ondubbelzinnige informatie te verschaffen aan externe automatiseringssystemen die reageren op het welslagen of de vastgestelde mislukking van een update.

Meer specifiek zorgt het ervoor dat:

  • De mislukkingen van de verbetering die door het verbeteringskader worden ontdekt worden gecentraliseerd in één enkel verbeteringsrapport;
  • Het verbeteringsrapport bevat indicatoren voor noodzakelijke handmatige interventie.

Om dit mogelijk te maken, zijn wijzigingen aangebracht in de manier waarop logbestanden worden gegenereerd in het dialoogvenster upgrade.log bestand.

Hier is een steekproefrapport dat geen fouten tijdens verbetering toont:

1487887443006

Hier is een steekproefrapport dat een bundel toont die niet tijdens het verbeteringsproces werd geïnstalleerd:

1487887532730

error.log

error.log zou zorgvuldig tijdens en na het opstarten van AEM moeten worden herzien gebruikend de jar van de doelversie. Alle waarschuwingen of fouten moeten worden herzien. In het algemeen, is het best om kwesties aan het begin van het logboek te zoeken. Fouten die zich later in het logbestand voordoen, kunnen in feite bijwerkingen zijn van een hoofdoorzaak die vroeg in het bestand wordt aangeroepen. Als zich herhaalde fouten en waarschuwingen voordoen, zie hieronder voor Problemen analyseren met de upgrade.

OSGi-bundels verifiëren

Navigeer aan de console OSGi /system/console/bundles en controleer of er geen bundels zijn gestart. Als er bundels zijn geïnstalleerd, raadpleegt u de error.log om het hoofdprobleem te bepalen.

Oak-versie verifiëren

Na de upgrade moet u controleren of de eikenversie is bijgewerkt naar 1.10.2.. Om de versie van de eikel te verifiëren, navigeer aan de console OSGi en bekijk de versie verbonden aan de bundels van de eikel: eiken kern, eiken komma's, eiken segmentteer.

Inspect PreUpgradeBackup-map

Tijdens de upgrade probeert AEM een back-up te maken van aanpassingen en deze onder /var/upgrade/PreUpgradeBackup/<time-stamp-of-upgrade>. Als u deze map in CRXDE Lite wilt weergeven, moet u mogelijk tijdelijk CRXDE Lite inschakelen.

De map met het tijdstempel moet een eigenschap hebben met de naam mergeStatus met een waarde van COMPLETED. De te verwerken de map moet leeg zijn en de overschreven de knoop wijst op welke knopen tijdens de verbetering werden beschreven. Inhoud onder het knooppunt links geeft inhoud aan die niet veilig kan worden samengevoegd tijdens de upgrade. Als uw implementatie afhankelijk is van een van de onderliggende knooppunten (en nog niet is geïnstalleerd door het aangepaste codepakket), moeten deze handmatig worden samengevoegd.

Schakel CRXDE Lite uit na deze bewerking als u een werkgebied of productieomgeving hebt.

Eerste validatie van pagina's

Voer een eerste validatie uit op meerdere pagina's in AEM. Als u een auteur-omgeving wilt upgraden, opent u de startpagina en de welkomstpagina ( /aem/start.html, /libs/cq/core/content/welcome.html). Open in zowel auteur- als publicatieomgevingen een aantal toepassingspagina's en rooktests die correct worden weergegeven. Als er problemen optreden raadpleegt u error.log om problemen op te lossen.

AEM servicepacks toepassen

Pas alle relevante AEM 6.5-servicepacks toe als deze zijn vrijgegeven.

AEM migreren

Verscheidene eigenschappen in AEM vereisen extra stappen na de verbetering. Een volledige lijst van deze functies en stappen om ze in AEM 6.5 te migreren vindt u op de Code en aanpassingen bijwerken pagina.

Configuraties voor gepland onderhoud controleren

Opruiming gegevensopslag inschakelen

Als het gebruiken van een Opslag van de Gegevens van het Dossier, zorg ervoor dat de taak van de Inzameling van de Opslag van Gegevens wordt toegelaten en aan de Wekelijkse lijst van het Onderhoud toegevoegd. Instructies worden beschreven hier.

OPMERKING

Dit wordt niet geadviseerd voor de installaties van de douanegegevensopslag van S3 of wanneer het gebruiken van een gedeelde gegevensopslag.

Onlinerevisie-opruiming inschakelen

Als u MongoMK of de nieuwe TarMK-segmentindeling gebruikt, dient u ervoor te zorgen dat de Revision Clean Up-taak is ingeschakeld en toegevoegd aan de lijst Dagelijks onderhoud. Instructies omgeven hier.

Testplan uitvoeren

Gedetailleerd testplan uitvoeren ten opzichte van zoals gedefinieerd Code en aanpassingen bijwerken onder de Testprocedure sectie.

Replication-agents inschakelen

Zodra publicatiemilieu volledig is bevorderd en bevestigd, laat replicatieagenten op het Milieu van de Auteur toe. Verifieer dat de agenten met respectieve Publish instanties kunnen verbinden. Zie U Procedure voor meer informatie over de volgorde van gebeurtenissen.

Aangepaste geplande taken inschakelen

Om het even welke geplande banen als deel van de codebasis kunnen op dit punt worden toegelaten.

Problemen analyseren met de upgrade

Deze sectie bevat sommige probleemscenario's één langs de verbeteringsprocedure aan AEM 6.3 zou kunnen worden geconfronteerd.

Deze scenario's zouden moeten helpen om de worteloorzaak van kwesties met betrekking tot verbetering te volgen en zouden moeten helpen om project of product-specifieke kwesties te identificeren.

Migratie opslagplaats mislukt

De gegevensmigratie van CRX2 naar eiken moet haalbaar zijn voor elk scenario dat begint met Broninstanties op basis van CQ 5.4. Zorg ervoor dat u de upgrade-instructies in dit document, waaronder de voorbereiding van de repository.xmlzorgt u ervoor dat er geen aangepaste authenticator via JAAS wordt gestart en dat de instantie op inconsistenties is gecontroleerd voordat de migratie wordt gestart.

Als de migratie nog ontbreekt, kunt u uitzoeken wat de worteloorzaak door is te inspecteren upgrade.log. Als het probleem nog niet bekend is, meldt u dit aan Customer Support.

De upgrade is niet uitgevoerd

Voordat u de voorbereidingsstappen start, moet u de bron -instantie eerst door deze uit te voeren met de Java™ -jar aem-quickstart.jar-opdracht. Dit is vereist om ervoor te zorgen dat het bestand quickstart.properties op de juiste wijze wordt gegenereerd. Als deze ontbreekt, werkt de upgrade niet. U kunt ook controleren of het bestand aanwezig is door onder te kijken crx-quickstart/conf in de installatiemap van de broninstantie. Wanneer u AEM start om de upgrade uit te voeren, moet deze worden uitgevoerd met de Java™-jar aem-quickstart.jar-opdracht. Het opstarten vanaf een beginscript start niet AEM in de upgrademodus.

Pakketten en pakketten kunnen niet worden bijgewerkt

Als pakketten niet tijdens de upgrade worden geïnstalleerd, worden de bundels in de pakketten ook niet bijgewerkt. Deze categorie van kwesties wordt veroorzaakt door wanconfiguratie van de gegevensopslag. Zij worden ook weergegeven als FOUT en WAARSCHUWING berichten in error.log. Aangezien in de meeste van deze gevallen standaardlogin kan ontbreken om te werken, kunt u CRXDE direct gebruiken om de configuratieproblemen te inspecteren en te vinden.

Sommige AEM Bundels schakelen niet naar de Actieve Staat

Als er bundels zijn die niet beginnen, controleer om het even welke ontevreden gebiedsdelen.

Als dit probleem zich voordoet, maar het is gebaseerd op een mislukte pakketinstallatie die ertoe heeft geleid dat bundels niet werden bijgewerkt, worden zij onverenigbaar geacht voor de nieuwe versie. Voor meer informatie over hoe te om dit problemen op te lossen, zie Pakketten en pakketten kunnen niet worden bijgewerkt hierboven.

Het wordt ook aanbevolen de bundellijst van een nieuwe AEM 6.5-instantie te vergelijken met de bijgewerkte versie om de bundels te detecteren die niet zijn bijgewerkt. Hierdoor wordt het bereik vergroot van wat er in de error.log.

Aangepaste bundels die niet overschakelen op de actieve staat

Als de aangepaste bundels niet naar de actieve status overschakelen, is het zeer waarschijnlijk dat er code is die geen wijziging-API importeert. Dit zal meestal leiden tot ontevreden afhankelijkheden.

API die is verwijderd, moet worden gemarkeerd als afgekeurd in een van de vorige releases. In dit bericht vindt u mogelijk instructies over een directe migratie van uw code. Adobe is bedoeld voor semantische versioning waar mogelijk, zodat de versies kunnen aangeven dat er wijzigingen zijn opgetreden.

Het is ook het beste om te controleren of de verandering die het probleem heeft veroorzaakt noodzakelijk was en het terug te draaien als dat niet het geval is. Controleer ook of de versieverhoging van de pakketexport meer dan nodig is, na strikte semantische versiebewerking.

Gebruikersinterface van onjuist functionerend Platform

Als er bepaalde functionaliteit UI is die niet behoorlijk na de verbetering werkt, zou u eerst douanecontrole van de interface moeten controleren. Sommige structuren zijn mogelijk gewijzigd en de overlay moet mogelijk worden bijgewerkt of is verouderd.

Controleer vervolgens of er JavaScript-fouten optreden die kunnen worden bijgehouden bij aangepaste, toegevoegde extensies die zijn gekoppeld aan clientbibliotheken. Hetzelfde kan gelden voor aangepaste CSS die problemen kan veroorzaken voor de AEM-indeling.

Tot slot controleert u op een verkeerde configuratie die JavaScript mogelijk niet kan verwerken. Dit is meestal het geval bij onjuist gedeactiveerde extensies.

Onjuist functionerende aangepaste componenten, sjablonen of UI-extensies

Gewoonlijk zijn de hoofdoorzaken voor deze problemen dezelfde als voor bundels die niet zijn gestart of pakketten die niet zijn geïnstalleerd met het enige verschil dat de problemen zich voordoen wanneer de componenten voor het eerst worden gebruikt.

De manier om met onjuiste douanecode om te gaan is rooktests eerst uit te voeren om de oorzaak te identificeren. Kijk eens naar de aanbevelingen in deze [link] van het artikel voor het corrigeren ervan.

Ontbrekende aanpassingen onder /etc

/apps en /libs worden goed behandeld door de verbetering, maar veranderingen onder /etc moet mogelijk handmatig worden hersteld vanaf /var/upgrade/PreUpgradeBackup na de upgrade. Controleer deze locatie op alle inhoud die handmatig moet worden samengevoegd.

De parameters error.log en upgrade.log analyseren

In de meeste situaties, moeten de logboeken voor fouten worden geraadpleegd om de oorzaak van een probleem te vinden. Nochtans, met verbeteringen, is het ook noodzakelijk om afhankelijkheidskwesties te controleren aangezien de oude bundels niet behoorlijk zouden kunnen worden bevorderd.

De beste manier om dit te doen is onderaan error.log door van alle berichten te verwijderen die van geen verband met de kwestie worden verwacht u onder ogen ziet. U kunt dit doen door middel van hulpmiddel zoals grep, door te gebruiken:

grep -v UnrelatedErrorString

Sommige foutberichten zijn mogelijk niet direct expliciet. In dit geval kunt u door de context te bekijken waarin de fouten zich voordoen, beter begrijpen waar de fout is gemaakt. U kunt de fout scheiden met:

  • grep -B voor het toevoegen van regels vóór de fout;

of

  • grep -A voor het toevoegen van regels na.

In een paar gevallen kunnen er ook fouten worden gevonden in WARN-berichten, omdat er geldige gevallen kunnen zijn die tot deze status leiden en de toepassing niet altijd kan beslissen of dit een werkelijke fout is. Zorg ervoor dat u deze berichten ook raadpleegt.

Contact opnemen met Adobe-ondersteuning

Neem contact op met de Adobe Support als u het advies op deze pagina hebt doorlopen en nog steeds problemen ziet. Om zoveel mogelijk informatie aan de steuningenieur te verstrekken die aan uw geval werkt, zorg ervoor u het upgrade.log dossier van uw verbetering omvat.

Op deze pagina