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

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

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.

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

Affected Products

Data Domain

Products

Data Domain
Article Properties
Article Number: 000020437
Article Type: How To
Last Modified: 10 Nov 2025
Version:  7
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.