1.0 Introduzione
2.0 Software supportato e specifiche
3.0 Limitazioni
3.1 Funzione di protezione non disponibile
3.2 Aggiornamento di Agent Controller su Linux
3.3 Possibile problema di avvio di Agent Controller su AIX
3.4 Aggiornamento di Windows Installer alla versione 2.0
3.5 Errore 1920 durante l'installazione
3.6 Altri errori durante l'installazione e la disinstallazione
3.7 Errore di memoria insufficiente
4.0 Problemi noti
4.1 Apertura e visualizzazione dei file di traccia
4.2 Importazione dei file di log
4.3 Visualizzazione di file di dimensioni superiori nella vista Interazioni log
4.4 Chiamate di riferimento automatico nascoste ignorati dalle viste Interazioni log
4.5 Supporto per le viste Interazioni agente e Interazioni processo
4.6 Importazione file di log da Solaris
4.7 Impossibile importare un file di log contenente caratteri
non ASCII
4.8 Presenza di metodi e dati di classe duplicati dopo aver ricollegato l'agente
4.9 IBM HTTP Server 1.3.26.2 non elencato nella procedura guidata Importazione
4.10 Impossibile modificare
le proprietà dell'agente dopo l'avvio o il collegamento
In questo file Readme vengono descritti gli strumenti di analisi e di creazione profili relativi alle prestazioni e alla memoria disponibili nelle prospettive Creazione profili e log del workbench (incluse le viste log).
Ulteriore documentazione
Guida per l'utilizzo degli esempi
Nel programma di analisi dei log e delle tracce, scegliere File > Nuovo > Esempio... e selezionare la vista Esempi di analisi log e correlazione. Selezionare la voce di menu Correlazione log Apache/Esempi di analisi e fare clic su Avanti. Quindi scegliere Fine. L'esempio verrà creato automaticamente.
Guida per la creazione dei programmi di analisi, motori di correlazione e motori di analisi
Queste guide sono disponibili all'indirizzo http://dev.eclipse.org/viewcvs/indextools.cgi/~checkout~/hyades-home/docs/doc.html
Creazione profilo di un'applet Java
Per creare il profilo di un'applet Java creata in Eclipse:Tenere presente che il profilo del processo può anche essere creato in modalità Abilitato. Per ulteriori dettagli, fare riferimento alla documentazione su RAC.
- 1. Nel menu Esegui e selezionare Esegui...
- 2. Selezionare Applet Java quindi scegliere Nuovo.
- 3. Selezionare la scheda Argomenti.
- 4. Specificare quanto segue nel campo Argomenti VM:
-XrunpiAgent:server=controlled
- 5. Scegliere Esegui. Tenere presente che l'applicazione non verrà eseguita fino a quando il processo non viene collegato.
- 6. Passare alla prospettiva Creazione profili e log.
- 7. Nel menu Profilo selezionare Collega->Processo Java.
- 8. Utilizzare la procedura guidata per collegare il processo.
- 9. Avviare il controllo dell'agente. A questo punto l'applicazione dovrebbe essere in esecuzione.
Il file readme Utilizzo degli esempi di registrazione comuni di Hyades Apache, non indica il nome agente di registrazione corretto nel punto 3 della sezione relativa ai passaggi di esecuzione. Il nome corretto è org.eclipse.hyades.logging.commons.sample.HyadesLoggingCommonsSample.
La funzione di protezione di IBM Agent Controller non è disponibile. Quando viene richiesto di abilitare o attivare la protezione durante l'installazione, selezionare Disabilita o no.
Se si desidera aggiornare Agent Controller su Linux dalla versione 5.0.1 o da una versione precedente, è necessario prima disinstallare la versione con il comando:
rpm -e ibmrac-5.0.1-0Dopo aver disinstallato la versione precedente, sarà possibile installare la nuova versione con il comando:rpm -U ibmrac-5.1.0-0.i386.rpm
Il messaggio di errore in fase di avvio di Agent Controller su AIX è il seguente:
Impossibile avviare RAServer.Di solito, questo problema si verifica quando la porta 10002 TCP/IP viene utilizzata da un altro processo in esecuzione sul sistema o quando Agent Controller è stato appena arrestato.Soluzione alternativa: se la porta 10002 è utilizzata da un altro processo è possibile modificare il numero di porta editando il file serviceconfig.xml. Questa modifica è descritta nella documentazione.
Se la versione di Windows Installer è precedente a 2.0, l'aggiornamento verrà eseguito automaticamente. Per effettuare l'aggiornamento è necessario eseguire il riavvio. L'installazione di Agent Controller riprenderà automaticamente dopo il riavvio del sistema.
Se si rileva l'errore 1920 di Windows Installer durante l'installazione, significa che si è verificato un problema relativo all'avvio del servizio IBM Agent Controller. Generalmente, la causa del problema è la presenza di un file denominato Program nell'unità di sistema. Ad esempio, se Windows è installato nell'unità D:, la presenza di un file denominato Program in D:\ interromperà l'avvio del servizio Agent Controller se è stato nella posizione predefinita D:\Program Files\IBM\IBM Agent Controller. Ciò si verifica perché Windows tenta di avviare il servizio Agent Controller come D:\Program Files\IBM\IBM Agent Controller\bin\RAServer.exe che non è corretto.Per evitare questo problema:
- Eliminare o ridenominare il file Program.
- Installare Agent Controller utilizzando una directory senza spazi (ad esempio, D:\IBM_Agent_Controller).
- Nel registro Windows, nel nome di chiave HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\IBM Agent Controller\ImagePath, aggiungere doppi apici all'inizio e alla fine del nome file eseguibile relativo ad Agent Controller. Ad esempio:
"D:\Program Files\IBM\IBM Agent Controller\bin\RAServer.exe"
Se si rilevano errori durante l'installazione o la disinstallazione, la causa potrebbe essere il caricamento dei file di oggetti di Agent Controller effettuato durante l'esecuzione dei processi. Per accertarsi che i file di oggetti possono essere modificati, procedere come segue:
- Chiudere il workbench.
- Terminare tutti i processi java.exe che contengono Java Profiling Agent o J2EE Request Profiler.
- Chiudere la finestra Servizi.
A volte, il workbench può esaurire la memoria a disposizione se deve gestire una grande quantità di dati. Questo succede in momenti diversi, in base al JRE utilizzato. Ad esempio, in alcuni casi, SUN 1.4.1 esaurirà la memoria a disposizione prima di IBM 1.3.1 o IBM 1.4.1.
Soluzione alternativa: utilizzare l'argomento -Xmx JVM per aumentare lo spazio Heap. È preferibile utilizzare il valore -Xmx200M, anche se è possibile che vengano richieste quantità superiori in base alla configurazione del computer utilizzato e dall'applicazione.
I file di traccia di WebSphere Application Server generati utilizzando il formato di output di Log Analyzer non possono essere aperti e visualizzati utilizzando gli strumenti di registrazione.
Soluzione alternativa: impostare il formato di output della traccia di WebSphere Application Server su Base o Avanzato prima di generare file di traccia da aprire e visualizzare utilizzando gli strumenti di registrazione log.
È possibile importare nello spazio di lavoro file di log di dimensioni fino a 25 MB e aprirli con il programma di analisi appropriato. La quantità di tempo necessaria ad aprire il file dipende dal numero di record presenti nel file ed è possibile che venga ricevuta un'eccezione di "memoria insufficiente".
Soluzione alternativa: aumentare la memoria all'avvio di Eclipse procedendo come segue:
"eclipse.exe -vmargs -Xmx800M" o aggiungere più memoria fisica al computer.
Se nella vista Interazioni log vengono visualizzati file di dimensioni superiori, la panoramica Diagramma sequenza non conterrà alcun file di log. Il pulsante Panoramica appare spostato dalla parte inferiore alla parte superiore della vista, ma la vista non ha alcuna larghezza.
Soluzione alternativa: nessuna.
L'opzione che consente di nascondere le chiamate di riferimento automatico presente nella pagina Preferenze per le viste Diagramma sequenza (Finestra > Preferenze > Creazione profili e log > Diagramma sequenza) viene ignorata dalle viste Interazioni log.
Soluzione alternativa: nessuna.
Le viste Interazioni agente e Interazioni processo non sono supportate dalla vista Diagramma sequenza per i file di log.
Soluzione alternativa: nessuna.
Non è possibile importare correttamente i file di log da Solaris.
Soluzione alternativa: nessuna. Il driver Solaris non è stabile e un aggiornamento verrà fornito in futuro.
Se il contenuto di un file di log contiene caratteri non ASCII (ad esempio, 0xFF 0xFB ... ) il file non verrà importato correttamente.
Soluzione alternativa: rimuovere i caratteri non ASCII dal file di log.
Se si collega nuovamente lo stesso agente allo stesso progetto e destinazione di controllo, verranno creati classi e metodi duplicati.
Se si prevede collegare l'agente ad un altra risorsa, scollegare Agent Controller.
Soluzione alternativa: selezionare Sospendi controllo per interrompere la raccolta dei dati di profilo e successivamente, selezionare nuovamente Avvia controllo per riprendere la creazione del profilo.
The IBM HTTP Server versione 1.3.26.2 non è elencato nella procedura guidata Importazione come formato di log supportato. Questo server viene utilizzato in WebSphere Application Server versione 5.0.2. È possibile importare i log da IBM HTTP Server 1.3.26.2 utilizzando la versione 1.3.26.1.
Dopo aver creato un agente mediante avvio o collegamento, non sarà possibile applicare le modifiche alle proprietà dell'agente, ad esempio opzioni o filtri.
Soluzione alternativa: scollegare e ricollegare l'agente con i nuovi filtri e opzioni ad un controllo diverso.
Visualizza il file Readme principale
(C) Copyright IBM Corporation 2000, 2003. Tutti i diritti riservati.