Data Domain: Abilitazione della registrazione API di DD Boost | Registri precertificati
Summary: Questo articolo della Knowledge Base spiega come abilitare la registrazione del plug-in DD Boost durante la risoluzione dei problemi relativi a Boost e BoostFS. Questo viene chiamato registro precert. ...
Instructions
ddboost_precert.ini Il file consente una diagnostica più approfondita. Il posizionamento errato dei file, le autorizzazioni mancanti o la configurazione errata possono impedire la generazione del registro.
Motivi per abilitare la registrazione a livello di API (precert):
- Le operazioni di DD Boost o BoostFS hanno esito negativo o si comportano in modo imprevisto.
- Il tecnico o il supporto richiede log dettagliati a livello di API per l'analisi.
- Non viene generato alcun registro nonostante l'attività Boost prevista.
Note generali:
- Abilitare la registrazione dei precertificati solo se esplicitamente richiesto dal reparto Engineering o dal supporto.
- Monitorare attentamente lo spazio su disco; I registri possono crescere rapidamente.
- Verificare che le autorizzazioni e il posizionamento dei file siano corretti.
- Rimuovere il
.iniper disabilitare la registrazione. - BoostFS deve essere smontato e rimontato affinché le modifiche abbiano effetto.
Percorsi dei file in base al sistema operativo
| Sistema operativo | ddboost_precert.ini Posizione |
ddboost_precert.log Posizione |
|---|---|---|
| Linux | /ddboost_precert.ini |
/DDLog/ddboost_precert.log |
| Solaris | /ddboost_precert.ini |
/DDLog/ddboost_precert.log |
| UNIX | /ddboost_precert.ini |
/DDLog/ddboost_precert.log |
| Windows | C:\ddboost_precert.ini |
C:\DDLog\ddboost_precert.log |
Per le versioni di BOOST/BoostFS precedenti alla 7.0
Creare un file vuoto denominato ddboost_precert.ini nella posizione appropriata (vedere la tabella sopra). In questo modo viene abilitata la registrazione nel percorso predefinito.
Per BOOST/BoostFS versione 7.0 e successive
Creare un file configurato ddboost_precert.ini File con il seguente contenuto:
precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4
- Questa configurazione crea quattro file di registro da 512 MB ciascuno (2 GB totali).
- Adattare
num_log_fileselog_file_sizese necessario. - I registri possono essere reindirizzati a una posizione diversa se lo spazio su disco è limitato.
Configurazione del client Linux BOOSTFS
- Creazione
/DDLogdirectory:mkdir /DDLogchmod 777 /DDLog
-
Creazione
/ddboost_precert.inicon la configurazione di cui sopra. -
Assicurarsi che BoostFS sia disinstallato e rimontato:
mount -o log-level=debug <mount_point>
Configurazione del client Windows BOOSTFS
- Creazione
C:\ddboost_precert.inicon il seguente contenuto:-
precert_enabled=true num_log_files=3 log_file_size=500 log_file_name=ddboost_precert.log log_file_dir=C:\DDLog ddcl_logs_include=true ddcl_logs_sev=4
-
-
Creazione
C:\DDLoge assegnare autorizzazioni complete di lettura/scrittura. -
Smontare e reinstallare BoostFS con la registrazione di debug abilitata.
Pulizia e disabilitazione della registrazione
- Eliminare il
ddboost_precert.inidi NetWorker. - Eliminare il
DDLoge il suo contenuto. - Montare nuovamente BoostFS per applicare le modifiche.
- Raccogliere i registri BoostFS da
/opt/emc/boostfs/log.
Additional Information
Per le versioni di BOOST/BoostFS precedenti alla 7.0, i registri precertificati vengono abilitati creando un file vuoto denominato esattamente "ddboost_precert.ini" nella posizione indicata nella tabella riportata di seguito. In questo modo, l'API DD Boost SDK abiliterà la registrazione nel percorso predefinito e nel nome file, come mostrato nella tabella seguente:
Questo strumento deve essere abilitato solo quando richiesto dai team di progettazione o supporto e, a causa della quantità di registri generati, è necessario prestare attenzione affinché questa registrazione venga disabilitata il prima possibile.
| Sistema operativo | Percorso del file ddboost_precert.ini | Percorso del file ddboost_precert.log |
|---|---|---|
| Linux | /ddboost_precert.ini | /DDLog/ddboost_precert.log |
| Solaris | /ddboost_precert.ini | /DDLog/ddboost_precert.log |
| UNIX | /ddboost_precert.ini | /DDLog/ddboost_precert.log |
| Windows | C:\ddboost_precert.ini [1] | C:\DDLog\ddboost_precert.log |
Per BOOST e BoostFS 7.0 e versioni successive, il file "ddboost_precert.ini" deve essere creato nelle stesse posizioni di cui sopra, ma non può essere vuoto, deve essere inizializzato con il contenuto riportato di seguito, altrimenti non comporterà la creazione dei registri:
precert_enabled=true
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=true
ddcl_logs_sev=4
Con le impostazioni di cui sopra, creerà 4 file da 512 MB ciascuno, quindi in totale occuperà solo 2 GB di spazio su disco.
Se 4 file da 512 MB ciascuno non coprono l'intervallo di tempo necessario per la risoluzione dei problemi, regolare la quantità di file e le relative dimensioni utilizzando i parametri "num_log_files" e "log_file_size".
Con la configurazione mostrata, i registri verranno creati nella stessa posizione della tabella, ma è possibile crearli in una posizione diversa, nel caso in cui la partizione root del sistema operativo non sia sufficientemente grande.
NOTA: Questa cartella deve essere presente nello stesso percorso del file ddboost_precert.ini (in attesa di conferma da parte di qualcuno che ne sa di più, se questo è vero renderebbe impossibile scrivere il log su una partizione diversa dalla radice tipicamente piccola)
Quando il file di .ini è presente (e nel caso della versione 7.0 o successiva, ha il contenuto appropriato), viene generato un file di log denominato ddboost_precert.log nella cartella /DDLog (se tale percorso è quello configurato).
Il ddboost_precert.log può crescere molto rapidamente poiché tutte le chiamate API vengono registrate nel file, quindi prestare attenzione alla quantità di spazio disponibile nella posizione del client per i registri, in quanto possono causare il riempimento della partizione e causare downtime e disagi per il cliente.
Per interrompere la registrazione, la rimozione del file ddboost_precert.ini farà sì che i registri nel file configurato si interrompano immediatamente.
Per altri software di backup che utilizzano ddboost, potrebbe essere necessario riavviare i servizi se non viene creato alcun file di registro per rilevare la presenza o l'assenza di file ddboost_precert.ini
=====================================================================================================
procedura per abilitare i registri precert sul server
LinuxBoostFS 1. Creare una directory DDLog come /DDLog
2. Creare un file ddboost_precert.ini sul percorso / con i seguenti contenuti
precert_enabled=vero
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=vero ddcl_logs_sev=4
3. Salvare il contenuto di cui sopra nel file - ddboost_precert.ini
4. Assicurarsi che la directory /DDLog disponga delle autorizzazioni di scrittura. Fornire tutti i file nella directory /DDLog.
a. modificare le autorizzazioni su DDLog e ddboost_precert.ini
b. eseguire "sudo chmod 777 DDLog/ ddboost_precert.ini'5
". Raccogliere i registri BoostFS a livello di debug.
un. Smontare e rimontare il mount point BoostFS con l'opzione '-o log-level=debug'
b. È inoltre possibile aggiornare il livello di registro nel file boostfs.conf all'interno della directory /opt/emc/boostfs/etc. Sarà comunque necessario eseguire l'unmount-mount dell'unità BoostFS.
c. Eseguire l'operazione di backup sul mount point BoostFS.
d. Fornire tutti i file all'interno della directory - /opt/emc/boostfs/log
======================================================================================================
Abilitare i registri precertificati sul server
Windows BoostFS 1. Creare ddboost_precert.ini in C: Unità con il seguente contenuto:
precert_enabled=true
num_log_files=3
log_file_size=500
log_file_name=ddboost_precert.log
log_file_dir=C:\DDLog
ddcl_logs_include=true
ddcl_logs_sev=4
2. Creare una cartella denominata DDLog in C: drive. I file di registro del precertificato verranno creati in questa cartella. Fornire tutte le autorizzazioni di lettura/scrittura alla directory DDLog in modo da poter creare e aggiungere i file di registro.
NOTA:
La configurazione precedente creerà un massimo di 3 file di registro precertificati di circa 500 MB ciascuno.
È possibile utilizzare valori diversi per num_log_files e log_file_size in base alle esigenze. Ma 3 file da 500 MB ciascuno dovrebbero essere sufficienti per lo scopo.
Se non è possibile disporre di spazio libero di 1,5 GB sul sistema client, il valore di log_file_size può essere ridotto a 200.
Assicurarsi che sia disponibile spazio su disco sufficiente nel sistema client prima di abilitare i registri precert.
3. Smontare e rimontare il mount point BoostFS con l'opzione '-o log-level=debug'
Attività di pulizia e disabilitazione della registrazione
dei precertificatiUna volta raccolti i registri precertificati dopo il problema, disabilitarli con la seguente procedura. Questa operazione deve essere eseguita prima di eseguire nuovamente il mounting di BoostFS SU.
1. Eliminare la cartella DDLog da C: e il relativo contenuto
2. Eliminare ddboost_precert.ini file da C:
=====================================================================================================Abilitare i registri precertificati sul server Linux con un'applicazione di backup ddboost.
Procedura per abilitare la registrazione precertificata DDBoost su un server ddboost Linux:
Creare la directory /DDLog
2. Concedere tutte le autorizzazioni a tutti gli utenti per la directory /DDLog utilizzando il seguente comando:
$ chmod 777 /DDLog
3. Creare il file /ddboost_precert.ini con i seguenti contenuti:
precert_enabled=vero
num_log_files=4
log_file_size=512
log_file_name=ddboost_precert.log
log_file_dir=/DDLog
ddcl_logs_include=vero ddcl_logs_sev=4
4. I registri precertificati verranno generati all'interno della directory /DDLog.
=======================================================================================
Abilitare i registri precertificati su Windows Server con un'applicazione di backup ddboost.
1. Creare ddboost_precert.ini in C: Unità con il seguente contenuto:
precert_enabled=true
num_log_files=3
log_file_size=500
log_file_name=ddboost_precert.log
log_file_dir=C:\DDLog
ddcl_logs_include=true
ddcl_logs_sev=4
2. Creare una cartella denominata DDLog in C: drive. I file di registro del precertificato verranno creati in questa cartella. Fornire tutte le autorizzazioni di lettura/scrittura alla directory DDLog in modo da poter creare e aggiungere i file di registro.
NOTA:
La configurazione precedente creerà un massimo di 3 file di registro precertificati di circa 500 MB ciascuno.
È possibile utilizzare valori diversi per num_log_files e log_file_size in base alle esigenze. Ma 3 file da 500 MB ciascuno dovrebbero essere sufficienti per lo scopo.
Se non è possibile disporre di spazio libero di 1,5 GB sul sistema client, il valore di log_file_size può essere ridotto a 200.
Assicurarsi che sia disponibile spazio su disco sufficiente nel sistema client prima di abilitare i registri precert.
Attività di pulizia e disabilitazione della registrazione
dei precertificatiUna volta raccolti i registri dei precertificati dopo il problema, disabilitarli con la seguente procedura.
1. Eliminare la cartella DDLog da C: e il relativo contenuto
2. Eliminare ddboost_precert.ini file da C: