DocumentatieAEM 6.5 LTSHandboek

AEM 6.5 LTS bijwerken op JBoss EAP 8 (Windows)

Last update: Thu Apr 09 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Van toepassing op:
  • Experience Manager 6.5 LTS

Overzicht

Deze handleiding bevat stapsgewijze instructies voor het upgraden van een bestaande Adobe Experience Manager (AEM) 6.5 LTS-installatie van JBoss EAP 7.4 naar JBoss EAP 8 in Windows, met gebruik van JDK 21.

de Weg van de Verbetering: JBoss EAP 7.4 (JDK 11) → JBoss EAP 8 (JDK 21)

Belangrijke kennisgevingen

NOTE
Dit is een kritieke verbeteringsprocedure. Voer altijd deze upgrade uit in een andere omgeving dan de productieomgeving en onderhoud volledige back-ups.
​ PREREQUISITES: Volledige systeemback-up en een gedocumenteerd terugdraaiplan zijn verplicht voordat u verdergaat.

Vereisten voor upgrades

Systeemvereisten

Component
Vereiste
Besturingssysteem
Windows Server 2016 of hoger (64-bits)
Source-omgeving
JBoss EAP 7.4 met AEM 6.5 LTS
Doelomgeving
JBoss EAP 8.x
Java Development Kit
JDK 21 (Oracle of OpenJDK)
AEM-versie
AEM 6.5 Service Pack (meest recente aanbevolen)
Schijfruimte
Minimaal 50 GB vrije ruimte voor upgradeproces

Vereiste downloads

Verkrijg het volgende voordat u begint met de upgrade:

  1. JBoss EAP 8.0 Distribution
    Download van: ​ https://developers.redhat.com/products/eap/download

  2. JDK 21 Installateur
    Oracle JDK 21 of OpenJDK 21 voor Windows downloaden (64-bits)

  3. AEM 6.5 LTS het Dossier van de OORLOG
    Haal de nieuwste AEM 6.5 Service Pack WAR op bij Adobe Software Distribution

Stap 1: Volledige back-up maken

IMPORTANT
Voer uitvoerige steunen uit alvorens te werk te gaan.

Controlelijst voor back-up

  • [ ] Volledige back-up van bestaande JBoss EAP 7.4-installatiemap
  • [ ] Back-up van map crx-repository
  • [ ] Back-up van map crx-quickstart
  • [ ] Alle aangepaste configuraties exporteren
  • [ ] Back-up van database (indien externe database wordt gebruikt)
  • [ ] Huidige systeemstatus en -configuraties van document

Back-up maken

# Example backup location
C:\AEM-Backups\Pre-Upgrade-<date>

# Copy entire JBoss 7.4 directory
xcopy "C:\jboss-eap-7.4" "C:\AEM-Backups\Pre-Upgrade-<date>\jboss-eap-7.4" /E /I /H

geadviseerd: de steunen van de opslag op een afzonderlijke aandrijving of netwerkplaats.

Stap 2: JBoss EAP 8 installeren

JBoss EAP 8 extraheren

  1. Pak de JBoss EAP 8 ZIP-distributie uit naar de installatiemap van uw doel:

    code language-none 
    C:\jboss-eap-8.0

  2. Maak een notitie van dit mappad als <JBOSS_HOME> voor gebruik in deze handleiding.

Directorystructuur repliceren

Zorg ervoor dat de nieuwe JBoss EAP 8-installatie dezelfde aangepaste mapstructuur heeft als de vorige JBoss EAP 7.4-installatie, met name:

  • Aangepaste implementatiemappen
  • Externe configuratiemappen
  • Locaties van logbestanden
  • Aangepaste modules of bibliotheken

Stap 3: Gegevens in opslagplaats migreren

CRX-opslagplaats kopiëren

  1. Navigeer naar uw bestaande JBoss EAP 7.4-installatie:

    code language-none 
    <OLD_JBOSS_HOME>\bin\crx-repository

  2. Kopieer de volledige map crx-repository naar de nieuwe JBoss EAP 8-installatie:

    code language-cmd 
    xcopy "C:\jboss-eap-7.4\bin\crx-repository" "C:\jboss-eap-8.0\bin\crx-repository" /E /I /H

Belangrijk: Deze omslag bevat uw inhoudsbewaarplaats en moet volledig worden overgebracht.

Kopie van opslagplaats verifiëren

Na het kopiëren controleert u de grootte en structuur van de opslagplaats aan de bron:

dir "C:\jboss-eap-8.0\bin\crx-repository" /s

Stap 4: AEM-instantie stoppen

Controleer voordat u wijzigingen aanbrengt of AEM volledig is gestopt.

Stoppen via Windows Services

  1. Open Diensten (Looppas: services.msc)
  2. Zoek uw AEM/JBoss-service
  3. Klik met de rechtermuisknop en selecteer Einde
  4. Wacht op de dienst volledig om te stoppen

Stoppen via opdrachtregel

Als AEM handmatig is gestart:

  1. Naar het JBoss-consolevenster gaan
  2. Druk op Ctrl+C
  3. Wacht tot de functie voor het handmatig afsluiten is voltooid

Uitschakelen verifiëren

Zorg ervoor dat het Java-proces niet meer wordt uitgevoerd:

tasklist | findstr java

Stap 5: verouderde AEM-bestanden opruimen

Verwijder verouderde bestanden uit de map crx-quickstart om een schone upgrade te garanderen.

CAUTION
Verwijder alleen de specifieke bestanden en mappen hieronder. Verwijder geen andere configuratiebestanden, aangepaste code of gegevens in de opslagplaats.

5.1 Opstartmap voor startpagina verwijderen

Plaats:

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\launchpad\startup

Actie:

rd /s /q "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\launchpad\startup"

Doel: Deze omslag bevat oude bundels OSGi die tijdens de verbetering zullen worden opnieuw geproduceerd.

5.2 Basis JAR-bestand verwijderen

Plaats:

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\launchpad\org.apache.sling.launchpad.base.jar

Actie:

del "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\launchpad\org.apache.sling.launchpad.base.jar"

Doel: Dit JAR zal met de versie van het nieuwe dossier van de OORLOG worden vervangen.

5.3 Bootstrap-opdrachtbestand verwijderen

Plaats:

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\launchpad\felix\bundle0\BootstrapCommandFile_*.txt

Actie:

del "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\launchpad\felix\bundle0\BootstrapCommandFile_*.txt"

Doel: de bevelen van Bootstrap zullen voor het nieuwe milieu worden opnieuw geproduceerd.

5.4 Bestand met opties verwijderen

Plaats:

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\launchpad\felix\sling.options.file

Actie:

del "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\launchpad\felix\sling.options.file"

5.5 Bestand met schuine streep_bootstrap.txt verwijderen

Plaats:

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\launchpad\sling_bootstrap.txt

Actie:

del "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\launchpad\sling_bootstrap.txt"

5.6 Bestand met back-up en verwijdering van sling.properties

Dit bestand bevat omgevingspecifieke configuraties die mogelijk later moeten worden samengevoegd.

Plaats:

<JBOSS_HOME>\bin\crx-repository\crx-quickstart\conf\sling.properties

Actie:

  1. creeer steun:

    code language-cmd 
    copy "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\conf\sling.properties" "C:\AEM-Backups\sling.properties.backup"

  2. Schrap origineel:

    code language-cmd 
    del "C:\jboss-eap-8.0\bin\crx-repository\crx-quickstart\conf\sling.properties"

Doel: een nieuw sling.properties zal worden geproduceerd. Controleer uw back-up om eventuele aangepaste configuraties na de upgrade te herstellen.

Stap 6: Installeer en configureer JDK 21

JDK 21 installeren

  1. Het JDK 21-installatieprogramma voor Windows uitvoeren
  2. Installeren op een standaardlocatie (bijvoorbeeld C:\Program Files\Java\jdk-21)
  3. De installatiewizard voltooien

Omgevingsvariabelen configureren

JAVA_HOME instellen

  1. Open Eigenschappen van het Systeem → Geavanceerd → de Variabelen van het Milieu

  2. Onder Variabelen van het Systeem, klik Nieuw

  3. Instellen:

    • Naam variabele: JAVA_HOME
    • Waarde variabele: C:\Program Files\Java\jdk-21

  4. Klik O.K.

PAD-variabele bijwerken

  1. In Variabelen van het Systeem, uitgezocht Path en klik uitgeven

  2. Nieuwe vermelding toevoegen:

    code language-none 
    %JAVA_HOME%\bin

  3. Plaats dit item boven aan de lijst zodat JDK 21 voorrang krijgt

  4. Klik O.K. op alle dialogen

Java-installatie verifiëren

  1. Open a nieuwe Herinnering van het Bevel (om bijgewerkte omgevingsvariabelen te laden)

  2. Java-versie verifiëren:

    code language-cmd 
    java -version

    Verwachte uitvoer:

    code language-none 
    java version "21.0.x"
Java(TM) SE Runtime Environment (build 21.0.x+...)
Java HotSpot(TM) 64-Bit Server VM (build 21.0.x+..., mixed mode, sharing)

  3. JAVA_HOME verifiëren:

    code language-cmd 
    echo %JAVA_HOME%

Stap 7: JVM-instellingen configureren

Voordat u AEM implementeert, configureert u de juiste JVM-geheugeninstellingen voor productiegebruik.

Zelfstandig.conf.bat bewerken

  1. Navigeren naar:

    code language-none 
    <JBOSS_HOME>\bin

  2. standalone.conf.bat openen in een teksteditor (als beheerder)

  3. Zoek de JAVA_OPTS -configuratie op of voeg deze toe:

    code language-batch 
    rem # AEM Production JVM Settings
set "JAVA_OPTS=-Xms4096m -Xmx4096m -XX:MaxMetaspaceSize=768m"
set "JAVA_OPTS=%JAVA_OPTS% -Djava.net.preferIPv4Stack=true"
set "JAVA_OPTS=%JAVA_OPTS% -Dfile.encoding=UTF-8"
set "JAVA_OPTS=%JAVA_OPTS% -server"

  4. Het bestand opslaan en sluiten

geadviseerde Montages:

Parameter
Aanbevolen waarde
Beschrijving
-Xms
4096m - 8192m
Oorspronkelijke heapgrootte
-Xmx
4096m - 8192m
Maximale heapgrootte
-XX:MaxMetaspaceSize
768 m - 1024 m
Limiet voor metareaal

Nota: pas waarden aan die op het beschikbare geheugen en de werklastvereisten van uw server worden gebaseerd.

Stap 8: AEM 6.5 LTS WAR implementeren

WAR-bestand voorbereiden

Zorg ervoor dat uw AEM WAR-bestand correct is geconfigureerd volgens de implementatiehandleiding:

  • jboss-deployment-structure.xml is aanwezig
  • web.xml bevat instellingen voor meerdelige configuratie
  • WAR wordt opnieuw gecodeerd als er wijzigingen zijn aangebracht

Distribueren naar JBoss

  1. Kopieer het AEM 6.5 LTS WAR-bestand naar de implementatiemap:

    code language-cmd 
    copy "C:\AEM-Downloads\cq-quickstart-6.5.xx.war" "C:\jboss-eap-8.0\standalone\deployments\cq-quickstart.war"

Belangrijk: verzeker filename van de OORLOG aan uw gewenste URL contextweg aanpast.

Stap 9: Start JBoss EAP 8 met AEM

De server starten

  1. Open Herinnering van het Bevel als Beheerder

  2. Navigeer naar de map JBoss bin:

    code language-cmd 
    cd C:\jboss-eap-8.0\bin

  3. Start JBoss EAP 8:

    code language-cmd 
    standalone.bat -b 0.0.0.0 -bmanagement 0.0.0.0

Aanvankelijke opstarten van monitor

Bekijk de consoleoutput voor:

  1. Plaatsing van WAR:

    code language-none 
    Deployed "cq-quickstart.war" (runtime-name : "cq-quickstart.war")

  2. AEM Initialization Berichten:

    code language-none 
    Apache Sling Application Launcher
Sling Home: crx-repository/crx-quickstart

  3. Verbetering van de Bewaarplaats (als toepasselijk):

    code language-none 
    Performing repository migration...

Verwachte Opstarttijd: 5-15 minuten afhankelijk van bewaarplaatsomvang en systeemmiddelen.

Stap 10: Verifieer het Succes van de Verbetering

AEM starten controleren

Controleer de JBoss console voor het definitieve startbericht:

**** AEM started successfully ****

Access AEM Interface

  1. Webbrowser openen

  2. Navigeren naar:

    code language-none 
    http://localhost:8080/cq-quickstart

  3. Aanmelden met beheerdersreferenties:

    • Gebruikersnaam: admin
    • Wachtwoord: admin (of uw aangepaste wachtwoord)

Systeemgegevens verifiëren

  1. Navigeer aan Hulpmiddelen → Verrichtingen → Console van het Web

    code language-none 
    http://localhost:8080/cq-quickstart/system/console

  2. Klik Informatie van het Systeem

  3. Controleren:

    • JVM Versie: zou Java 21 moeten tonen
    • JBoss Versie: zou EAP 8.x moeten tonen
    • Versie van AEM: zou 6.5.xx moeten tonen

Systeemstatus controleren

Navigeer aan Hulpmiddelen → Verrichtingen → Diagnose om gezondheidscontroles in werking te stellen:

  • Bundlestatus: alle bundels moeten actief zijn
  • Bronresolutie: gezonde status weergeven
  • Prestaties van query: revisie voor elke degradatie

Taken na upgrade

Aangepaste configuraties herstellen

  1. Het back-upbestand sling.properties controleren

  2. Herstel alle aangepaste uitvoermodi of configuraties naar het nieuwe bestand:

    code language-none 
    <JBOSS_HOME>\bin\crx-repository\crx-quickstart\conf\sling.properties

  3. Start AEM opnieuw als de configuraties zijn gewijzigd

Replicatieagents bijwerken

  1. Navigeer aan Hulpmiddelen → Plaatsing → Replicatie → Agenten op Auteur
  2. Alle replicatieagents controleren en testen
  3. Verwijzingen naar oude serverpaden naar codes bijwerken

Kritieke functionaliteit testen

  • [ ] Inhoud schrijven en publiceren
  • [ ] Middelen uploaden en verwerken
  • [ ] Workflow-uitvoering
  • [ ] Gebruikersverificatie
  • [ ] Eindpunten van integratie
  • [ ] Aangepaste componenten en sjablonen

Optimalisatie van prestaties

  1. Eventuele tijdelijke caches controleren en wissen
  2. Systeemprestaties controleren bij eerste gebruik
  3. Pas JVM-instellingen indien nodig aan op basis van werkelijke gebruikspatronen

Problemen oplossen

Vaak voorkomende problemen

Probleem
Mogelijke oorzaak
Oplossing
AEM start niet
Onjuiste Java-versie
JAVA_HOME punten naar JDK 21 verifiëren
Fouten in gegevensopslagruimte
Onvolledige kopie van gegevensopslagruimte
Herstellen vanaf back-up- en herkopieeropslagplaats
OutOfMemoryError
Onvoldoende heapgeheugen
-Xmx vergroten in standalone.conf.bat
Bundels in status "Geïnstalleerd"
Ontbrekende afhankelijkheden
Bundelafhankelijkheden controleren in webconsole
Poort 8080 is al in gebruik
Een andere service die poort gebruikt
Conflicterende service stoppen of JBoss-poort wijzigen

Locatie logbestand

  • JBoss Logboek van de Server:
    <JBOSS_HOME>\standalone\log\server.log

  • Logboek van de Fout van AEM:
    <JBOSS_HOME>\bin\crx-repository\crx-quickstart\logs\error.log

  • Logboek van de Toegang van AEM:
    <JBOSS_HOME>\bin\crx-repository\crx-quickstart\logs\access.log

Terugkeerprocedure

Als de upgrade mislukt en niet kan worden opgelost:

  1. JBoss EAP 8 stoppen
  2. De volledige back-up van JBoss EAP 7.4 herstellen
  3. De map crx-repository herstellen
  4. Verifieer JAVA_HOME punten aan JDK 11 (als het terugrollen)
  5. De vorige omgeving starten

Aanbevolen procedures

Voor implementatie van productie

  • [ ] Test het volledige upgradeproces in een ontwikkelomgeving
  • [ ] Testen in een testomgeving met productieachtige gegevens
  • [ ] Alle aangepaste configuraties en integratie documenteren
  • [ ] Een gedetailleerd rollback-plan maken
  • [ ] Upgrade plannen tijdens onderhoudsvenster
  • [ ] Alle betrokkenen op de hoogte stellen van geplande downtime

Na geslaagde upgrade

  • [ ] Systeemlogboeken 48-72 uur bijhouden
  • [ ] Laad het testen uit om prestatieskwesties te identificeren
  • [ ] Systeemdocumentatie bijwerken
  • [ ] Train team op alle JBoss EAP 8-verschillen
  • [ ] Alle upgradedocumentatie en back-ups archiveren

Verwante documentatie

Documentgegevens

Veld
Waarde
Documentversie
1,0
Laatst bijgewerkt
februari 2026
AEM-versie
6,5 LTS
Source-platform
JBoss EAP 7.4 / JDK 11
Doelplatform
JBoss EAP 8.x / JDK 21
Besturingssysteem
Windows Server

Juridische Bericht: Adobe, Adobe Experience Manager, en AEM zijn gedeponeerd handelsmerken van Adobe Inc. JBoss en Red Hat zijn gedeponeerd handelsmerken van Red Hat, Inc.

recommendation-more-help
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2