Домен даних: Увімкнення логування API DD Boost | Журнали пресертифікації

Summary: У цій статті з бази знань пояснюється, як увімкнути логування плагіна 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.

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
  2. Творити /ddboost_precert.ini з наведеною вище конфігурацією.

  3. Переконайтеся, що 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
  2. Творити C:\DDLog та призначати повні права на читання/запис.

  3. Зніміть і знову монтуйте BoostFS з увімкненим логуванням налагодження.


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

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

Additional Information

Для версій BOOST / BoostFS до 7.0 журнали precert включаються шляхом створення порожнього файлу з ім'ям точно "ddboost_precert.ini" в місці, вказаному в таблиці нижче. Це призведе до того, що DD Boost SDK API увімкне це журналювання до розташування за замовчуванням та імені файлу, як показано в таблиці нижче: 

Цей інструмент слід вмикати лише за запитом команд інженерів або підтримки, а через кількість згенерованих журналів слід подбати про те, щоб це ведення журналів було вимкнено якомога швидше.

 

Операційна система Розташування файлу ddboost_precert.ini Розташування файлу ddboost_precert.log
Лінукс /ddboost_precert.ini /DDLog/ddboost_precert.log
Соляріс /ddboost_precert.ini /DDLog/ddboost_precert.log
Технологія UNIX /ddboost_precert.ini /DDLog/ddboost_precert.log
Вікна C:\ddboost_precert.ini [1] C:\DDLog\ddboost_precert.log


Для релізів 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



З наведеними вище налаштуваннями він створить 4 файли по 512 МБ кожен, тому загалом він займе лише 2 ГБ місця на диску.

Якщо 4 файли по 512 МБ не встигли виконати часовий проміжок, необхідний для усунення неполадок, будь ласка, відрегулюйте кількість файлів і їх розмір за допомогою параметрів «num_log_files» і «log_file_size».

При показаній конфігурації журнали будуть створюватися в тому ж місці, що і в таблиці, але є можливість створити журнали в іншому місці, якщо кореневий розділ операційної системи недостатньо великий.

ПРИМІТКА: Ця папка повинна бути присутня за тим же шляхом, що і файл ddboost_precert.ini (очікується підтвердження кимось, хто знає краще, якщо це правда, це зробить неможливим запис журналу в якийсь розділ, відмінний від типового маленького кореня) 


Коли файл .ini присутній (а у випадку для 7.0 або пізнішої версії має відповідний вміст), у папці /DDLog генерується файл журналу з іменем ddboost_precert.log (якщо такий шлях налаштовано).

ddboost_precert.log може зростати дуже швидко, оскільки всі виклики API реєструються у файлі, тому звертайте увагу на кількість вільного місця в місці клієнта для журналів, оскільки вони можуть спричинити заповнення розділу та призвести до простою та незручностей для клієнта.

Щоб зупинити ведення журналу, видаліть файл ddboost_precert.ini призведе до негайного припинення записів до налаштованого файлу.
 
Будь-які зміни у файлі ddboost_precert.ini вимагатимуть демонтування BOOSTFS, а потім повторного монтування, щоб зміни набули чинності.
Для іншого програмного забезпечення для резервного копіювання, яке використовує ddboost, може знадобитися перезапуск служб, якщо не створено файл журналу для виявлення наявності або відсутності ddboost_precert.ini файлу
 
[1] Файл ddboost_precert.ini має бути розміщений у корені каталогу встановлення.  Він може бути названий: Г:\ і т.д.   Якщо файл розміщено на іншому диску, а файл журналу не створено, все одно спробуйте C:\.

=====================================================================================================

Кроки для ввімкнення журналів precert на сервері

Linux Boostfs1. Створіть директорію DDLog як /DDLog

2. Створення файлу ddboost_precert.ini on / path з наступним вмістом
 
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

 
3. Збережіть вищевказаний вміст у файлі - ddboost_precert.ini

4. Переконайтеся, що каталог /DDLog має дозволи на запис. Надайте всі файли в директорії /DDLog.

a. Змініть дозволи як на DDLog, так і на ddboost_precert.ini
b. запустіть 'sudo chmod 777 DDLog/ ddboost_precert.ini'5

. Збирайте журнали BoostFS на рівні налагодження.

a. Від'єднайте та знову змонтуйте точку монтування BoostFS за допомогою опції '-o log-level=debug'
b. Ви також можете оновити рівень журналу у файлі boostfs.conf у директорії /opt/emc/boostfs/etc. Вам все одно знадобиться демонтування диска BoostFS.
c. Виконайте операцію резервного копіювання на точці монтування BoostFS.
d. Будь ласка, надайте всі файли в директорії - /opt/emc/boostfs/log


======================================================================================================

Увімкніть журнали попередньої сертифікації на сервері

Windows boostfs 1. Створіть ddboost_precert.ini під C:  диск з наступним змістом:

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. Створіть папку з іменем DDLog під диском C:. У цій папці будуть створені файли журналу precert. Будь ласка, надайте всі дозволи на читання/запис до директорії DDLog, щоб можна було створювати та додавати файли журналу.


ПРИМІТКА:
Наведена вище конфігурація створить максимум 3 файли журналу precert розміром близько 500 МБ кожен.
Для num_log_files та log_file_size можна використовувати різні значення, як вважаєте за потрібне.  Але 3 файли по 500 МБ кожен має вистачити для цієї мети.
Якщо в системі клієнта немає 1,5 Гб вільного місця, то значення log_file_size може бути зменшено до 200.
Будь ласка, переконайтеся, що в системі клієнта достатньо вільного місця на диску, перш ніж вмикати журнали попередньої сертифікації.

3. Від'єднайте та повторно змонтуйте точку монтування BoostFS за допомогою опції '-o log-level=debug'

 
Очищення активності та вимкнення журналу precert

Після того, як журнали precert буде зібрано після випуску, вимкніть передсертифікаційне журналювання, виконавши наступні дії. Це потрібно зробити перед повторним монтажем BoostFS SU.
1. Видаліть папку DDLog з C: та її вміст
2. Видаліть ddboost_precert.ini файл з C:



=====================================================================================================Увімкніть журнали precert на сервері Linux за допомогою програми резервного копіювання ddboost.

Порядок дій для ввімкнення протоколювання DDBoost Precert на сервері ddboost Linux: 

Створити директорію /DDLog

2. Надайте всі дозволи всім користувачам для каталогу /DDLog за допомогою наступної команди:

       $ chmod 777 /DDLog

3. Створіть файл /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

4. Журнали precert будуть генеруватися в директорії /DDLog.
=======================================================================================


Увімкніть журнали precert на сервері Windows за допомогою програми резервного копіювання ddboost.  

1. Створіть ddboost_precert.ini під C:  диск з наступним змістом:

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. Створіть папку з іменем DDLog під диском C:. У цій папці будуть створені файли журналу precert. Будь ласка, надайте всі дозволи на читання/запис до директорії DDLog, щоб можна було створювати та додавати файли журналу.


ПРИМІТКА:
Наведена вище конфігурація створить максимум 3 файли журналу precert розміром близько 500 МБ кожен.
Для num_log_files та log_file_size можна використовувати різні значення, як вважаєте за потрібне.  Але 3 файли по 500 МБ кожен має вистачити для цієї мети.
Якщо в системі клієнта немає 1,5 Гб вільного місця, то значення log_file_size може бути зменшено до 200.
Будь ласка, переконайтеся, що в системі клієнта достатньо вільного місця на диску, перш ніж вмикати журнали попередньої сертифікації.
 

Очищення активності та вимкнення журналу precert

Після того, як журнали precert буде зібрано після проблеми, вимкніть передсертифікаційне журналювання, виконавши наступні дії. 
1. Видаліть папку DDLog з C: та її вміст
2. Видаліть ddboost_precert.ini файл з C:

Affected Products

Data Domain

Products

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