Домен даних: Ввімкнення логування API DD Boost — журнали Precert

Summary: У цій статті пояснюється, як увімкнути логування плагіна Data Domain Boost (DD Boost) при усуненні проблем, пов'язаних із Boost і BoostFS. Це називається журналом пресертифікації.

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

Примітка: Плагін DD Boost за замовчуванням не фіксує детальну активність API. Увімкнення журналування пресертифікації за допомогою ddboost_precert.ini Файл дозволяє проводити глибшу діагностику. Неправильне розміщення файлів, відсутність дозволів або неправильна конфігурація можуть завадити генерації журналу.

Причини для ввімкнення логування на рівні API (precert):

  • Операції DD Boost або BoostFS виходять з ладу або поводяться несподівано.
  • Інженерні або служби підтримки запитують детальні журнали на рівні API для аналізу.
  • Логі не генеруються, незважаючи на очікувану активність Boost.

Загальні примітки:

  • Увімкніть журнал пресертифікації лише за явним запитом інженерів або підтримки.
  • Уважно контролюйте простір на диску; журнали можуть швидко зростати.
  • Переконайтеся, що дозволи та розміщення файлів правильні.
  • Зніміть такі компоненти: .ini Файл для вимкнення ведення журналу.
  • BoostFS потрібно зняти з монтування та встановити заново, щоб зміни набули чинності.

Розташування файлів за ОС

Операційні системи ddboost_precert.ini Розташування ddboost_precert.log Розташування
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

Для версій BOOST та BoostFS до версії 7.0

Створіть порожній файл з ім'ям ddboost_precert.ini у відповідному місці (див. таблицю вище). Це дозволяє вести журнал на шлях за замовчуванням.

Для BOOST та BoostFS версії 7.0 та пізніших

Створіть конфігуроване ddboost_precert.ini Файл із таким змістом:

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
  • Ця конфігурація створює чотири лог-файли по 512 МБ кожен (всього 2 ГБ).
  • Відкоригуйте num_log_files та log_file_size За потребою.
  • Журнали можна перенаправити в інше місце, якщо обмежити місце на диску.

Налаштування клієнта Linux BOOSTFS

  1. Створити /DDLog Довідник:

mkdir /DDLog

chmod 777 /DDLog

  1. Створити /ddboost_precert.ini з наведеною вище конфігурацією.

 

  1. Переконайтеся BoostFS знімається і монтується знову:

mount -o log-level=debug <mount_point>

 

Налаштування клієнта Windows BOOSTFS

  1. Створити C:\ddboost_precert.ini З таким змістом:
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. Створити C:\DDLog та призначати повні права на читання/запис.
  2. Зняти і знову встановити BoostFS з увімкненим налагоджувальним логуванням.

Очищення та вимикання лісозаготівель

  1. Видалити ddboost_precert.ini Справу.
  2. Видалити DDLog Каталог та його зміст.
  3. Перемонтуйте BoostFS, щоб застосувати зміни.
  4. Збирайте логи BoostFS з /opt/emc/boostfs/log.

Additional Information

Поширені запитання (FAQ)

    Питання: Що таке журналування DD Boost Precert? 
    Відповідь: DD Boost Precert Log — це діагностична функція логування, яка фіксує транзакції DD Boost API між клієнтом DD Boost та системою Data Domain. Він часто використовується для усунення проблем із продуктивністю, відмов, затримок і проблем із зв'язком.

    Питання: Що охоплює журналування Precert? 
    Відповідь: Журналування пресертифікації фіксує активність API DD Boost, включаючи операції читання, операції запису, активність резервного копіювання, активність відновлення, взаємодію з бібліотекою DD Boost, інформацію про час виклику API та індикатори затримки на стороні клієнта. Він забезпечує детальний огляд поведінки DD Boost API для усунення несправностей та аналізу продуктивності.

    Питання: Чому не генеруються журнали пресертифікації? 
    Відповідь: Перевірте, що файл ddboost_precert.ini існує, розташований на корені операційної системи, каталог журналів існує, каталог журналу придатний для запису, і що запущено нову операцію резервного копіювання або відновлення. Найпоширенішими причинами є відсутність конфігурації, неправильне розміщення, проблеми з дозволом або відсутність нової активності DD Boost.

    Питання: Чи негайно ввімкнення журналування пресертифікації генерує журнали? 
    Відповідь: Ні, файли журналів генеруються лише тоді, коли надходять нові запити DD Boost API. Конфігурація дозволяє лише логування.

    Питання: Чому моя поточна резервна копія не генерує журнали пресертифікації? 
    Відповідь: Журналування пресертифікації фіксує лише активність API, започаткована після виявлення конфігурації. Існуючі завдання резервного копіювання або відновлення продовжуються без генерації журналів пресертифікації.

    Питання: Чи потрібно мені перезапускати резервне копіювання або відновити роботу? 
    Відповідь: Так, для створення журналів пресертифікації потрібна нова задача резервного копіювання або відновлення.  Якщо завдання вже працювало на момент увімкнення логування, починайте нову операцію.

    Питання: Яка найпоширеніша причина, чому журналування пресертифікації не працює? 
    Відповідь: Поширені причини включають ddboost_precert.ini Не на кореневому рівні, випадково отримав ім'я ddboost_precert.ini.txt, відсутній каталог журналу або недостатні прави. Найпоширенішими причинами є проблеми з конфігурацією та файловою системою.

    Питання: Куди слід розмістити файл ddboost_precert.ini? 

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

    Відповідь: Файл має зберігатися в кореневому каталозі операційної системи.

    Питання: Чи можна зберігати ddboost_precert.ini файл в іншій папці? 
    Відповідь: Ні, файл має зберігатися в корені. Плагін DD Boost перевіряє лише кореневу директорію операційної системи.

    Питання: Як я можу переконатися, що файл насправді не є 

    ddboost_precert.ini.txt

    Відкрийте Провідник файлів, увімкніть розширення імен файлів і перевірте ім'я файлу.
    Відповідь: Переконайтеся, що файл має назву 

    ddboost_precert.ini and not ddboost_precert.ini.txt.

    Питання: Чому DDLog Папка порожня після ввімкнення логування?
    Відповідь: Запустити нову резервну копію, відновити або DDPCONNCHK тестуйте для генерації активності.  Можливі причини включають відсутність нової активності DD Boost, проблеми з дозволами або файл конфігурації, який не був виявлений.

    Питання: Що таке DDPCONNCHK І чому це корисно? 
    Відповідь: DDPCONNCHK є інструментом валідації підключення DD Boost. Він може генерувати активність DD Boost API та швидко підтверджувати, що журналування пресертифікації працює.

    Питання: Може DDPCONNCHK Чи можна використовувати для тестування моєї конфігурації?
    Відповідь: Інженери часто запускають DDPCONNCHK після ввімкнення логування. Так, це поширений спосіб перевірити, чи генеруються журнали перед відтворенням проблеми.

    Питання: Чому мої журнали пресертифікації зростають так швидко?
    Відповідь: Журнал пресертифікації фіксує кожен виклик API DD Boost. Великі резервні середовища можуть генерувати значний обсяг журналів за короткий час.

    Питання: Скільки місця на диску слід виділити? Поширена рекомендація: 

    num_log_files=3 and log_file_size=500.

    Відповідь: Це забезпечує приблизно 1,5 ГБ сховища журналів до початку обертання.

    Питання: Чи можуть журнали пресертифікації заповнити файлову систему? 
    Відповідь: Логування може займати значну кількість місця на диску, якщо не контролювати. Так, повні файлові системи можуть призводити до збоїв резервного копіювання, збоїв і перебоїв у роботі сервісу.

    Питання: Яка мета num_log_files? 
    Відповідь: Цей параметр контролює кількість збережених обертаних файлів журналів. Приклад:, num_log_files=3 creates ddboost_precert.log, ddboost_precert.log.1, and ddboost_precert.log.2.

    Питання: Яка мета log_file_size? 
    Відповідь: Цей параметр визначає максимальний розмір кожного файлу журналу в MB. Наприклад, log_file_size=500 дозволяє кожному файлу збільшитися до 500 МБ перед обертанням.

    Питання: Що такеs ddcl_logs_include=true Робити?
    Відповідь: Він активує інформацію про логування Клієнтської бібліотеки DD Boost у журналах пресертифікації. Рекомендоване налаштування: ddcl_logs_include=true.

    Питання: Що означає ddcl_logs_sev=4 значення?
    Відповідь: Цей параметр контролює інтенсивність логування. Рівень серйозності 4 надає детальну інформацію про усунення несправностей і налагодження.

    Питання: Чи потрібно мені BoostFS Налагодження логування на додаток до попереднього логування? 
    Відповідь: Додаткові логи не завжди потрібні. for BoostFS-specific Проблеми, які дозволяють обидва варіанти, часто дають більш повну діагностичну картину.

    Питання: Для BoostFS, чи потрібно мені знімати і монтувати знову? 
    Відповідь: Зняття та повторне кріплення повторно ініціалізують активність BoostFS. У багатьох випадках, так, це допомагає ініціювати нову активність DD Boost.

    Питання: Який правильний синтаксис налагодження логів у BoostFS?
    Відповідь: Правильний синтаксис — -o log-level=debug. НЕ ВИКОРИСТОВУВАТИ --o log-level=debug Тому що лише одне тире є дійсним.

    Питання: Чому при повторному монтуванні BoostFS раптово з'явилися журнали пресертифікації? 
    Відповідь: Повторне кріплення створює новий цикл ініціалізації для BoostFS. Логування починається, коли з'являється нова активність DD Boost API і плагін виявляє конфігураційний файл.

    Питання: Чи еквівалентне перезапуск додатку повторному монтуванню BoostFS? 
    Відповідь: Зазвичай так, прикладами є перезапуск RMAN, програмне забезпечення для резервного копіювання або запуск DDPCONNCHK. Будь-яка дія, що створює нову активність DD Boost API, може спровокувати логування.

    Питання: Може RMAN Генерувати журнали пресертифікації без розкладання BoostFS? 
    Відповідь: Так, починаємо нове RMAN Зазвичай робота достатня. RMAN може ініціювати нові запити DD Boost API напряму.

    Питання: Як вимкнути логування попередньої сертифікації?
    Відповідь: Видаліть ddboost_precert.ini або перейменуйте на ddboost_precert.ini.disabled.

    Питання: Чи потрібно мені перезавантажити хост після видалення ini-файлу? 
    Відповідь: Ні, перезавантаження не потрібне. 

    Питання: Які дозволи слід використовувати в Linux? Приклади дозволів включають 

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

    Відповідь: Процес DD Boost повинен мати змогу читати конфігураційний файл і записувати його в каталог.

    Питання: Де за замовчуванням зберігаються логи BoostFS? 

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

    Відповідь: Ці локації відокремлені від журналів пресертування DD Boost.

    Питання: Чи є логи BoostFS і журнали пресертів одним і тим самим? 
    Відповідь: Ні, журнали пресертифікації містять транзакції DD Boost API, комунікації бібліотеки та дані про час введення/виведення. Журнали BoostFS містять активність монтування, операції файлової системи та події додатків.

    Питання: Які логи слід надати до Підтримки? 
    Відповідь: Надання всіх відповідних журналів допомагає прискорити усунення несправностей. Залежно від питання, збирайте ddboost_precert.log, ротайте журнали пресертування, логи BoostFS, DDPCONNCHK вихід, журнали додатків та запитувані пакети підтримки.

    Питання: Що мені робити, якщо логи досі не згенеровані після виконання цієї бази знань? 
    Відповідь: Зберіть докази, такі як ddboost_precert.ini місцезнаходження, список каталогу журналів, DDPCONNCHK вихід, команду кріплення BoostFS та інформацію про дозволи. Надішліть зібрану інформацію до технічної підтримки Dell для подальшого аналізу.

    Affected Products

    Data Domain

    Products

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