Risoluzione dei problemi di installazione con AEM troubleshooting

Questa sezione include informazioni dettagliate sui registri disponibili per aiutarti a risolvere eventuali problemi e informazioni su alcuni dei problemi che potresti riscontrare con l’AEM.

Risolvere i problemi relativi alle prestazioni dell'autore troubleshoot-author-performance

L’analisi delle prestazioni lente nell’istanza di authoring può diventare complessa. Come primo passo è necessario capire a quale livello dello stack tecnologico le prestazioni stanno diminuendo.

Il seguente albero decisionale fornisce indicazioni per ridurre il collo di bottiglia.

Ottimizzazione di base basic-optimization

Configurazione dei file di registro e dei registri di controllo configuring-log-files-and-audit-logs

AEM registra registri dettagliati che è possibile configurare per la risoluzione dei problemi di installazione. Per informazioni, vedere la sezione Utilizzo dei record di controllo e dei file di registro.

Utilizzo dell'opzione Dettagliato using-the-verbose-option

Quando si avvia AEM WCM, è possibile aggiungere l'opzione -v (verbose) alla riga di comando come in: java -jar cq-wcm-quickstart-<versione>.jar -v.

L’opzione dettagliata visualizza parte dell’output del registro Quickstart sulla console, in modo che possa essere utilizzato per la risoluzione dei problemi.

Problemi comuni di installazione common-installation-issues

Nella sezione seguente vengono descritti alcuni problemi di installazione e le relative soluzioni.

Fare doppio clic sul file JAR Quickstart non ha alcun effetto o apre il file JAR con un altro programma (ad esempio, Archive Manager). double-clicking-the-quickstart-jar-does-not-have-any-effect-or-opens-the-jar-file-with-another-program-for-example-archive-manager

Questo problema indica in genere un problema relativo alla configurazione dell'ambiente desktop del sistema operativo per l'apertura di file con estensione .jar. Potrebbe anche indicare che non hai installato Java™ o che stai utilizzando una versione di Java non supportata™.

Poiché i file jar utilizzano il formato ZIP onnipresente, alcuni programmi di archiviazione possono configurare automaticamente il desktop per aprire i file jar come file di archivio.

Per risolvere i problemi, effettuare le seguenti operazioni:

La mia applicazione in esecuzione su CRX genera errori di memoria insufficiente my-application-running-on-crx-throws-out-of-memory-errors

La stessa CRX ha un ingombro di memoria ridotto. Se l’applicazione in esecuzione in CRX ha requisiti di memoria più elevati o richiede operazioni che richiedono molta memoria (ad esempio, transazioni di grandi dimensioni), l’istanza JVM in cui viene eseguito CRX deve essere avviata con le impostazioni di memoria appropriate.

Utilizza le opzioni di comando Java™ per definire le impostazioni di memoria della JVM (ad esempio, java -Xmx512m -jar crx*.jar per impostare heapsize su 512 MB).

Specificare l'opzione di impostazione della memoria durante l'avvio di AEM WCM dalla riga di comando. È inoltre possibile modificare gli script di avvio/arresto di WCM AEM o gli script personalizzati per la gestione dell'avvio di WCM AEM per definire le impostazioni di memoria richieste.

Se hai già definito l’heapsize su 512 MB, puoi analizzare ulteriormente il problema della memoria creando un’immagine heap.

Per creare automaticamente un’immagine heap quando la memoria è esaurita, utilizza il comando seguente:

java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar *.jar

Questo metodo genera un file dell'immagine heap (java_…hprof) ogni volta che il processo esaurisce la memoria. Il processo può continuare a essere eseguito dopo la generazione dell’immagine heap.

Spesso per analizzare il problema sono necessari tre file dell’immagine heap, raccolti in un periodo di tempo:

Questi possono essere confrontati per vedere le modifiche e come gli oggetti usano la memoria.

La schermata iniziale dell’AEM non viene visualizzata nel browser dopo aver fatto doppio clic su AEM Quickstart the-aem-welcome-screen-does-not-display-in-the-browser-after-double-clicking-aem-quickstart

In determinate situazioni, le schermate di benvenuto di WCM per AEM non vengono visualizzate automaticamente anche se l’archivio stesso è in esecuzione correttamente. Questo problema può dipendere dalla configurazione del sistema operativo, dalla configurazione del browser o da fattori simili.

Il sintomo comune è che nella finestra QuickStart per WCM per AEM viene visualizzato "Avvio di WCM per AEM in attesa dell’avvio del server"… Se il messaggio viene visualizzato per un periodo di tempo relativamente lungo, immettere manualmente l'URL WCM AEM nella finestra del browser, utilizzando la porta 4502 predefinita o la porta su cui è in esecuzione l'istanza: http://localhost:4502/.

Inoltre, i registri possono rivelare il motivo per cui il browser non si avvia.

A volte, la finestra Quickstart di WCM AEM ha il messaggio "WCM AEM in esecuzione su http://localhost:port/" e il browser non si avvia automaticamente. In questo caso, fai clic sull’URL nella finestra QuickStart di AEM WCM (si tratta di un collegamento ipertestuale) o immetti manualmente l’URL nel browser.

Se tutto il resto non funziona, controlla i registri per scoprire cosa è successo.

Il sito web non viene caricato o ha esito negativo a intermittenza con Java™ 11 the-website-does-not-load-or-fails-intermittently-with-java11

Esiste un problema noto con l’AEM 6.5 in esecuzione su Java™ 11, in cui il sito web potrebbe non venire caricato o non riuscire a intermittenza.

Se si verifica questo problema, eseguire le operazioni seguenti:

Risoluzione dei problemi relativi alle installazioni con un server applicazioni troubleshooting-installations-with-an-application-server

Pagina non trovata restituita durante la richiesta di una pagina geometrixx-outdoor page-not-found-returned-when-requesting-a-geometrixx-outdoor-page

Si applica a WebLogic 10.3.5 e JBoss® 5.1

Quando una richiesta inviata a geometrixx-outdoors/en page restituisce un valore 404 (Pagina non trovata), è possibile verificare di aver impostato la proprietà sling aggiuntiva nel file sling.properties necessaria per questi Application Server specifici.

Per informazioni dettagliate, consulta i passaggi Distribuisci applicazione Web AEM.

La dimensione dell’intestazione di risposta può essere maggiore di 4 KB response-header-size-can-be-greater-than-kb

Gli errori 502 possono indicare che il server web non è in grado di gestire le dimensioni dell’intestazione di risposta HTTP AEM. L’AEM può generare intestazioni di risposta HTTP che includono cookie di dimensioni superiori a 4 KB. Assicurati che il contenitore del servlet sia configurato in modo che la dimensione massima dell’intestazione di risposta possa superare i 4 KB.

Ad esempio, per Tomcat 7.0, l'attributo maxHttpHeaderSize del connettore HTTP controlla le limitazioni relative alla dimensione dell'intestazione.

Disinstallazione di Adobe Experience Manager uninstalling-adobe-experience-manager

Poiché l'AEM viene installato in un'unica directory, non è necessario utilizzare un'utilità di disinstallazione. La disinstallazione può essere semplice come l'eliminazione dell'intera directory di installazione, anche se il modo in cui si disinstalla AEM dipende da cosa si desidera ottenere e quale storage persistente si utilizza.

Se l'archiviazione persistente è incorporata nella directory di installazione, ad esempio nell'installazione TarPM predefinita, l'eliminazione delle cartelle comporta anche la rimozione dei dati.

Se l’installazione dell’AEM utilizza uno storage esterno, ad esempio un server di database, la rimozione della cartella non rimuove automaticamente i dati, ma rimuove la configurazione di archiviazione, rendendo difficile il ripristino del contenuto JCR.

I file JSP non sono compilati su JBoss® jsp-files-are-not-compiled-on-jboss

Se installi o aggiorni i file JSP per l’Experience Manager su JBoss® e i servlet corrispondenti non vengono compilati, assicurati che il compilatore JSP JBoss® sia configurato correttamente. Per informazioni, vedere
Problemi di compilazione JSP nell'articolo JBoss®.