DocumentazioneExperience Cloud KCS

Aggiornamento di AEM Forms 6.5 tra Service Pack in JEE e OSGi

Ultimo aggiornamento: 23 giugno 2026

I clienti di AEM Forms devono affrontare l’incertezza relativa al percorso di aggiornamento corretto quando si spostano tra i service pack di AEM 6.5, perché i componenti Forms vengono forniti separatamente dalle distribuzioni principali di AEM Service Pack e JEE e OSGi utilizzano flussi di installazione diversi. Adobe distribuisce diversi pacchetti per service pack: il programma di installazione cumulativo JEE, il componente aggiuntivo OSGi, gli hotfix e i pacchetti di compatibilità, in modo da poter identificare con facilità quali sono applicabili a un dato ambiente. Si tratta di una domanda di configurazione, non di un difetto del software. L’identificazione del tipo di runtime, la conferma della versione corrente e l’installazione dei pacchetti giusti nell’ordine corretto producono un aggiornamento pulito.

Descrizione description

Problema: selezione del percorso di aggiornamento corretto del service pack di AEM Forms 6.5 per JEE e OSGi

Descrizione

Il passaggio da un service pack di AEM 6.5 a un altro, ad esempio da SP18 a SP24, da SP20 a SP23 o da SP23 con un hotfix a SP24, solleva domande su quali pacchetti applicare e in quale ordine installarli. Domande frequenti riguardano il supporto degli aggiornamenti diretti, la rimozione degli aggiornamenti rapidi esistenti, il componente aggiuntivo Forms da installare, il programma di installazione delle patch JEE e la gestione dei requisiti della piattaforma, ad esempio WebSphere, JBoss, Windows o Linux.

Ambiente:

  • AEM Forms 6.5 (On-Premises)
  • Runtime OSGi
  • Runtime JEE (WebSphere, WebLogic, JBoss)
  • Piattaforme Windows e Linux

Problema/Sintomi:

  • Incertezza su quale service pack o componente aggiuntivo di AEM Forms installare, incluse più build di componenti aggiuntivi per lo stesso service pack
  • Dubbi sul supporto di un percorso di aggiornamento diretto (ad esempio, SP18 → SP24 o SP20 → SP23)
  • Domande sulla rimozione degli hotfix esistenti prima di applicare un service pack più recente
  • Indicazioni poco chiare su quando sono necessarie le patch JEE rispetto ai pacchetti del componente aggiuntivo OSGi

Causa principale:

Gli aggiornamenti di AEM Forms richiedono passaggi dipendenti dalla piattaforma, in quanto i componenti Forms vengono forniti separatamente dal Service Pack principale di AEM e le distribuzioni JEE e OSGi utilizzano flussi di installazione e patch diversi. Poiché Adobe distribuisce più pacchetti per service pack (un programma di installazione cumulativo JEE, un componente aggiuntivo OSGi, hotfix e pacchetti di compatibilità), è facile interpretare erroneamente quali pacchetti si applicano a un dato ambiente. Il problema è l’incertezza della configurazione, non un difetto del software.

Come confermare

  1. Identifica il tipo di runtime. Accedere ad AEM e verificare se /lc è presente. Se /lc/login viene caricato, è JEE; se vengono caricati solo /aem/start.html, è OSGi. Gli ambienti JEE utilizzano i file EAR/WAR e Configuration Manager.
  2. Confermare la versione del service pack corrente. Passare a /system/console/productinfo e controllare la sezione Prodotti installati, ad esempio Adobe Experience Manager (6.5.23.0).
  3. Verifica la compatibilità della piattaforma. Prima di eseguire l’aggiornamento, confrontare il sistema operativo, Java, il server applicazioni e le versioni del database con la matrice delle piattaforme supportata.

Risoluzione resolution

  1. Selezionare il percorso di aggiornamento corretto in base al Service Pack iniziale:

    • Da SP18 o SP20, è supportato un aggiornamento diretto a SP24 o SP23.
    • Da SP11, aggiornare prima i componenti della piattaforma sottostante, quindi passare a SP24.
    • Se si utilizza SP23 con un hotfix, procedere normalmente e non rimuovere l’hotfix: i service pack sono cumulativi.

  2. OSGi — installa il Service Pack principale di AEM 6.5: Carica aem-service-pkg-6.5.xx.x.zip in Gestione pacchetti CRX e fai clic su Installa. Visitare /system/console/productinfo per confermare gli aggiornamenti della versione SP e verificare che tutti i bundle siano ACTIVE o FRAGMENT. Se l’installazione non riesce, verificare la presenza di errori di dipendenza in error.log.

  3. OSGi: installare il pacchetto del componente aggiuntivo Forms corretto: identificare e installare la build del componente aggiuntivo corrispondente al service pack e alla piattaforma. Controllare /system/console/bundles per verificare che i bundle di AEM Forms siano nello stato ACTIVE. Se l’installazione non riesce, riavvia AEM e riprova.

  4. OSGi — installare ulteriori hotfix solo se pertinenti: Applicare le correzioni necessarie, ad esempio gli hotfix di sicurezza Granite. Confermare i componenti aggiornati in /system/console/productinfo e verificare i prerequisiti degli aggiornamenti rapidi nella pagina dei dettagli di Software Distribution.

  5. JEE - installare il programma di installazione della patch JEE associato: Eseguire il programma di installazione della patch JEE per il Service Pack di destinazione. Verificare che Configuration Manager riconosca la versione aggiornata. In caso di errore, raccogli i registri di Configuration Manager.

  6. JEE - riavviare il server applicazioni: Eseguire un riavvio pulito di WebSphere, WebLogic o JBoss utilizzando gli script del server applicazioni nativi. Confermare che i registri del server applicazioni non mostrino errori di distribuzione. Se gli EAR non riescono a distribuire, verifica la presenza di voci JNDI, origini dati o percorsi di archivio mancanti.

  7. Convalida l’aggiornamento completo (JEE e OSGi): Accedi ad AEM e conferma il caricamento di Forms adattivo, flussi di lavoro e altre funzionalità di Forms. Esaminare i bundle e le pagine di informazioni sul prodotto e controllare error.log per individuare eventuali pacchetti mancanti o errori di dipendenza.

Convalida

  1. Passare a /system/console/productinfo e verificare che la versione SP sia visualizzata correttamente (ad esempio: Adobe Experience Manager (6.5.24.0)).
  2. Verifica che tutti i bundle OSGi siano ACTIVE o FRAGMENT tramite /system/console/bundles.
  3. Per JEE, conferma tutti gli EAR distribuiti senza errori esaminando i registri del server applicazioni dopo il riavvio.
  4. Esegui un flusso di lavoro di base di Forms o esegui il rendering di un modulo adattivo per confermare la stabilità del runtime.

Lettura correlata

recommendation-more-help
experience-cloud-kcs-help-kbarticles