Upgrade naar AEM 6.5 Forms LTS op OSGi upgrade-to-aem-forms-osgi
Aan verbetering van AEM 6.5 aan AEM 6.5 LTS , verbetering aan AEM 6.5.22.0 Forms of later. Een directe upgrade van AEM 6.5.22.0 naar AEM 6.5 Forms LTS wordt ondersteund.
Als u AEM 6.0 Forms, AEM 6.1 Forms, AEM 6.2 Forms, AEM 6.3 Forms, AEM 6.4 Forms of AEM 6.5 Forms gebruikt, is een directe upgrade naar AEM 6.5 Forms LTS niet beschikbaar. Voor gedetailleerde verbeteringswegen, verwijs naar de documentatie van de Wegen van de Verbetering .
Na upgrade naar het servicepack AEM Forms 6.5.22.0 voert u de volgende stappen uit om te upgraden naar AEM 6.5 LTS Forms:
-
Installeer het AEM Forms-invoegtoepassingspakket. De stappen worden hieronder weergegeven:
-
Open Distributie van de Software . U hebt een Adobe ID nodig om u aan te melden bij de softwaredistributie.
-
Selecteer Adobe Experience Manager beschikbaar in het koptekstmenu.
-
In de sectie Filters :
- Selecteer Forms in de vervolgkeuzelijst Solution .
- Selecteer de versie en typ voor het pakket. U kunt de optie Search Downloads ook gebruiken om de resultaten te filteren.
-
Selecteer de pakketnaam die van toepassing is op het besturingssysteem, selecteer Accept EULA Terms en selecteer Download .
-
Open Manager van het Pakket en klik Upload Package om het pakket te uploaden.
-
Selecteer het pakket en klik op Install .
U kunt het pakket ook downloaden gebruikend de directe verbinding die in wordt vermeld versies van AEM Forms artikel.
Nadat het pakket is geïnstalleerd, wordt u gevraagd om het AEM-exemplaar opnieuw te starten. stop niet onmiddellijk de server. Voordat u de AEM Forms-server stopt, wacht u tot de berichten ServiceEvent REGISTERED en ServiceEvent UNREGISTERED niet meer worden weergegeven in het bestand <crx-repository>/error.log en het logbestand stabiel is. Houd er rekening mee dat een aantal pakketten in de installatiestatus kunnen blijven staan. U kunt de status van deze verpakkingen veilig negeren.
begin de instantie van AEM met de volgende extra bevel-lijn JVM parameters opnieuw:
--add-opens java.base/java.util=ALL-UNNAMED --add-exports=java.xml/com.sun.org.apache.xml.internal.serialize=ALL-UNNAMEDAls de server via een script of service wordt gestart, moet u de server overeenkomstig bijwerken zodat het bovenstaande wordt opgenomen zodat deze ook van kracht zijn nadat de server opnieuw is gestart.
note note NOTE U wordt aangeraden de SDK opnieuw op te starten met de opdracht 'Ctrl + C'. Het opnieuw opstarten van de AEM SDK met behulp van alternatieve methoden, bijvoorbeeld het stoppen van Java-processen, kan leiden tot inconsistenties in de AEM-ontwikkelomgeving.
-
-
Nainstallatie uitvoeren.
-
het Nut van de Migratie van de Looppas
Het migratiehulpprogramma maakt de adaptieve formulieren en het beheer van correspondentie van eerdere versies compatibel met AEM 6.5-formulieren. U kunt het hulpprogramma downloaden van AEM Software Distribution. Voor geleidelijke informatie om het migratienut te vormen en te gebruiken, zie migratienut .
Als u Steekproef voor het integreren van concepten & voorleggingscomponent met het gegevensbestand en de bevordering van een vorige versie gebruikt, dan stel de volgende SQL vragen na het uitvoeren van de verbetering in werking:
code language-sql UPDATE metadata m, additionalmetadatatable am SET m.dataType = am.value WHERE m.id = am.id AND am.key = 'dataType'code language-sql DELETE from additionalmetadatatable WHERE `key` = 'dataType' -
(Als u een upgrade uitvoert van alleen AEM 6.2 Forms of eerdere versies) Adobe Sign opnieuw configureren
Als Adobe Sign was geconfigureerd in de vorige versie van AEM Forms, configureert u Adobe Sign vervolgens opnieuw vanuit de AEM Cloud-services. Voor meer details, zie het Teken van Adobe met AEM Forms integreren.
-
Steun voor jQuery
In AEM 6.5 Forms wordt de versie van jQuery bijgewerkt naar versie 3.2.1 en de versie van jQuery-gebruikersinterface naar versie 1.12.1. De Vorm van AEM gebruikt JQuery op noConflict wijze. Als u dus een andere jQuery-versie gebruikt, worden er geen problemen weergegeven tijdens het uitvoeren van een upgrade. Als u echter een upgrade uitvoert naar AEM 6.5 Forms:
- Controleer of uw aangepaste componenten, indien aanwezig, compatibel zijn met ondersteunde jQuery-versies.
- Verwijder niet-ondersteunde API's uit de aangepaste componenten. Zie verbeteringsgids voor de lijst van verwijderde APIs. Ondersteuning voor de API's load(), .unload() en .error() wordt bijvoorbeeld verwijderd. Gebruik de methode .on() in plaats van de eerder genoemde API's. Wijzig bijvoorbeeld $("img").load(fn) in $("img").on("load", fn).
-
(Als u een upgrade uitvoert van alleen AEM 6.2 Forms of eerdere versies) Analyses en rapporten opnieuw samenstellen
In AEM 6.4 Forms is de verkeersvariabele voor de bron- en succesgebeurtenis voor de indruk niet beschikbaar. Als u dus een upgrade uitvoert van AEM 6.2 Forms of eerdere versies, stopt AEM Forms met het verzenden van gegevens naar de Adobe Analytics-server en zijn er geen analyserapporten voor adaptieve formulieren beschikbaar. Bovendien introduceert AEM 6.4 Forms een verkeersvariabele voor de versie van formulieranalyse en succesgebeurtenis voor de hoeveelheid tijd die aan een veld wordt doorgebracht. Configureer daarom analyses en rapporten voor uw AEM Forms-omgeving. Voor gedetailleerde stappen, zie het Vormen analyses en rapporten .
-
-
Controleer of de upgrade van de server is geslaagd, of alle gegevens zijn gemigreerd en of deze op de normale manier kunnen werken.
-
verifieer het statuut van de bundels: zorg ervoor dat alle bundels in actieve staat zijn.
-
verifieer replicatie en omgekeerde replicatie: publiceer, vul, en verzend een paar gemigreerde vormen. Controleer ook de verzonden gegevens.
-
verifieer toegang tot admin en het gebruikersinterfaces van de ontwikkelaar: Login aan de instantie van AEM van een admin rekening en verifieer dat u toegang tot volgende URLs hebt:
https://'[server]:[port]'/crx/packmgrhttps://'[server]:[port]'/crx/dehttps://'[server]:[port]'/aem/forms.html/content/dam/formsanddocuments
note note NOTE In AEM 6.4 Forms is de structuur van crx-repository veranderd. Als u een upgrade uitvoert van 6.3 Forms naar AEM 6.5 Forms, gebruikt u de gewijzigde paden voor aanpassing die u opnieuw maakt. Voor de volledige lijst van veranderde wegen, zie de Herstructurering van de Bewaarplaats van Forms in AEM . -
AEM implementeren op JBoss EAP 8 (Windows)
Overzicht
Deze handleiding bevat stapsgewijze instructies voor de implementatie van Adobe Experience Manager (AEM) als een zelfstandig OSGi WAR-bestand op het JBoss Enterprise Application Platform (EAP) 8 in een Windows-omgeving met JDK 21.
Systeemvereisten
Voordat u met het implementatieproces begint, moet u ervoor zorgen dat uw omgeving aan de volgende vereisten voldoet:
JAVA_HOME naar de installatiemap van JDK 21 verwijst.Stap 1: JBoss EAP 8 installeren
JBoss EAP downloaden
-
Navigeer naar de portal Red Hat Developer:
https://developers.redhat.com/products/eap/download -
Download de JBoss EAP 8 ZIP-distributie voor Windows.
JBoss EAP extraheren
-
Pak het gedownloade ZIP-bestand uit naar de gewenste installatiemap.
-
Maak een notitie van dit mappad als
<JBOSS_HOME>voor gebruik in deze handleiding.Voorbeeld:
C:\jboss-eap-8.0
Stap 2: Het AEM WAR-bestand voorbereiden
AEM WAR verkrijgen
Haal het AEM WAR-bestand op bij Adobe Software Distribution of bij uw Adobe-vertegenwoordiger.
Naam WAR-bestand wijzigen
Wijzig de naam van het WAR-bestand om het gewenste URL-contextpad weer te geven:
cq-quickstart.war
cq-quickstart.war is bijvoorbeeld toegankelijk via /cq-quickstart .Stap 3: De AEM WAR configureren
Alle configuratiewijzigingen moeten worden voltooid alvorens opstellend aan JBoss.
Werkmap maken
-
Een tijdelijke werkmap maken:
code language-none C:\aem\war-config -
Kopieer
cq-quickstart.warnaar deze map.
WAR-inhoud extraheren
-
Open Herinnering van het Bevel en navigeer aan uw werkende folder:
code language-cmd cd C:\aem\war-config -
Extraheer het WAR-bestand:
code language-cmd jar -xvf cq-quickstart.warHiermee maakt u een mappenstructuur met
WEB-INFen andere toepassingsbestanden.
Stap 4: JBoss-implementatiebeschrijving configureren
Implementatiestructuurbestand maken
-
Navigeer naar de map
WEB-INFin de geëxtraheerde WAR:code language-cmd cd WEB-INF -
Maak een nieuw bestand met de naam
jboss-deployment-structure.xml. -
Voeg de volgende XML-inhoud toe:
code language-xml <?xml version="1.0" encoding="UTF-8"?> <jboss-deployment-structure xmlns="urn:jboss:deployment-structure:1.2"> <deployment> <dependencies> <module name="jdk.unsupported" /> </dependencies> </deployment> </jboss-deployment-structure> -
Sla het bestand op en sluit het.
Doel: Deze configuratie verleent toegang tot interne modules JDK die door AEM worden vereist.
Stap 5: Multipart-uploadinstellingen configureren
Web.xml wijzigen
-
Open
WEB-INF\web.xmlin een teksteditor. -
Zoek de sectie
<servlet>met de configuratie van de uitvoeringsmodus:code language-xml <!-- Set the runmode per default to author --> <init-param> <param-name>sling.run.modes</param-name> <param-value>author</param-value> </init-param> <load-on-startup>100</load-on-startup> </servlet> -
Vervang de afsluitende tag
</servlet>en de voorafgaande regel door:code language-xml <init-param> <param-name>sling.run.modes</param-name> <param-value>author</param-value> </init-param> <multipart-config> <max-file-size>1048576000</max-file-size> <max-request-size>1048576000</max-request-size> <file-size-threshold>0</file-size-threshold> </multipart-config> <load-on-startup>100</load-on-startup> </servlet> -
Opslaan en sluiten
web.xml.
Doel: Deze montages laten grote dossieruploads (tot 1 GB) voor AEM Forms en het Beheer van Digitale Activa toe.
Stap 6: Het WAR-bestand opnieuw verpakken
Nadat alle configuratiewijzigingen zijn voltooid, moet u het WAR-bestand opnieuw verpakken.
-
Ga terug naar de werkmap met de geëxtraheerde inhoud:
code language-cmd cd C:\aem\war-config -
Maak het nieuwe WAR-bestand:
code language-cmd jar -cvf cq-quickstart.war *
Stap 7: AEM implementeren en starten
WAR implementeren in JBoss
-
Kopieer het opnieuw verpakte
cq-quickstart.warnaar de JBoss-implementatiemap:code language-none <JBOSS_HOME>\standalone\deploymentsVoorbeeld:
C:\jboss-eap-8.0\standalone\deployments
JVM-instellingen configureren (optioneel maar aanbevolen)
Voordat u JBoss start, configureert u JVM-geheugeninstellingen:
-
Open
<JBOSS_HOME>\bin\standalone.conf.batin een teksteditor. -
Wijzig of voeg de volgende lijn toe om heapgeheugen te plaatsen:
code language-batch set "JAVA_OPTS=-Xms4096m -Xmx4096m -XX:MaxMetaspaceSize=512m"
- Sla het bestand op en sluit het.
JBoss EAP starten
-
Open Herinnering van het Bevel als Beheerder.
-
Navigeer naar de map JBoss bin:
code language-cmd cd <JBOSS_HOME>\binVoorbeeld:
cmd cd C:\jboss-eap-8.0\bin -
Start de JBoss-server:
code language-cmd standalone.bat -b 0.0.0.0 -bmanagement 0.0.0.0Parameters:
-b 0.0.0.0— Bind de server aan alle netwerkinterfaces-bmanagement 0.0.0.0— Bindt de beheerinterface aan alle netwerkinterfaces
Monitorimplementatie
Kijk naar de consoleuitvoer voor implementatieberichten. Succesvolle implementatie wordt aangegeven door:
Deployed "cq-quickstart.war" (runtime-name : "cq-quickstart.war")
Stap 8: Toegang tot AEM
Zodra de implementatie is voltooid en AEM volledig is gestart:
AEM Auteur URL:http://<server-ip>:8080/cq-quickstart
StandaardReferenties:
- Gebruikersnaam:
admin - Wachtwoord:
admin
Belangrijk: verander onmiddellijk het standaardwachtwoord na eerste login.
Problemen oplossen
Vaak voorkomende problemen
jboss-deployment-structure.xml correct is geconfigureerdstandalone.conf.bat<JBOSS_HOME>\standalone\log\server.logLogbestanden
- JBoss Logboek van de Server:
<JBOSS_HOME>\standalone\log\server.log - Logboek van de Fout van AEM: Beschikbaar door de Console van het Web van AEM na opstarten bij
http://<server-ip>:8080/cq-quickstart/system/console
Aanvullende configuratie
Run-modi configureren
Als u AEM-uitvoeringsmodi wilt wijzigen (auteur/publicatie), wijzigt u de parameter sling.run.modes in WEB-INF\web.xml voordat u de WAR opnieuw verpakt:
<init-param>
<param-name>sling.run.modes</param-name>
<param-value>publish</param-value>
</init-param>
Productieaanbevelingen
Voor productieomgevingen:
- SSL/TLS-certificaten configureren in JBoss
- AEM-replicatieagents instellen
- Dispatcher configureren voor taakverdeling
- Automatische back-ups inschakelen
- Implementeren van toezicht en waarschuwingen