Show Menu
ARGOMENTI×

Risoluzione dei problemi

Questa sezione contiene informazioni dettagliate sui registri disponibili per la risoluzione dei problemi e include anche informazioni su alcuni dei problemi che potrebbero verificarsi con AEM.

Risoluzione dei problemi relativi alle prestazioni dell'autore

L’analisi di prestazioni lente sull’istanza Authoring può diventare piuttosto complessa. Come primo passo è necessario determinare su quale livello dello stack tecnologico le prestazioni diminuiscono.
La seguente struttura decisionale fornisce indicazioni per ridurre il collo di bottiglia.

Ottimizzazione di base

Configurazione dei file di registro e dei registri di controllo

AEM registra i registri dettagliati che potresti voler configurare per risolvere eventuali problemi di installazione. Per ulteriori informazioni, vedere la sezione Uso dei record di controllo e dei file di registro.

Utilizzo dell’opzione Verbose

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 nella console, in modo che possa essere utilizzata per la risoluzione dei problemi.

Problemi comuni di installazione

La sezione seguente descrive alcuni problemi di installazione e le relative soluzioni.

Se si fa doppio clic sul file JAR non si verifica alcun effetto o si apre il file JAR con un altro programma (ad esempio, archive manager)

In genere indica un problema con la configurazione dell'ambiente desktop del sistema operativo per l'apertura di file con estensione .jar. Potrebbe inoltre indicare che non è installato Java o che si sta utilizzando una versione non supportata di Java.
Poiché i file JAR utilizzano il formato ZIP onnipresente, alcuni dei programmi di archiviazione possono configurare automaticamente il desktop per aprire i file JAR come file di archivio.
Per risolvere i problemi, effettuate le seguenti operazioni:
  • Verificate che sia installata almeno la versione 1.6 di Java.
  • Prova a utilizzare il menu di scelta rapida di AEM WCM (in genere fai clic con il pulsante destro del mouse) e seleziona "Apri con...."
  • Verificate l'elenco di Java o Sun Java e provate a eseguire AEM WCM con esso. Se avete installato più versioni Java, selezionate quella supportata.
    Se avete successo con questo passaggio e i sistemi operativi offrono un'opzione per utilizzare sempre il programma selezionato per eseguire i file .jar, selezionatelo. Il doppio clic dovrebbe funzionare da ora in poi.
  • A volte la reinstallazione della versione Java supportata consente di ripristinare l'associazione corretta.
  • È sempre possibile eseguire CRX utilizzando la riga di comando o gli script start/stop come descritto in precedenza in questo documento.

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

Vedere anche Analisi dei problemi di memoria.
Il CRX stesso ha un'ingombro di memoria molto basso. Se l'applicazione in esecuzione in CRX ha requisiti di memoria maggiori o richiede operazioni con molta memoria (ad esempio, transazioni di grandi dimensioni), l'istanza JVM in cui è in esecuzione CRX deve essere avviata con le impostazioni di memoria appropriate.
Utilizzare le opzioni di comando Java per definire le impostazioni di memoria della JVM (ad esempio, java -Xmx512m -jar crx&ast;.jar per impostare l'altezza su 512 MB).
Specificate l'opzione di impostazione della memoria quando avviate AEM WCM dalla riga di comando. Gli script di avvio/arresto di AEM WCM o gli script personalizzati per la gestione dell'avvio di AEM WCM possono essere modificati anche per definire le impostazioni di memoria richieste.
Se avete già definito la dimensione dell’heapsize a 512 MB, potete analizzare ulteriormente il problema della memoria creando un’immagine di dump dell’heap:
Per creare automaticamente un heap dump quando la memoria è esaurita, utilizza il seguente comando:
java -Xmx256m -XX:+HeapDumpOnOutOfMemoryError -jar &ast;.jar
Questo genera un file di dump heap ( java_...hprof ) ogni volta che il processo non dispone di memoria sufficiente. Il processo può continuare a essere eseguito dopo la generazione del dump dell'heap. Solitamente, un file di dump heap è sufficiente per analizzare il problema.

La schermata di benvenuto di AEM non viene visualizzata nel browser quando si fa 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. Ciò può dipendere dalla configurazione del sistema operativo, dalla configurazione del browser o da fattori simili.
Il sintomo abituale è che la finestra AEM WCM Quickstart visualizza "AEM WCM start up, in attesa dell’avvio del server...." Se il messaggio viene visualizzato per un periodo di tempo relativamente lungo, immettete manualmente l’URL WCM AEM nella finestra del browser, utilizzando la porta predefinita 4502 o la porta su cui è in esecuzione l’istanza: http://localhost:4502/.
Inoltre, i registri potrebbero rivelare il motivo per cui il browser non si avvia.
A volte, la finestra AEM WCM Quickstart contiene il messaggio "AEM WCM in esecuzione su http://localhost:port/" e il browser non si avvia automaticamente. In questo caso, fate clic sull’URL nella finestra di avvio rapido di AEM WCM (si tratta di un collegamento ipertestuale) o immettete manualmente l’URL nel browser.
Se tutto il resto non riesce, controllare i registri per scoprire cosa è successo.

Risoluzione dei problemi relativi alle installazioni con un server applicazioni

Pagina non trovata restituita quando si richiede una pagina geometrixx-outdoor

Applicabile a WebLogic 10.3.5 e JBoss 5.1
Quando una richiesta a pagina geometrixx-outdoors/en restituisce un 404 (Page Not Folio), potete verificare di aver impostato la proprietà sling aggiuntiva nel file sling.properties necessario per questi Application Server specifici.
Consultate i passaggi dell’applicazione Web Implementare AEM per i dettagli.

La dimensione dell'intestazione della risposta può essere maggiore di 4 Kb

502 errori possono indicare che il server Web non è in grado di gestire le dimensioni dell’intestazione della risposta AEM HTTP. AEM può generare intestazioni di risposta HTTP che includono cookie di dimensioni maggiori di 4 Kb. Accertatevi che il contenitore del servlet sia configurato in modo che la dimensione massima dell’intestazione della risposta possa superare i 4 kb.
Ad esempio, per Tomcat 7.0, l’attributo maxHttpHeaderSize del connettore http.html HTTP controlla le limitazioni delle dimensioni dell’intestazione.

Uninstalling Adobe Experience Manager

Poiché AEM viene installato in una singola directory, non è necessaria alcuna utility di disinstallazione. La disinstallazione può essere semplice come l’eliminazione dell’intera directory di installazione, anche se la modalità di disinstallazione di AEM dipende da ciò che si desidera ottenere e dallo spazio di archiviazione permanente utilizzato.
Se la memorizzazione persistente è incorporata nella directory di installazione, ad esempio, nell'installazione predefinita di TarPM, l'eliminazione di cartelle rimuove anche i dati.
Adobe consiglia vivamente di eseguire il backup del repository prima di eliminare AEM. Se si elimina l'intero <cq-install-directory>, si elimina il repository. Per conservare i dati del repository prima di eliminare, spostare o copiare la cartella <cq-install-directory>/crx-quickstart/repository altrove prima di eliminare le altre cartelle.
Se l’installazione di AEM utilizza uno spazio di archiviazione esterno, ad esempio un server di database, la rimozione della cartella non comporta la rimozione automatica dei dati, ma comporta la rimozione della configurazione dello storage, il che rende difficile il ripristino del contenuto JCR.

I file JSP non sono compilati su JBoss

Se installate o aggiornate i file JSP in Experience Manager su JBoss e i servlet corrispondenti non vengono compilati, accertatevi che il compilatore JSP sia configurato correttamente. Per informazioni, consultate l'articolo sui problemi di compilazione JSP in JBoss .