Data Domain: ativando o log da API do DD Boost – Logs Precert
Sammendrag: 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.
Instruksjoner
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
.iniPara 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_fileselog_file_sizecomo exigido: - Os registros podem ser redirecionados para um local diferente se o espaço em disco for limitado.
Configuração do client Linux BOOSTFS
- Criar
/DDLogno diretório:
mkdir /DDLog
chmod 777 /DDLog
- Criar
/ddboost_precert.inicom a configuração acima.
- Certificar-se O BoostFS é desmontado e remontado:
mount -o log-level=debug <mount_point>
Instalação do client BOOSTFS do Windows
- Criar
C:\ddboost_precert.inicom 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
- Criar
C:\DDLoge atribua permissões completas de leitura/gravação. - Desmontar e remontar BoostFS com log de depuração ativado.
Limpeza e desativação do log
- Excluir o .
ddboost_precert.ini. - Excluir o .
DDLogdiretório e seu conteúdo. - Remonte o BoostFS para aplicar as alterações.
- Coletar logs do BoostFS de
/opt/emc/boostfs/log.
Tilleggsinformasjon
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.