Data Domain: Abilitazione della registrazione API di DD Boost | Registri precertificati

Riepilogo: 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. ...

Questo articolo si applica a Questo articolo non si applica a Questo articolo non è legato a un prodotto specifico. Non tutte le versioni del prodotto sono identificate in questo articolo.

Istruzioni

Nota: Per impostazione predefinita, il plug-in DD Boost non registra l'attività API dettagliata. Abilitazione della registrazione dei precertificati tramite 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 .ini per 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_files e log_file_size se necessario.
  • I registri possono essere reindirizzati a una posizione diversa se lo spazio su disco è limitato.

Configurazione del client Linux BOOSTFS

  1. Creazione /DDLog directory:
    • mkdir /DDLog
      chmod 777 /DDLog
  2. Creazione /ddboost_precert.ini con la configurazione di cui sopra.

  3. Assicurarsi che BoostFS sia disinstallato e rimontato:

    • mount -o log-level=debug <mount_point>

Configurazione del client Windows BOOSTFS

  1. Creazione C:\ddboost_precert.ini 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. Creazione C:\DDLog e assegnare autorizzazioni complete di lettura/scrittura.

  3. Smontare e reinstallare BoostFS con la registrazione di debug abilitata.


Pulizia e disabilitazione della registrazione

  1. Eliminare il ddboost_precert.ini di NetWorker.
  2. Eliminare il DDLog e il suo contenuto.
  3. Montare nuovamente BoostFS per applicare le modifiche.
  4. Raccogliere i registri BoostFS da /opt/emc/boostfs/log.

Informazioni aggiuntive

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.
 
Qualsiasi modifica al file ddboost_precert.ini richiederà l'unmount di BOOSTFS e quindi il remount affinché le modifiche abbiano effetto.
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
 
[1] Il file ddboost_precert.ini deve essere posizionato nella directory principale della directory di installazione.  Può essere denominato: D:\ ecc.   Se si posiziona il file in un'unità diversa e non viene creato alcun file di registro, tentare comunque C:\.

=====================================================================================================

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:

Prodotti interessati

Data Domain

Prodotti

Data Domain
Proprietà dell'articolo
Numero articolo: 000020437
Tipo di articolo: How To
Ultima modifica: 10 nov 2025
Versione:  7
Trova risposta alle tue domande dagli altri utenti Dell
Support Services
Verifica che il dispositivo sia coperto dai Servizi di supporto.