Data Domain: ativando o log da API do DD Boost – Logs Precert

Summary: Este artigo explica como habilitar o log do plug-in do Data Domain Boost (DD Boost) ao solucionar problemas relacionados ao Boost e ao BoostFS. Isso é chamado de log 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.
Check out other resources

Instructions

Observação: O plug-in do DD Boost não registra atividades detalhadas da API por padrão. Habilitando o log de pré-certificado usando o ddboost_precert.ini permite diagnósticos mais profundos. O posicionamento incorreto do arquivo, a falta de permissões ou a configuração incorreta podem impedir a geração do registro.

Motivos para habilitar o log no nível da API (precert):

  • As operações do DD Boost ou BoostFS estão falhando ou se comportando inesperadamente.
  • A engenharia ou o suporte solicitam logs detalhados em nível de API para análise.
  • Nenhum log é gerado, apesar da atividade de boost esperada.

Notas gerais

  • Habilite o log de pré-certificado somente quando solicitado explicitamente pela engenharia ou pelo suporte.
  • Monitore o espaço em disco de perto; Os logs podem crescer rapidamente.
  • Verifique se as permissões e o posicionamento do arquivo estão corretos.
  • Remova a .ini Para desativar o registro:
  • O BoostFS deve ser desmontado e remontado para que as alterações entrem em vigor.

Localizações de arquivos por sistema operacional

Sistema operacional ddboost_precert.ini Localização ddboost_precert.log Localização
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

Para versões do BOOST e do BoostFS anteriores à 7.0

Criar um arquivo vazio ddboost_precert.ini no local apropriado (veja a tabela acima). Isso permite registrar no caminho padrão.

Para BOOST e BoostFS versão 7.0 e posterior

Criar um configurado ddboost_precert.ini com o seguinte conteúdo:

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
  • Essa configuração cria quatro arquivos de log de 512 MB cada (total de 2 GB).
  • Capacidade de ajuste num_log_files e log_file_size como exigido:
  • Os registros podem ser redirecionados para um local diferente se o espaço em disco for limitado.

Configuração do client Linux BOOSTFS

  1. Criar /DDLog no diretório:

mkdir /DDLog

chmod 777 /DDLog

  1. Criar /ddboost_precert.ini com a configuração acima.

 

  1. Certificar-se O BoostFS é desmontado e remontado:

mount -o log-level=debug <mount_point>

 

Instalação do client BOOSTFS do Windows

  1. Criar C:\ddboost_precert.ini com o seguinte conteúdo:
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. Criar C:\DDLog e atribua permissões completas de leitura/gravação.
  2. Desmontar e remontar BoostFS com log de depuração ativado.

Limpeza e desativação do log

  1. Excluir o . ddboost_precert.ini .
  2. Excluir o . DDLog diretório e seu conteúdo.
  3. Remonte o BoostFS para aplicar as alterações.
  4. Coletar logs do BoostFS de /opt/emc/boostfs/log.

Additional Information

Perguntas frequentes (FAQ)

    Pergunta: O que é log de pré-certificação do DD Boost? O log do DD Boost Precert é um recurso de log de diagnóstico que registra as transações da API do DD Boost entre um client do DD Boost e o sistema Data Domain.
    Resposta: É comumente usado para solucionar problemas de desempenho, falhas, latência e problemas de comunicação.

    Pergunta: O que o Precert Logging captura? O log Precert captura a atividade da API do DD Boost, inclusive operações de leitura, operações de gravação, atividade de backup, atividade de restauração, interações da biblioteca do DD Boost, informações de tempo de chamada da API e indicadores de latência no lado do client.
    Resposta: Ele fornece visibilidade detalhada do comportamento da API DD Boost para solução de problemas e análise de desempenho.

    Pergunta: Por que nenhum registro pré-certificado está sendo gerado? Verifique se o arquivo ddboost_precert.ini existe, está localizado na raiz do sistema operacional, se o diretório de log existe, se o diretório de log é gravável e se uma nova operação de backup ou restauração foi iniciada.
    Resposta: Configurações ausentes, posicionamento incorreto, problemas de permissão ou falta de atividade do novo DD Boost são as causas mais comuns.

    Pergunta: Habilitar o log precert gera logs imediatamente? A configuração ativa apenas o recurso de log.
    Resposta: Não, os arquivos de log são gerados somente quando novas solicitações de API do DD Boost são recebidas.

    Pergunta: Por que meu backup em execução atualmente não gera registros precert? O log do Precert captura apenas a atividade da API iniciada depois que a configuração é detectada.
    Resposta: Os trabalhos de backup ou restauração existentes continuam sem gerar registros pré-certificado.

    Pergunta: Preciso reiniciar meu trabalho de backup ou restauração? Se o trabalho já estava em execução quando o log foi habilitado, inicie uma nova operação.
    Resposta: Sim, um novo trabalho de backup ou restauração é necessário para gerar logs de pré-certificado.

    Pergunta: Qual é o motivo mais comum pelo qual o log precert não funciona? As causas comuns incluem ddboost_precert.ini não estar no nível raiz, ser nomeado acidentalmente ddboost_precert.ini.txt, um diretório de log ausente ou permissões insuficientes.
    Resposta: Problemas de configuração e do file system são as causas mais frequentes.

    Pergunta: Onde o arquivo ddboost_precert.ini deve ser colocado? 

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

    Resposta: O arquivo deve residir no diretório raiz do sistema operacional.

    Pergunta: O arquivo ddboost_precert.ini pode ser armazenado em outra pasta? O plug-in do DD Boost verifica apenas o diretório raiz do sistema operacional.
    Resposta: Não, o arquivo deve ser armazenado na raiz.

    Pergunta: Como posso verificar se o arquivo não é realmente 

    ddboost_precert.ini.txt

    Abra o Explorador de Arquivos, ative as Extensões de Nome de Arquivo e verifique o nome do arquivo.
    Resposta: Certifique-se de que o arquivo seja nomeado 

    ddboost_precert.ini and not ddboost_precert.ini.txt.

    Pergunta: Por que o DDLog diretório vazio após ativar o log? As possíveis causas incluem nenhuma atividade nova do DD Boost, problemas de permissão ou um arquivo de configuração que não foi detectado.
    Resposta: Execute um novo backup, restauração ou DDPCONNCHK teste para gerar atividade.

    Pergunta: O que é DDPCONNCHK e por que é útil? DDPCONNCHK é uma ferramenta de validação de conectividade do DD Boost.
    Resposta: Ele pode gerar atividade da API do DD Boost e confirmar rapidamente se o log precert está funcionando.

    Pergunta: Pode DDPCONNCHK ser usado para testar minha configuração? Os engenheiros executam frequentemente DDPCONNCHK Depois de ativar o registro.
    Resposta: Sim, é uma maneira comum de verificar se os logs estão sendo gerados antes de reproduzir um problema.

    Pergunta: Por que meus registros precert estão crescendo tão rapidamente? O log Precert registra todas as chamadas da API do DD Boost.
    Resposta: Ambientes de backup grandes podem gerar um volume significativo de registros em um curto período.

    Pergunta: Quanto espaço em disco devo alocar? Uma recomendação comum é 

    num_log_files=3 and log_file_size=500.

    Resposta: Isso fornece aproximadamente 1,5 GB de armazenamento de log antes que o rodízio ocorra.

    Pergunta: Os registros precert podem preencher um file system? O registro em log pode consumir espaço em disco significativo se não for monitorado.
    Resposta: Sim, file systems completos podem resultar em falhas de backup, interrupções e interrupções de serviço.

    Pergunta: Qual é o objetivo do num_log_files? Esse parâmetro controla o número de arquivos de log rotacionados retidos.
    Resposta: Por exemplo:, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2.

    Pergunta: Qual é o objetivo do log_file_size? Esse parâmetro define o tamanho máximo de cada arquivo de log em MB.
    Resposta: Por exemplo, log_file_size=500 permite que cada arquivo aumente para 500 MB antes da rotação.

    Pergunta: O que fazes ddcl_logs_include=true Faça: Ele habilita as informações de log da biblioteca do client do DD Boost nos logs de pré-certificado.
    Resposta: A configuração recomendada é ddcl_logs_include=true.

    Pergunta: O que faz ddcl_logs_sev=4 Significados Esse parâmetro controla a severidade do registro.
    Resposta: O nível de severidade 4 fornece informações detalhadas de depuração e solução de problemas.

    Pergunta: Preciso BoostFS log de depuração além do log de pré-certificado? Logs adicionais nem sempre são necessários.
    Resposta: Para BoostFS-specific A habilitação de ambos geralmente fornece um quadro de diagnóstico mais completo.

    Pergunta: Para BoostFS, preciso desmontar e remontar? Desmontar e remontar reinicializa a atividade do BoostFS.
    Resposta: Em muitos casos, sim, isso ajuda a iniciar a nova atividade do DD Boost.

    Pergunta: Qual é a sintaxe correta de log de depuração do BoostFS? A sintaxe correta é -o log-level=debug.
    Resposta: Não use --o log-level=debug porque apenas um único traço é válido.

    Pergunta: Por que a remontagem do BoostFS de repente fez com que os logs precert aparecessem? A remontagem cria um novo ciclo de inicialização para o BoostFS.
    Resposta: O log começa quando ocorre uma nova atividade da API do DD Boost e o plug-in detecta o arquivo de configuração.

    Pergunta: Reiniciar um aplicativo é equivalente a remontar o BoostFS? Qualquer ação que crie uma nova atividade da API do DD Boost pode acionar o registro em log.
    Resposta: Geralmente sim, exemplos incluem reiniciar RMAN, software de backup ou em execução DDPCONNCHK.

    Pergunta: Pode RMAN gerar logs precert sem desmontar o BoostFS? RMAN pode iniciar novas solicitações de API do DD Boost diretamente.
    Resposta: Sim, começar um novo RMAN operação normalmente é suficiente.

    Pergunta: Como faço para desativar o log de pré-certificado? Exclua ddboost_precert.ini ou renomeie-o para ddboost_precert.ini.disabled.
    Resposta: O log só é ativado quando o nome exato do arquivo ddboost_precert.ini existe.

    Pergunta: Preciso reinicializar o host depois de remover o arquivo ini? O plug-in verifica o arquivo de configuração durante operações futuras.
    Resposta: Não, a reinicialização não é necessária.

    Pergunta: Quais permissões devem ser usadas no Linux? Exemplos de permissões incluem 

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

    Resposta: O processo do DD Boost deve ser capaz de ler o arquivo de configuração e gravar no diretório de log.

    Pergunta: Onde os logs do BoostFS são armazenados por padrão? 

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

    Resposta: Esses locais são separados dos logs precert do DD Boost.

    Pergunta: Os logs do BoostFS e os logs precert são a mesma coisa? Os logs do BoostFS contêm atividade de montagem, operações do file system e eventos de aplicativos.
    Resposta: Não, os logs precert contêm transações da API do DD Boost, comunicações da biblioteca e dados de temporização de E/S.

    Pergunta: Quais logs devo fornecer ao suporte? Dependendo do problema, colete ddboost_precert.log, logs rotacionados do precert, logs do BoostFS, DDPCONNCHK Saída, registros de aplicativos e pacotes de suporte solicitados.
    Resposta: Fornecer todos os registros relevantes ajuda a acelerar a solução de problemas.

    Pergunta: O que devo fazer se os logs ainda não forem gerados depois de seguir este artigo da KB? Coletar evidências, como a localização do ddboost_precert.ini, a listagem do diretório de log, DDPCONNCHK resultado, comando de montagem do BoostFS e informações de permissões.
    Resposta: Envie as informações coletadas ao suporte técnico da Dell para análise adicional.

    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.