Per utilizzare l'utility DSTrace in un ambiente Linux, eseguire il comando seguente al prompt del server:
/opt/novell/eDirectory/bin/ndstrace
La sintassi completa del comando ndstrace è la seguente:
ndstrace [-l|-u|-c "command1;......"|--version] [-h <local_interface:port>] [--config-file <configuration_file_path>] [thrd <thread ID>] [svty <severity_level>] [conn <connection_ID>]
L'utility di DSTrace è costituita da tre parti principali:
Le funzioni di base di DSTrace servono per:
Visualizzare le attività interne di eDirectory e i messaggi di debug in Linux.
Avviare processi limitati di sincronizzazione.
È possibile utilizzare l'utility DSTrace in modalità interfaccia utente o in modalità riga di comando. Per impostazione di default, DSTrace viene eseguito in modalità interfaccia utente. Se si desidera avviare DSTrace in modalità interfaccia utente, immettere il comando seguente al prompt del server:
/opt/novell/eDirectory/bin/ndstrace
Per avviare DSTrace in modalità riga di comando, immettere il comando seguente al prompt:
/opt/novell/eDirectory/bin/ndstrace -l
Per avviare le funzioni di base di DSTrace, immettere i comandi al prompt del server utilizzando la sintassi seguente:
ndstrace command_option
La tabella che segue descrive le opzioni relative ai comandi che è possibile specificare.
|
Opzione |
Descrizione |
|---|---|
|
ATTIVO |
Avvia lo schermo di controllo di eDirectory con messaggi di controllo di base. |
|
INATTIVO |
Disabilita lo schermo di controllo. |
|
ALL |
Avvia lo schermo di controllo di eDirectory con tutti i messaggi di controllo. |
|
AGENT |
Avvia lo schermo di controllo di eDirectory con i messaggi di controllo equivalenti ai flag ON, BACKLINK, DSAGENT, JANITOR, RESNAME e VCLIENT. |
|
DEBUG |
Attiva un gruppo predefinito di messaggi di controllo utilizzati solitamente per il debug. I flag impostati sono: ON, BACKLINK, ERRORS, EMU, FRAGGER, INIT, INSPECTOR, JANITOR, LIMBER, MISC, PART, RECMAN, REPAIR, SCHEMA, SKULKER, STREAMS e VCLIENT. |
|
NODEBUG |
Lascia abilitato lo schermo di controllo ma disattiva tutti i messaggi di debug precedentemente impostati. Inoltre, lascia i messaggi impostati sull'opzione di comando ON. |
Se lo schermo DSTrace è abilitato, le informazioni visualizzate si basano su un set di filtri di default. Se si desidera visualizzare più o meno filtri, è possibile regolarli usando i flag dei messaggi di debug. I messaggi di debug consentono di determinare lo stato di eDirectory e di verificare che tutto funzioni correttamente.
Per ogni processo di eDirectory è disponibile un set di messaggi di debug. Per visualizzare i messaggi di debug relativi a un particolare processo, utilizzare il segno più (+) e l'opzione o il nome del processo. Per disabilitare la visualizzazione di un processo, utilizzare il segno meno (-) e l'opzione o il nome del processo. Di seguito sono riportati alcuni esempi:
|
Messaggio |
Descrizione |
|---|---|
|
set ndstrace = +SYNC |
Consente di abilitare i messaggi di sincronizzazione. |
|
set ndstrace = -SYNC |
Consente di disabilitare i messaggi di sincronizzazione. |
|
set ndstrace = +SCHEMA |
Consente di abilitare i messaggi relativi allo schema. |
È inoltre possibile combinare i flag dei messaggi di debug utilizzando gli operatori booleani & (vale a dire AND) e | (vale a dire OR). La sintassi per controllare i messaggi di debug dalla console del server è la seguente:
set ndstrace = <trace_flag> [parameter]
Nella tabella seguente sono riportati i flag di traccia per i messaggi di debug. Per ciascun flag di traccia è possibile immettere un'abbreviazione.
|
Flag di traccia |
Descrizione |
|---|---|
|
ABUF |
Messaggi e informazioni relativi ai buffer dei pacchetti in entrata e in uscita contenenti dati ricevuti insieme o in risposta a una richiesta di eDirectory. |
|
ALOC |
Messaggi che visualizzano i dettagli dell'allocazione della memoria. |
|
AREQ |
Messaggi relativi a richieste in entrata da altri client o server. |
|
AUTH |
Messaggi e segnalazioni di errore relativi all'autenticazione. |
|
BASE |
Messaggi di errore del debug al livello minimo di debug. |
|
BLNK |
Messaggi di backlink e necrologi in entrata e rapporti sugli errori. |
|
CBUF |
Messaggi relativi a richieste dei client DS in uscita. |
|
CHNG |
Messaggi relativi a modifiche della cache. |
|
COLL |
Rapporti sullo stato e sugli errori relativi alle informazioni di aggiornamento di un oggetto se l'aggiornamento è stato ricevuto in precedenza. |
|
CONN |
Messaggi che visualizzano informazioni sui server a cui il server in uso sta tentando di connettersi, nonché sugli errori e i timeout che potrebbero impedire la connessione del server. |
|
DNS |
Messaggi relativi ai processi di server DNS integrati in eDirectory. |
|
DRLK |
Messaggi di collegamento ai riferimenti distribuiti. |
|
DVRS |
Messaggi che visualizzano le aree specifiche del driver DirXML® in cui è possibile che eDirectory sia in esecuzione. |
|
DXML |
Messaggi che visualizzano dettagli relativi agli eventi DirXML. |
|
FRAG |
Messaggi del fragger NCP™ che suddivide i messaggi di eDirectory in base alla dimensione NCP. |
|
IN |
Messaggi relativi a processi e richieste in entrata. |
|
INIT |
Messaggi relativi all'inizializzazione di eDirectory. |
|
INSP |
Messaggi relativi all'integrità degli oggetti nel database locale del server di origine. L'uso di questo flag aumenta l'utilizzo delle risorse di memoria, processore e sistema di memorizzazione su disco nel server di origine. Abilitare questo flag solo in caso di danneggiamento degli oggetti. |
|
JNTR |
Messaggi relativi ai seguenti processi in background: pulizia interna, sincronizzazione delle repliche e Flat Cleaner. |
|
LDAP |
Messaggi relativi al server LDAP. |
|
LMBR |
Messaggi relativi al processo Limber. |
|
LOCK |
Messaggi relativi all'utilizzo e alla modifica di blocchi del database locale nel server di origine. |
|
LOST |
Messaggi relativi alle voci perse. |
|
MISC |
Messaggi provenienti da origini diverse in eDirectory. |
|
MOVE |
Messaggi relativi alle operazioni di spostamento della partizione o del sottoalbero. |
|
NCPE |
Messaggi che visualizzano le richieste a livello NCP ricevute dal server. |
|
NMON |
Messaggi relativi a iMonitor. |
|
OBIT |
Messaggi relativi al processo di necrologia. |
|
PART |
Messaggi relativi alle operazioni sulle partizioni eseguite da processi in background e dall'elaborazione delle richieste. |
|
PURG |
Messaggi relativi al processo di eliminazione definitiva. |
|
RECM |
Messaggi relativi alla modifica del database del server di origine. |
|
RSLV |
Rapporti relativi all'elaborazione delle richieste di risoluzione dei nomi. |
|
SADV |
Messaggi relativi alla registrazione dei nomi degli alberi e delle partizioni con protocollo SLP (Service Location Protocol). |
|
SCMA |
Messaggi relativi al processo di sincronizzazione dello schema. |
|
SCMD |
Messaggi che visualizzano i dettagli delle operazioni correlate allo schema. Le informazioni riguardano sia la sincronizzazione in entrata che quella in uscita. |
|
SKLK |
Messaggi relativi al processo di sincronizzazione delle repliche. |
|
SPKT |
Messaggi relativi a informazioni a livello di server NCP di eDirectory. |
|
STRM |
Messaggi relativi all'elaborazione di attributi con una sintassi di flusso. |
|
SYDL |
Messaggi che visualizzano maggiori dettagli durante il processo di replica. |
|
SYNC |
Messaggi relativi al traffico di sincronizzazione in entrata (ricevuto dal server). |
|
TAGS |
Visualizzazione della stringa del tag che identifica l'opzione di traccia che ha generato l'evento in ciascuna riga visualizzata dal processo di traccia. |
|
THRD |
Messaggi che mostrano quando inizia e quando finisce ciascun processo in background (thread). |
|
TIME |
Messaggi relativi ai vettori transitivi utilizzati durante il processo di sincronizzazione. |
|
TVEC |
Messaggi relativi agli attributi seguenti: Sincronizza fino a, Replica fino a e Vettore transitivo. |
|
VCLN |
Messaggi relativi alle connessioni con altri server stabilite o eliminate. |
Utilizzando i messaggi di debug in DSTrace, si noterà che alcuni flag di traccia sono più utili di altri. Una delle impostazioni preferite di DSTrace utilizzate dal supporto di NetIQ è in effetti un collegamento:
set ndstrace = A81164B91
Questa impostazione attiva un gruppo di messaggi di debug.
Oltre ai messaggi di debug, che consentono di controllare lo stato di eDirectory, è possibile utilizzare un set di comandi che forzano l'esecuzione dei processi in background di eDirectory. Per forzare l'esecuzione di un processo in background, inserire un asterisco (*) prima del comando. Ad esempio:
set ndstrace = *H
Per alcuni dei processi in background è inoltre possibile modificare lo stato, l'intervallo e il controllo. Per modificare questi valori, inserire un punto esclamativo (!) prima del comando e specificare un nuovo parametro o valore. Ad esempio:
set ndstrace = !H 15 (parameter_value_in_minutes)
Di seguito è riportata la sintassi di ciascuna istruzione di controllo per i processi in background di eDirectory:
set ndstrace = <trace_flag> [parameter]
Nella tabella seguente sono riportati i flag di traccia per i processi in background, eventuali parametri obbligatori e la descrizione del processo.
|
Flag di traccia |
Parametri |
Descrizione |
|---|---|---|
|
*Un file |
Nessuno |
Reimposta la cache degli indirizzi nel server di origine. |
|
*AD |
Nessuno |
Disabilita la cache degli indirizzi nel server di origine. |
|
*AE |
Nessuno |
Abilita la cache degli indirizzi nel server di origine. |
|
*B |
Nessuno |
Pianifica il processo backlink affinché venga avviato nel server di origine entro un secondo. |
|
!B |
Ora |
Imposta l'intervallo, in minuti, per il processo backlink. Default = 1.500 minuti (25 ore), intervallo = da 2 a 10.080 minuti (168 ore) |
|
*CT |
Nessuno |
Visualizza la tabella delle connessioni in uscita del server di origine e le informazioni statistiche attuali per la tabella. Tali statistiche non forniscono informazioni sulle connessioni in entrata eseguite da altri server o client al server di origine. |
|
*CTD |
Nessuno |
Visualizza, in formato delimitato da virgole, la tabella delle connessioni in uscita del server di origine e le informazioni statistiche attuali per la tabella. Tali statistiche non forniscono informazioni sulle connessioni in entrata eseguite da altri server o client al server di origine. |
|
*D |
ID voce radice |
Rimuove l'ID voce locale specificato dall'elenco di tutti gli oggetti inviati del server di origine. L'ID voce deve indicare un oggetto Root della partizione specifico del database locale del server. In genere questo comando viene utilizzato solo quando un processo di invio di tutti gli aggiornamenti tenta incessantemente e senza riuscire di visualizzare gli aggiornamenti, perché un server non è accessibile. |
|
!D |
Ora |
Imposta l'intervallo di sincronizzazione in entrata e in uscita sul numero di minuti specificato. Default = 24 minuti. Intervallo = da 2 a 10.080 minuti (168 ore) |
|
!DI |
Ora |
Imposta l'intervallo di sincronizzazione in entrata sul numero di minuti specificato. Default = 24 minuti, intervallo = da 2 a 10.080 minuti (168 ore) |
|
!DO |
Ora |
Imposta l'intervallo di sincronizzazione in uscita sul numero di minuti specificato. Default = 24 minuti, intervallo = da 2 a 10.080 minuti (168 ore) |
|
*E |
Nessuno |
Reinizializza la cache voci nel server di origine. |
|
!E |
Nessuno |
Pianifica il processo di sincronizzazione in entrata e in uscita in modo che venga avviato. |
|
!EI |
Nessuno |
Pianifica il processo di sincronizzazione in entrata in modo che venga avviato. |
|
!EO |
Nessuno |
Pianifica il processo di sincronizzazione in uscita in modo che venga avviato. |
|
*F |
Nessuno |
Pianifica il processo Flat Cleaner, incluso nel processo di pulizia interna, in modo che venga avviato nel server di origine entro cinque secondi. |
|
!F |
Ora |
Imposta l'intervallo, in minuti, per il processo Flat Cleaner. Default = 240 minuti (4 ore), intervallo = da 2 a 10.080 minuti (168 ore) |
|
*FL |
1-10 |
Imposta il numero di file di log in sequenza utilizzati da DSTrace. Se si imposta questo parametro su un valore maggiore di 1, quando il file ndstrace.log del server di origine raggiunge la dimensione massima configurata, DSTrace assegna al file il nome ndstrace1.log e crea un nuovo file ndstrace.log. Quando tale file raggiunge la dimensione massima, al file ndstrace1.log precedente viene assegnato il nome ndstrace2.log e al più recente ndstrace.log il nome ndstrace1.log. Questo processo continua fino a quando DSTrace non raggiunge il numero massimo di file di log in sequenza impostato per questa opzione. Una volta raggiunto il limite specificato, i file di log meno recenti vengono eliminati per mantenere solo il numero massimo specificato di file in sequenza. È possibile configurare un massimo di 10 file di log in sequenza. DSTrace deve utilizzare di default almeno un file di log in sequenza. Se si imposta questo parametro su 0, DSTrace utilizza 1 come valore del parametro. |
|
*G |
ID voce radice |
Ricompila la cache delle modifiche dell'ID di partizione della radice specificato. |
|
*H |
Nessuno |
Pianifica il processo di sincronizzazione della replica in modo che venga avviato immediatamente sul server di origine. |
|
!H |
Ora |
Imposta l'intervallo (in minuti), per il processo di sincronizzazione dell'heartbeat. Default = 30 minuti, intervallo = da 2 a 1.440 minuti (24 ore) |
|
*HR |
Nessuno |
Cancella l'ultimo vettore inviato nella memoria. |
|
*I |
ID voce radice |
Aggiunge l'ID voce locale specificato all'elenco di tutti gli oggetti inviati del server di origine. L'ID voce deve indicare un oggetto Root della partizione specifico del database locale del server. Il processo di sincronizzazione della replica controlla l'elenco di tutti gli oggetti inviati. Se l'ID voce di un oggetto Root della partizione è incluso nell'elenco, in eDirectory vengono sincronizzati tutti gli oggetti e gli attributi della partizione, indipendentemente dal valore dell'attributo Sincronizzato fino a. |
|
!I |
Ora |
Imposta l'intervallo (in minuti), per il processo di sincronizzazione dell'heartbeat. Default = 30 minuti, intervallo = da 2 a 1.440 minuti (24 ore) |
|
*J |
Nessuno |
Pianifica il processo di eliminazione definitiva, incluso nel processo di sincronizzazione delle repliche, in modo che venga avviato nel server di origine. |
|
!J |
Ora |
Imposta l'intervallo, in minuti, per il processo di pulizia interna. Default = 2 minuti, intervallo = da 1 a 10.080 minuti (168 ore) |
|
*L |
Nessuno |
Pianifica il processo Limber affinché venga avviato nel server di origine entro cinque secondi. |
|
*M |
byte |
Modifica la dimensione massima utilizzata dal file ndstrace.log del server di origine. È possibile utilizzare questo comando indipendentemente dallo stato del file di debug. Il valore in byte specificato deve essere compreso tra 10.000 byte e 100 MB. Se il valore è superiore o inferiore all'intervallo specificato, non viene apportata alcuna modifica. |
|
!M |
Nessuno |
Indica la quantità massima di memoria utilizzata da eDirectory. |
|
!N |
0|1 |
Imposta il formato del nome. 0 = solo esadecimale, 1 = formato a punti completo |
|
*P |
Nessuno |
Visualizza parametri regolabili e le relative impostazioni di default. |
|
*R |
Nessuno |
Reimposta la dimensione del file ndstrace.log a zero byte. Questo comando corrisponde al parametro SET per la lunghezza del file di traccia NDS impostato su zero. |
|
*S |
Nessuno |
Pianifica il processo Skulker, che controlla se una o più repliche nel server devono essere sincronizzate. |
|
!SI |
Ora |
Imposta l'intervallo, in minuti, per il processo di sincronizzazione in entrata dello schema. Default = 24 minuti, intervallo = da 2 a 10.080 minuti (168 ore) |
|
!SO |
Ora |
Imposta l'intervallo, in minuti, per il processo di sincronizzazione in uscita dello schema. Default = 24 minuti, intervallo = da 2 a 10.080 minuti (168 ore) |
|
!SIO |
Ora |
Disabilita il processo di sincronizzazione dello schema in entrata per il numero di minuti specificato. Default = 24 minuti, intervallo = da 2 a 10.080 minuti (168 ore) |
|
!SO0 |
Ora |
Disabilita il processo di sincronizzazione dello schema in entrata per il numero di minuti specificato. Default = 24 minuti, intervallo = da 2 a 10.080 minuti (168 ore) |
|
*SS |
Nessuno |
Forza la sincronizzazione immediata dello schema. |
|
*SSA |
Nessuno |
Pianifica il processo di sincronizzazione dello schema in modo che venga avviato immediatamente e imposta la sincronizzazione dello schema di tutti i server di destinazione, anche se sono stati sincronizzati nelle ultime 24 ore. |
|
*SSD |
Nessuno |
Reimposta l'elenco di sincronizzazione dello schema di destinazione del server di origine. Tale elenco identifica i server con cui sincronizzare il server di origine durante il processo di sincronizzazione dello schema. Un server in cui non risiede alcuna replica invia una richiesta di inclusione nell'elenco di destinazioni di un server contenente una replica con il relativo oggetto Server. |
|
*SSL |
Nessuno |
Stampa l'elenco di sincronizzazione dello schema dei server di destinazione. |
|
*ST |
Nessuno |
Visualizza le informazioni sullo stato per i processi di background sul server di origine. |
|
*STX |
Nessuno |
Visualizza le informazioni sullo stato per il processo backlink (riferimenti esterni) nel server di origine. |
|
*STS |
Nessuno |
Visualizza le informazioni sullo stato del processo di sincronizzazione dello schema nel server di origine. |
|
*STO |
Nessuno |
Visualizza le informazioni sullo stato del processo backlink (necrologi) nel server di origine. |
|
*STL |
Nessuno |
Visualizza le informazioni sullo stato per il processo limber sul server di origine. |
|
!T |
Ora |
Imposta l'intervallo, in minuti, per il controllo dello stato ATTIVO del server. Default = 30 minuti, intervallo = da 1 a 720 minuti (12 ore) |
|
*U |
ID facoltativo del server |
Se il comando non include alcun ID voce, modifica in attivo lo stato di qualsiasi server precedentemente contrassegnato come inattivo. Se il comando include un ID voce locale, modifica lo stato del server specificato da inattivo ad attivo. Gli ID voce sono specifici del database del server di origine e devono fare riferimento a un oggetto che rappresenti un server. |
|
!V |
Un elenco |
Elenca le versioni di eDirectory con restrizioni. Se l'elenco non contiene alcuna versione, non esistono restrizioni. Ogni versione è separata da una virgola. |
|
*Z |
Nessuno |
Visualizza i task attualmente pianificati. |