Problemi comuni di installazione

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).

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:

  • Verifica di avere installato almeno Java™ versione 1.6.

  • Prova un menu contestuale (in genere con un clic con il pulsante destro del mouse) su AEM WCM Quickstart e seleziona "Apri con"…

  • Verifica se Java™ o Sun Java™ è elencato e prova a eseguire AEM WCM con esso. Se hai installato più versioni di Java™, seleziona quella supportata.

    Se si esegue questo passaggio e il sistema operativo in uso offre l'opzione di utilizzare sempre il programma selezionato per eseguire i file .jar, selezionarlo. D’ora in poi il doppio clic dovrebbe funzionare.

  • A volte la reinstallazione della versione Java™ supportata aiuta a ripristinare l’associazione corretta.

  • È sempre possibile eseguire CRX utilizzando la riga di comando o gli script di avvio/arresto come descritto in precedenza in questo documento.

La mia applicazione in esecuzione su CRX genera errori di memoria insufficiente

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 AEM WCM o gli script personalizzati per la gestione dell'avvio di AEM WCM 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:

  • Prima che si verifichi un errore
  • Durante l'errore 1
  • Durante l'errore 2
  • Sarebbe opportuno raccogliere informazioni anche dopo la risoluzione dell'evento

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

NOTA
Se raccogli regolarmente tali informazioni o hai esperienza nella lettura delle immagini heap, un file dell’immagine heap può essere sufficiente per analizzare il problema.

La schermata iniziale di AEM non viene visualizzata nel browser dopo aver fatto doppio clic su AEM Quickstart

In alcune situazioni, le schermate di benvenuto di AEM WCM 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 AEM WCM Quickstart viene visualizzato "Avvio di AEM WCM in corso, in attesa dell’avvio del server"… Se il messaggio viene visualizzato per un periodo di tempo relativamente lungo, immetti manualmente l’URL di AEM WCM 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, nella finestra AEM WCM Quickstart viene visualizzato il messaggio "AEM WCM in esecuzione su http://localhost:port/" e il browser non si avvia automaticamente. In questo caso, fai clic sull’URL nella finestra AEM WCM Quickstart (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

Si è verificato un problema noto con AEM 6.5 in esecuzione su Java™ 11, a causa del quale il sito web potrebbe non venire caricato o non funzionare in modo intermittente.

Se si verifica questo problema, eseguire le operazioni seguenti:

  1. Apri il file sling.properties nella cartella crx-quickstart/conf/

  2. Individua la seguente riga:

    org.osgi.framework.bootdelegation=sun.,com.sun.

  3. Sostituiscilo con quanto segue:

    org.osgi.framework.bootdelegation=sun.,com.sun.,jdk.internal.reflect,jdk.internal.reflect.*

  4. Riavvia l’istanza.