Data Domain: DD Boost API-logboekregistratie inschakelen - Precert-logboeken

Summary: In dit artikel wordt uitgelegd hoe u de Data Domain Boost (DD Boost) plug-inlogging inschakelt bij het oplossen van problemen met betrekking tot Boost en BoostFS. Dit wordt een precert-logboek genoemd. ...

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.
Check out other resources

Instructions

Opmerking: De DD Boost-plug-in registreert standaard geen gedetailleerde API-activiteit. Precert-logging inschakelen met behulp van de ddboost_precert.ini Bestand maakt diepere diagnostiek mogelijk. Onjuiste bestandsplaatsing, ontbrekende machtigingen of verkeerde configuratie kunnen voorkomen dat logboeken worden gegenereerd.

Redenen om logboekregistratie op API-niveau (precert) in te schakelen:

  • DD Boost- of BoostFS-bewerkingen mislukken of gedragen zich onverwacht.
  • Engineering of Support vraagt gedetailleerde logboeken op API-niveau aan voor analyse.
  • Er worden geen logboeken gegenereerd ondanks de verwachte Boost-activiteit.

Algemene opmerkingen:

  • Schakel precert-logging alleen in als Engineering of Support hier expliciet om vraagt.
  • Houd de schijfruimte nauwlettend in de gaten; Boomstammen kunnen snel groeien.
  • Zorg voor de juiste machtigingen en plaatsing van bestanden.
  • Verwijder de volgende onderdelen: .ini Bestand om logboekregistratie uit te schakelen.
  • BoostFS moet worden losgekoppeld en opnieuw worden gekoppeld om wijzigingen door te voeren.

Bestandslocaties per besturingssysteem

Besturingssysteem ddboost_precert.ini Locatie ddboost_precert.log Locatie
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

Voor BOOST- en BoostFS-versies ouder dan 7.0

Maak een leeg bestand met de naam ddboost_precert.ini op de juiste locatie (zie bovenstaande tabel). Hiermee kunt u inloggen op het standaardpad.

Voor BOOST en BoostFS versie 7.0 en hoger

Maak een geconfigureerde ddboost_precert.ini bestand met de volgende inhoud:

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
  • Deze configuratie maakt vier logbestanden van elk 512 MB (2 GB in totaal).
  • Aanpassen num_log_files en log_file_size zoals vereist.
  • Logboeken kunnen worden omgeleid naar een andere locatie als de schijfruimte beperkt is.

Linux BOOSTFS-client instellen

  1. Maken /DDLog Mappen:

mkdir /DDLog

chmod 777 /DDLog

  1. Maken /ddboost_precert.ini met de bovenstaande configuratie.

 

  1. Zorg ervoor dat BoostFS wordt ontkoppeld en opnieuw bevestigd:

mount -o log-level=debug <mount_point>

 

Windows BOOSTFS-clientinstellingen

  1. Maken C:\ddboost_precert.ini met de volgende inhoud:
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
  1. Maken C:\DDLog en wijs volledige lees-/schrijfmachtigingen toe.
  2. Ontkoppelen en opnieuw monteren BoostFS met logboekregistratie voor foutopsporing ingeschakeld.

Logboekregistratie opschonen en uitschakelen

  1. Verwijder de ddboost_precert.ini Bestand:
  2. Verwijder de DDLog directory en de inhoud ervan.
  3. Koppel BoostFS opnieuw om wijzigingen toe te passen.
  4. BoostFS logboeken verzamelen van /opt/emc/boostfs/log.

Additional Information

Veelgestelde vragen (FAQ's)

    Vraag: Wat is DD Boost Precert Logging? DD Boost Precert Logging is een diagnostische logboekfunctie die DD Boost API-transacties tussen een DD Boost-client en het Data Domain-systeem registreert.
    Antwoord: Het wordt vaak gebruikt voor het oplossen van prestatieproblemen, storingen, latentie en communicatieproblemen.

    Vraag: Wat wordt er vastgelegd in Precert Logging? Precert-logging legt DD Boost API-activiteit vast, inclusief leesbewerkingen, schrijfbewerkingen, back-upactiviteit, herstelactiviteit, DD Boost-bibliotheekinteracties, API-aanroeptiminginformatie en latentie-indicatoren aan de clientzijde.
    Antwoord: Het biedt gedetailleerd inzicht in het gedrag van de DD Boost API voor probleemoplossing en prestatieanalyse.

    Vraag: Waarom worden er geen precert-logboeken gegenereerd? Controleer of het ddboost_precert.ini bestand bestaat, zich in de hoofdmap van het besturingssysteem bevindt, de logboekmap bestaat, de logboekmap beschrijfbaar is en of een nieuwe back-up- of herstelbewerking is gestart.
    Antwoord: Ontbrekende configuratie, onjuiste plaatsing, problemen met machtigingen of het uitblijven van nieuwe DD Boost-activiteit zijn de meest voorkomende oorzaken.

    Vraag: Worden er onmiddellijk logboeken gegenereerd als u precert-logboeken inschakelt? De configuratie schakelt alleen de mogelijkheid van logboekregistratie in.
    Antwoord: Nee, logbestanden worden alleen gegenereerd wanneer nieuwe DD Boost API-aanvragen worden ontvangen.

    Vraag: Waarom genereert mijn momenteel actieve back-up geen precert-logboeken? Precert-logging legt alleen API-activiteit vast die wordt geïnitieerd nadat de configuratie is gedetecteerd.
    Antwoord: Bestaande back-up- of hersteltaken worden voortgezet zonder dat er precertlogboeken worden gegenereerd.

    Vraag: Moet ik mijn back-up- of hersteltaak opnieuw starten? Als de taak al werd uitgevoerd toen logboekregistratie werd ingeschakeld, start u een nieuwe bewerking.
    Antwoord: Ja, er is een nieuwe back-up- of hersteltaak vereist om precert-logboeken te genereren.

    Vraag: Wat is de meest voorkomende reden waarom precert-logboekregistratie niet werkt? Veel voorkomende oorzaken zijn ddboost_precert.ini niet op het rootniveau zijn, per ongeluk genoemd worden ddboost_precert.ini.txt, een ontbrekende logboekmap of onvoldoende machtigingen.
    Antwoord: Configuratie- en bestandssysteemproblemen zijn de meest voorkomende oorzaken.

    Vraag: Waar moet het ddboost_precert.ini bestand worden geplaatst? 

    Linux: /ddboost_precert.ini. Windows: C:\ddboost_precert.ini.

    Antwoord: Het bestand moet zich in de hoofdmap van het besturingssysteem bevinden.

    Vraag: Kan het ddboost_precert.ini bestand in een andere map worden opgeslagen? De DD Boost plugin controleert alleen de hoofdmap van het besturingssysteem.
    Antwoord: Nee, het bestand moet in de hoofdmap worden opgeslagen.

    Vraag: Hoe kan ik controleren of het bestand niet echt 

    ddboost_precert.ini.txt

    Open Verkenner, schakel Bestandsnaamextensies in en controleer de bestandsnaam.
    Antwoord: Controleer of het bestand een naam heeft 

    ddboost_precert.ini and not ddboost_precert.ini.txt.

    Vraag: Waarom is de DDLog Directory leeg na het inschakelen van logging? Mogelijke oorzaken zijn onder meer geen nieuwe DD Boost-activiteit, problemen met machtigingen of een configuratiebestand dat niet is gedetecteerd.
    Antwoord: Een nieuwe back-up maken, terugzetten of DDPCONNCHK Test om activiteit te genereren.

    Vraag: Wat is DDPCONNCHK En waarom is het nuttig? DDPCONNCHK is een DD Boost-tool voor het valideren van connectiviteit.
    Antwoord: Het kan DD Boost API-activiteit genereren en snel bevestigen dat precert-logging werkt.

    Vraag: Blikje DDPCONNCHK worden gebruikt om mijn configuratie te testen? Engineers voeren vaak DDPCONNCHK na het inschakelen van logging.
    Antwoord: Ja, het is een gebruikelijke manier om te controleren of er logbestanden worden gegenereerd voordat een probleem wordt gereproduceerd.

    Vraag: Waarom groeien mijn precert-logs zo snel? In precert-logging wordt elke DD Boost API-aanroep vastgelegd.
    Antwoord: Grote back-upomgevingen kunnen in korte tijd een aanzienlijk logvolume genereren.

    Vraag: Hoeveel schijfruimte moet ik toewijzen? Een veelgehoorde aanbeveling is 

    num_log_files=3 and log_file_size=500.

    Antwoord: Dit biedt ongeveer 1,5 GB aan logopslag voordat rotatie plaatsvindt.

    Vraag: Kunnen precert-logboeken een bestandssysteem vullen? Logboekregistratie kan aanzienlijke schijfruimte in beslag nemen als deze niet wordt gecontroleerd.
    Antwoord: Ja, volledige bestandssystemen kunnen leiden tot back-upfouten, storingen en serviceonderbrekingen.

    Vraag: Wat is het doel van num_log_files? Met deze parameter bepaalt u het aantal geroteerde logbestanden dat wordt bewaard.
    Antwoord: Bijvoorbeeld, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2.

    Vraag: Wat is het doel van log_file_size? Deze parameter definieert de maximale grootte van elk logboekbestand in MB.
    Antwoord: Met log_file_size=500 kan elk bestand bijvoorbeeld groeien tot 500 MB voordat het wordt gedraaid.

    Vraag: Wat doe jes ddcl_logs_include=true Doe Hiermee kunt u DD Boost Client Library loggegevens in de precert-logboeken inschakelen.
    Antwoord: De aanbevolen instelling is ddcl_logs_include=true.

    Vraag: Wat betekent ddcl_logs_sev=4 Betekenis Deze parameter bepaalt de ernst van de logboekregistratie.
    Antwoord: Prioriteitsniveau 4 biedt gedetailleerde informatie over probleemoplossing en foutopsporing.

    Vraag: Heb ik nodig BoostFS Debug logging in aanvulling op precert logging? Extra logboekregistratie is niet altijd vereist.
    Antwoord: Voor BoostFS-specific problemen, biedt het inschakelen van beide vaak een vollediger diagnostisch beeld.

    Vraag: Voor BoostFS, moet ik ontkoppelen en opnieuw monteren? Door te ontkoppelen en opnieuw te monteren wordt de BoostFS-activiteit opnieuw geïnitialiseerd.
    Antwoord: In veel gevallen inderdaad helpt dit bij het initiëren van nieuwe DD Boost-activiteit.

    Vraag: Wat is de juiste syntaxis voor logboekregistratie voor BoostFS-foutopsporing? De juiste syntaxis is -o log-level=debug.
    Antwoord: Niet gebruiken --o log-level=debug omdat slechts één streepje geldig is.

    Vraag: Waarom werden er plotseling precert-logboeken weergegeven door BoostFS opnieuw te koppelen? Door opnieuw te koppelen wordt een nieuwe initialisatiecyclus voor BoostFS gemaakt.
    Antwoord: De logboekregistratie begint wanneer nieuwe DD Boost API-activiteit optreedt en de plug-in het configuratiebestand detecteert.

    Vraag: Is het opnieuw opstarten van een applicatie gelijk aan het opnieuw koppelen van BoostFS? Elke actie die nieuwe DD Boost API-activiteit maakt, kan logboekregistratie activeren.
    Antwoord: Meestal wel, voorbeelden zijn onder meer opnieuw opstarten RMAN, back-upsoftware of het uitvoeren van DDPCONNCHK.

    Vraag: Blikje RMAN precert logs genereren zonder BoostFS te ontkoppelen? RMAN kan direct nieuwe DD Boost API-aanvragen initiëren.
    Antwoord: Ja, het starten van een nieuwe RMAN werking is normaal gesproken voldoende.

    Vraag: Hoe schakel ik precert-logging uit? Verwijder ddboost_precert.ini of hernoem deze naar ddboost_precert.ini.disabled.
    Antwoord: Logging wordt alleen geactiveerd als de exacte bestandsnaam is ingevoerd ddboost_precert.ini bestaat.

    Vraag: Moet ik de host opnieuw opstarten na het verwijderen van het ini-bestand? De plug-in controleert op het configuratiebestand tijdens toekomstige bewerkingen.
    Antwoord: Nee, opnieuw opstarten is niet vereist.

    Vraag: Welke machtigingen moeten worden gebruikt op Linux? Voorbeelden van machtigingen zijn: 

    mkdir /DDLog, chmod 777 /DDLog, and chmod 777 /ddboost_precert.ini.

    Antwoord: Het DD Boost-proces moet het configuratiebestand kunnen lezen en naar de logboekmap kunnen schrijven.

    Vraag: Waar worden BoostFS logboeken standaard opgeslagen? 

    Linux: /opt/emc/boostfs/log. Windows: C:\BoostFS\Log.

    Antwoord: Deze locaties staan los van de DD Boost-precertlogboeken.

    Vraag: Zijn BoostFS logs en precert logs hetzelfde? BoostFS logboeken bevatten koppelingsactiviteit, bewerkingen van het bestandssysteem en applicatiegebeurtenissen.
    Antwoord: Nee, precert-logboeken bevatten DD Boost API-transacties, bibliotheekcommunicatie en I/O-timingdata.

    Vraag: Welke logbestanden moet ik aanleveren aan Support? Afhankelijk van het probleem, verzamelt u ddboost_precert.log, gedraaide precert-logboeken, BoostFS-logboeken, DDPCONNCHK output, applicatielogboeken en aangevraagde supportbundels.
    Antwoord: Het verstrekken van alle relevante logboeken helpt om probleemoplossing te versnellen.

    Vraag: Wat moet ik doen als er na het volgen van deze KB nog steeds geen logbestanden worden gegenereerd? Verzamel bewijs zoals de locatie van de ddboost_precert.ini, de vermelding in de logmap, DDPCONNCHK uitvoer, BoostFS koppelingsopdracht en machtigingsinformatie.
    Antwoord: Dien de verzamelde informatie voor verdere analyse naar de technische support van Dell.

    Affected Products

    Data Domain

    Products

    Data Domain
    Article Properties
    Article Number: 000020437
    Article Type: How To
    Last Modified: 21 Aug 2026
    Version:  9
    Find answers to your questions from other Dell users
    Support Services
    Check if your device is covered by Support Services.