Data Domain: Aktivering af DD Boost API-logføring – Precert-logfiler

Summary: Denne artikel beskriver, hvordan du aktiverer logføring af DD Boost-plugin (Data Domain Boost) ved fejlfinding af problemer relateret til Boost og BoostFS. Dette kaldes en precert-log.

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

Bemærk: DD Boost-pluginet logger som standard ikke detaljeret API-aktivitet. Aktivering af precert-logføring ved hjælp af ddboost_precert.ini Filen giver mulighed for dybere diagnosticering. Forkert filplacering, manglende tilladelser eller forkert konfiguration kan forhindre loggenerering.

Årsager til at aktivere logføring på API-niveau (precert):

  • DD Boost- eller BoostFS-handlinger mislykkes eller opfører sig uventet.
  • Teknik- eller supportanmodninger om detaljerede logfiler på API-niveau til analyse.
  • Der genereres ingen logfiler på trods af forventet Boost-aktivitet.

Generelle bemærkninger:

  • Aktivér kun precert-logføring, når teknikeren eller supporten udtrykkeligt anmoder om det.
  • Overvåg diskplads nøje; Logfiler kan vokse hurtigt.
  • Sørg for korrekte tilladelser og filplacering.
  • Fjern: .ini fil for at deaktivere logføring.
  • BoostFS skal afmonteres og genmonteres, for at ændringerne kan træde i kraft.

Filplaceringer efter operativsystem

Operativsystem ddboost_precert.ini Lokation ddboost_precert.log Lokation
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

For BOOST- og BoostFS-versioner før 7.0

Opret en tom fil med navnet ddboost_precert.ini på det relevante sted (se ovenstående tabel). Dette gør det muligt at logge på standardstien.


Til BOOST og BoostFS version 7.0 og nyere

Opret en konfigureret ddboost_precert.ini fil med følgende indhold:

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
  • Denne konfiguration opretter fire logfiler på hver 512 MB (2 GB i alt).
  • Juster num_log_files og log_file_size efter behov.
  • Logfiler kan omdirigeres til en anden placering, hvis diskpladsen er begrænset.

Opsætning af Linux BOOSTFS Client

  1. Opret /DDLog Biblioteker:

mkdir /DDLog

chmod 777 /DDLog

  1. Opret /ddboost_precert.ini med konfigurationen ovenfor.

 

  1. Sørg for, atBoostFS afmonteres og monteres igen:

mount -o log-level=debug <mount_point>

 


Konfiguration af Windows BOOSTFS Client

  1. Opret C:\ddboost_precert.ini med følgende indhold:
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. Opret C:\DDLog og tildele fulde læse-/skrivetilladelser.
  2. Afmonter og monter igen BoostFS med fejlfindingslogføring aktiveret.

Oprydning og deaktivering af logføring

  1. Slet ddboost_precert.ini Filer:
  2. Slet DDLog bibliotek og dets indhold.
  3. Monter BoostFS igen for at anvende ændringerne.
  4. Indsaml BoostFS-logfiler fra /opt/emc/boostfs/log.

Additional Information

Ofte stillede spørgsmål (FAQs)

    Spørgsmål: Hvad er DD Boost Precert-logføring? DD Boost Precert-logføring er en diagnostisk logføringsfunktion, der registrerer DD Boost API-transaktioner mellem en DD Boost-klient og Data Domain-systemet.
    Svar: Det bruges ofte til fejlfinding af ydeevneproblemer, fejl, ventetid og kommunikationsproblemer.

    Spørgsmål: Hvad fanger Precert Logning? Precert-logføring registrerer DD Boost API-aktivitet, herunder læsehandlinger, skrivehandlinger, sikkerhedskopieringsaktivitet, gendannelsesaktivitet, DD Boost-biblioteksinteraktioner, oplysninger om API-opkaldstiming og indikatorer for ventetid på klientsiden.
    Svar: Den giver detaljeret indblik i DD Boost API-adfærd med henblik på fejlfinding og ydeevneanalyse.

    Spørgsmål: Hvorfor genereres der ingen precert-logfiler? Kontroller, at ddboost_precert.ini filen findes, er placeret ved operativsystemets rod, logmappen findes, logmappen kan skrives, og at en ny sikkerhedskopiering eller gendannelse er påbegyndt.
    Svar: Manglende konfiguration, forkert placering, tilladelsesproblemer eller mangel på ny DD Boost-aktivitet er de mest almindelige årsager.

    Spørgsmål: Genererer aktivering af precert-logføring straks logfiler? Konfigurationen aktiverer kun logføringsfunktioner.
    Svar: Nej, logfiler genereres kun, når der modtages nye DD Boost API-anmodninger.

    Spørgsmål: Hvorfor genererer min aktuelt kørende sikkerhedskopi ikke precert-logfiler? Precert-logføring registrerer kun API-aktivitet, der er startet, efter konfigurationen er registreret.
    Svar: Eksisterende sikkerhedskopierings- eller gendannelsesjob fortsætter uden generering af precert-logfiler.

    Spørgsmål: Skal jeg genstarte mit sikkerhedskopierings- eller gendannelsesjob? Hvis jobbet allerede kørte, da logføring blev aktiveret, skal du starte en ny handling.
    Svar: Ja, der kræves et nyt sikkerhedskopierings- eller gendannelsesjob for at generere precert-logfiler.

    Spørgsmål: Hvad er den mest almindelige årsag til, at precert-logning ikke fungerer? Almindelige årsager omfatter: ddboost_precert.ini ikke at være på rodniveau, blive navngivet ved et uheld ddboost_precert.ini.txt, en manglende logmappe eller utilstrækkelige tilladelser.
    Svar: Konfigurations- og filsystemproblemer er de hyppigste årsager.

    Spørgsmål: Hvor skal den ddboost_precert.ini fil placeres? 

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

    Svar: Filen skal være placeret i operativsystemets rodmappe.

    Spørgsmål: Kan den ddboost_precert.ini fil gemmes i en anden mappe? DD Boost-pluginet kontrollerer kun operativsystemets rodmappe.
    Svar: Nej, filen skal gemmes i roden.

    Spørgsmål: Hvordan kan jeg kontrollere, at filen faktisk ikke er

    ddboost_precert.ini.txt

    Åbn Stifinder, aktiver filtypenavne, og bekræft filnavnet.
    Svar: Sørg for, at filen er navngivet 

    ddboost_precert.ini and not ddboost_precert.ini.txt.

    Spørgsmål: Hvorfor er DDLog Mappen er tom efter aktivering af logning? De mulige årsager omfatter ingen ny DD Boost-aktivitet, tilladelsesproblemer eller en konfigurationsfil, der ikke blev registreret.
    Svar: Kør en ny sikkerhedskopiering, gendannelse eller DDPCONNCHK Test for at generere aktivitet.

    Spørgsmål: Hvad er DDPCONNCHK Og hvorfor er det nyttigt? DDPCONNCHK er et valideringsværktøj til DD Boost-tilslutningsmuligheder.
    Svar: Det kan generere DD Boost API-aktivitet og hurtigt bekræfte, at precert-logføring fungerer.

    Spørgsmål: Dåse DDPCONNCHK bruges til at teste min konfiguration? Ingeniører kører ofte DDPCONNCHK efter aktivering af logføring.
    Svar: Ja, det er en almindelig måde at kontrollere, at logfiler genereres, før du reproducerer et problem.

    Spørgsmål: Hvorfor vokser mine precert-logfiler så hurtigt? Precert-logføring registrerer alle DD Boost API-kald.
    Svar: Store sikkerhedskopieringsmiljøer kan generere en betydelig logvolumen på kort tid.

    Spørgsmål: Hvor meget diskplads skal jeg afsætte? En fælles anbefaling er 

    num_log_files=3 and log_file_size=500.

    Svar: Dette giver ca. 1,5 GB loglager, før rotation finder sted.

    Spørgsmål: Kan precert-logfiler fylde et filsystem? Logføring kan forbruge betydelig diskplads, hvis den ikke overvåges.
    Svar: Ja, komplette filsystemer kan resultere i sikkerhedskopieringsfejl, afbrydelser og serviceafbrydelser.

    Spørgsmål: Hvad er formålet med num_log_files? Denne parameter styrer antallet af roterede logfiler, der bevares.
    Svar: For eksempel, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2.

    Spørgsmål: Hvad er formålet med log_file_size? Denne parameter definerer den maksimale størrelse af hver logfil i MB.
    Svar: For eksempel tillader log_file_size = 500, at hver fil vokser til 500 MB før rotation.

    Spørgsmål: Hvad gørs ddcl_logs_include=true Få tingene klaret Det gør det muligt for DD Boost Client Library at logføre oplysninger i precert-logfilerne.
    Svar: Den anbefalede indstilling er ddcl_logs_include=true.

    Spørgsmål: Hvad gør ddcl_logs_sev=4 Betydning Denne parameter styrer logføringens alvorsgrad.
    Svar: Prioritetsniveau 4 indeholder detaljerede oplysninger om fejlfinding og fejlfinding.

    Spørgsmål: Har jeg brug for BoostFS Fejlfindingslogning ud over precert-logning? Yderligere logning er ikke altid påkrævet.
    Svar: Til BoostFS-specific Problemer, der aktiverer begge, giver ofte et mere komplet diagnostisk billede.

    Spørgsmål: Til BoostFS, skal jeg afmontere og genmontere? Afmontering og genmontering initialiserer BoostFS-aktiviteten igen.
    Svar: I mange tilfælde, ja, dette hjælper med at starte ny DD Boost-aktivitet.

    Spørgsmål: Hvad er den korrekte syntaks for logføring af BoostFS-fejlfinding? Den korrekte syntaks er -o log-level=debug.
    Svar: Må ikke anvendes --o log-level=debug Fordi kun en enkelt bindestreg er gyldig.

    Spørgsmål: Hvorfor dukkede der pludselig precert-logfiler op ved genmontering af BoostFS? Genmontering opretter en ny initialiseringscyklus for BoostFS.
    Svar: Logføring begynder, når der opstår ny DD Boost API-aktivitet, og plug-in'et registrerer konfigurationsfilen.

    Spørgsmål: Svarer genstart af et program til genmontering af BoostFS? Enhver handling, der opretter ny DD Boost API-aktivitet, kan udløse logføring.
    Svar: Normalt ja, eksempler inkluderer genstart RMAN, sikkerhedskopieringssoftware eller kørsel DDPCONNCHK.

    Spørgsmål: Dåse RMAN generere precert-logfiler uden at afmontere BoostFS? RMAN kan starte nye DD Boost API-anmodninger direkte.
    Svar: Ja, start på en ny RMAN Betjeningen er normalt tilstrækkelig.

    Spørgsmål: Hvordan deaktiverer jeg precert-logning? Slet ddboost_precert.ini, eller omdøb dem til ddboost_precert.ini.disabled.
    Svar: Logføring aktiveres kun, når det nøjagtige filnavn ddboost_precert.ini findes.

    Spørgsmål: Skal jeg genstarte værten efter at have fjernet ini-filen? Pluginet kontrollerer konfigurationsfilen under fremtidige handlinger.
    Svar: Nej, det er ikke nødvendigt at genstarte.

    Spørgsmål: Hvilke tilladelser skal bruges på Linux? Eksempler på tilladelser omfatter: 

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

    Svar: DD Boost-processen skal kunne læse konfigurationsfilen og skrive til logmappen.

    Spørgsmål: Hvor gemmes BoostFS-logfiler som standard? 

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

    Svar: Disse placeringer er adskilt fra DD Boost precert-logfiler.

    Spørgsmål: Er BoostFS-logfiler og precert-logfiler det samme? BoostFS-logfiler indeholder tilslutningsaktivitet, filsystemhandlinger og programhændelser.
    Svar: Nej, precert-logfiler indeholder DD Boost API-transaktioner, bibliotekskommunikation og I/O-timingdata.

    Spørgsmål: Hvilke logfiler skal jeg give til Support? Afhængigt af problemet skal du indsamle ddboost_precert.log, roterede precert-logfiler, BoostFS-logfiler, DDPCONNCHK output, programlogfiler og anmodede supportpakker.
    Svar: Tilvejebringelse af alle relevante logfiler hjælper med at fremskynde fejlfinding.

    Spørgsmål: Hvad skal jeg gøre, hvis der stadig ikke genereres logfiler, efter jeg har fulgt denne KB? Indsaml beviser såsom ddboost_precert.ini placering, logkatalogfortegnelse, DDPCONNCHK output, BoostFS-tilslutningskommando og tilladelsesoplysninger.
    Svar: Send de indsamlede oplysninger til Dells tekniske support til yderligere analyse.

    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.