Data Domain: Habilitando o log da API do DD Boost | Precert Logs

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 o .ini para desativar o registro em log.
• O BoostFS deve ser desmontado e remontado para que as alterações entrem em vigor.

Localizações de arquivos por sistema operacional

Para versões do BOOST/BoostFS anteriores à 7.0

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

Para BOOST/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).
• Ajustar num_log_files e log_file_size conforme necessário.
• Os registros podem ser redirecionados para um local diferente se o espaço em disco for limitado.

Configuração do client Linux BOOSTFS

1. Create /DDLog diretório:
   • mkdir /DDLog
chmod 777 /DDLog

2. Create /ddboost_precert.ini com a configuração acima.

3. Certifique-se de que o BoostFS seja desmontado e remontado:

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

Instalação do client BOOSTFS do Windows

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

2. Create C:\DDLog e atribua permissões completas de leitura/gravação.

3. Desmonte e remonte o BoostFS com o log de depuração ativado.

Limpeza e desativação do log

1. Exclua o ddboost_precert.ini .
2. Exclua 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.

Para versões do BOOST/BoostFS anteriores à 7.0, os registros precert são ativados criando um arquivo vazio chamado exatamente "ddboost_precert.ini" no local indicado na tabela abaixo. Isso fará com que a API do SDK do DD Boost habilite esse registro no local padrão e no nome do arquivo, conforme mostrado na tabela abaixo: 

Essa ferramenta só deve ser ativada quando solicitada pelas equipes de engenharia ou suporte e, devido à quantidade de logs gerados, deve-se tomar cuidado para que esse log seja desativado o mais rápido possível.

 

Para BOOST e BoostFS 7.0 e versões posteriores, o arquivo "ddboost_precert.ini" precisa ser criado nos mesmos locais acima, mas não pode estar vazio, precisa ser inicializado com o conteúdo abaixo, caso contrário, ele não resultará na criação dos logs :
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



Com as configurações acima, ele criará 4 arquivos de 512MB cada, portanto, no total, levará apenas 2GB de espaço em disco.

Se 4 arquivos de 512 MB cada não cobrirem o período de tempo necessário para a solução de problemas, ajuste a quantidade de arquivos e seu tamanho usando os parâmetros "num_log_files" e "log_file_size".

Com a configuração mostrada, os logs serão criados no mesmo local que na tabela, mas há a opção de criar os logs em um local diferente, caso a partição raiz do sistema operacional não seja grande o suficiente.

NOTA: Essa pasta precisa estar presente no mesmo caminho que o arquivo ddboost_precert.ini (aguardando confirmação por alguém que conheça melhor, se isso for verdade, tornaria impossível gravar o log em alguma partição que não seja a raiz tipicamente pequena)