Linee guida per l’aggiornamento di AEM Forms JEE per la compatibilità con versione, sistema operativo, JBoss e piattaforma
I clienti che aggiornano AEM Forms su JEE, passando a un service pack più recente, eseguendo la migrazione tra versioni RHEL o scegliendo tra le versioni 6.5.x e 6.5 LTS, devono avere una conferma autorevole delle piattaforme supportate prima di procedere. AEM Forms su JEE impone una rigida compatibilità tra i livelli del sistema operativo, JBoss, Java e database e le combinazioni supportate risiedono nella matrice della piattaforma di Adobe, ma è necessario effettuare la mappatura nell’ambiente specifico. Se la convalida non viene eseguita, si rischia di installare file binari non supportati o di eseguire il commit a un percorso di aggiornamento che non riesce. Confermare la combinazione di sistema operativo, JBoss e Java rispetto alla matrice, ottenere i programmi di installazione corretti e applicare il service pack o l’aggiornamento LTS in sequenza risolve l’incertezza.
Descrizione description
Ambienti:
- Adobe Experience Manager Forms su JEE
- Adobe Experience Manager 6.5 (on-premise)
- Adobe Experience Manager 6.5 LTS
- JBoss EAP 7.4.x e JBoss EAP 8
- Red Hat Enterprise Linux e Windows Server
Problema/Sintomi:
- Non è chiaro quali versioni di AEM Forms supportino piattaforme OS specifiche, come RHEL 8, RHEL 9 e Windows Server 2022.
- C’è incertezza sulle versioni EAP o Java JBoss compatibili per una specifica versione di AEM Forms, come JBoss 7.4.22 con SP22 o Java 17 e 21 con LTS.
- La richiesta è intesa a confermare in modo autorevole le piattaforme supportate, la disponibilità del programma di installazione, i prerequisiti e la sequenza di aggiornamento, anziché risolvere i problemi.
Causa principale:
AEM Forms su JEE impone una rigida compatibilità tra i livelli del sistema operativo, JBoss, Java e database, pertanto le combinazioni devono essere convalidate prima di aggiornare o applicare un service pack. Adobe documenta le combinazioni supportate nella matrice della piattaforma, ma queste devono essere interpretate e mappate correttamente nell’ambiente. Se non si confermano le combinazioni supportate, si rischia di installare binari non supportati o di pianificare un percorso di aggiornamento che non riesce.
Risoluzione resolution
Per risolvere il problema, segui la procedura riportata di seguito:
- Identifica la versione corrente di AEM Forms JEE e i componenti della piattaforma. Raccogli la versione del sistema operativo, la versione EAP JBoss, la versione Java e il tipo di database. Confermarli eseguendo
java -version, controllando la versione della console EAP JBoss ed eseguendo i comandi di rilascio del sistema operativo comecat /etc/redhat-releasesu RHEL. - Determinare se la destinazione è un aggiornamento del service pack o una migrazione LTS. 6.5 LTS richiede Java 17 o 21 e JBoss EAP 8, mentre gli aggiornamenti del service pack 6.5.x rimangono su Java 8 o 11 e JBoss 7.4.x. Questo indica se eseguire la destinazione 6.5.24 (SP24) o 6.5 LTS.
- Convalidare il supporto della piattaforma utilizzando la matrice ufficiale delle piattaforme supportate. Conferma che il sistema operativo (RHEL 8, RHEL 9 o Windows Server 2022) e la versione JBoss siano visualizzati nella matrice per la versione di destinazione. Se la piattaforma non è elencata, seleziona una versione del sistema operativo e di JBoss esplicitamente supportata prima dell’aggiornamento.
- Per le migrazioni OS (da RHEL 7 a RHEL 8 o da RHEL 8 a RHEL 9), confermare la fattibilità. RHEL 8 richiede SP11 o versione successiva e RHEL 9 supporta SP23 e SP24. Abbina il sistema operativo di destinazione alle versioni supportate nella matrice. Se la versione in uso non supporta il sistema operativo di destinazione, pianificare una migrazione fuori sede utilizzando un nuovo server.
- Scaricare il programma di installazione completo e il service pack corretti da Adobe Software Distribution, inclusi il programma di installazione completo SP23, la patch SP24 e i componenti aggiuntivi Forms. I nomi dei file corrispondono a pattern quali
aemforms_server_6_5_0_jboss_all_unix.tar.gzoadobe-aem-forms-jee-servicepack-6.5.24.0-win-jboss.zip. Se i file non vengono visualizzati in Software Distribution, verifica che l’Adobe ID disponga delle adesioni corrette in Admin Console. - Preparati per l’aggiornamento. Esegui il backup delle directory CRX, di GDS, TEMP e del database e conferma che i backup esistano con le marche temporali prima di procedere.
- Installa il nuovo programma di installazione completo di AEM Forms JEE. Avviare JBoss e confermare che
/lcviene caricato. Se la distribuzione non riesce, controlla i registri JBoss per individuare eventuali errori di distribuzione e convalida le librerie del sistema operativo. - Applicare il service pack più recente (SP24) e i componenti aggiuntivi Forms. Installare la patch SP24 per JBoss su Linux o Windows, quindi installare i componenti OSGi SP24 (frammento di servlet, service pack e componente aggiuntivo Forms). Selezionare
/lc/system/console/bundlesper confermare che i bundle non generano più errori continui. In caso contrario, reinstallare il frammento del servlet o verificare cheerror.lognon contenga dipendenze. - Per gli aggiornamenti JBoss, verifica le variabili di ambiente richieste. Imposta
DISABLE_JDK_SERIAL_FILTER= true durante l’aggiornamento di JBoss EAP 7.4.x, quindi conferma l’avvio di JBoss senza errori di serializzazione. Se gli errori di serializzazione persistono, verifica che la variabile sia esportata correttamente nello script di avvio JBoss. - Convalida l’ambiente aggiornato. Avviare JBoss, accedere a
/adminuie testare i moduli chiave come PDF Generator, la connettività di Workbench e le estensioni di Reader. Verificare cheerror.lognon contenga nuove analisi dello stack o messaggi continui.