Data Domain. Включение ведения журнала API DD Boost | Журналы Precert

Сводка: В этой статье базы знаний объясняется, как включить ведение журнала подключаемого модуля DD Boost при устранении проблем, связанных с Boost и BoostFS. Это называется журналом precert.

Данная статья применяется к Данная статья не применяется к Эта статья не привязана к какому-либо конкретному продукту. В этой статье указаны не все версии продуктов.

Инструкции

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

Причины для включения ведения журнала на уровне API (precert):

  • Операции DD Boost или BoostFS завершаются сбоем или ведут себя непредвиденно.
  • Инженерный отдел или служба поддержки запрашивает подробные журналы на уровне API для анализа.
  • Журналы не создаются, несмотря на ожидаемую активность Boost.

Общие примечания:

  • Включайте ведение журнала precert только по явному запросу инженерного отдела или службы поддержки.
  • Внимательно следите за дисковым пространством; Бревна могут быстро расти.
  • Убедитесь в правильности разрешений и размещении файлов.
  • Извлеките .ini , чтобы отключить ведение журнала.
  • Чтобы изменения вступили в силу, необходимо размонтировать и повторно смонтировать BoostFS.

Расположение файлов по ОС

Операционная система ddboost_precert.ini Местонахождение ddboost_precert.log Местонахождение
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris /ddboost_precert.ini /DDLog/ddboost_precert.log
ЮНИКС /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.

Дополнительная информация

Для версий BOOST / BoostFS, предшествующих 7.0, журналы precert включаются путем создания пустого файла с именем точно «ddboost_precert.ini» в местоположении, указанном в таблице ниже. Это приведет к тому, что API SDK DD Boost включит ведение этого журнала в местоположение по умолчанию и имя файла, как показано в таблице ниже. 

Этот инструмент следует включать только по запросу групп проектирования или поддержки, и из-за большого количества создаваемых журналов следует позаботиться о том, чтобы отключить это ведение как можно скорее.

 

Операционная система Расположение файла ddboost_precert.ini Расположение файла ddboost_precert.log
Linux /ddboost_precert.ini /DDLog/ddboost_precert.log
Solaris /ddboost_precert.ini /DDLog/ddboost_precert.log
ЮНИКС /ddboost_precert.ini /DDLog/ddboost_precert.log
Windows 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 должен быть помещен в корень каталога установки.  Он может называться: D:\ и т.д.   Если файл размещается на другом диске и файл журнала не создается, все равно попытайтесь выполнить команду C:\.

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

Действия по включению журналов precert на сервере

linux boostfs1. Создайте каталог DDLog как /DDLog

2. Создайте файловую ddboost_precert.ini /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».
Вы также можете обновить уровень журнала в файле boostfs.conf в каталоге /opt/emc/boostfs/etc. Вам по-прежнему потребуется размонтировать и смонтировать диск BoostFS.
c. Выполните операцию резервного копирования в точке монтирования BoostFS.
d. Укажите все файлы в каталоге /opt/emc/boostfs/log


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

Включите журналы precert на сервере

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.
Убедитесь, что в клиентской системе достаточно свободного дискового пространства, прежде чем включать журналы precert.

3. Отключите и повторно смонтируйте точку монтирования BoostFS с параметром «-o log-level=debug»


Действия очистки и отключение ведения журнала

precertПосле сбора журналов precert после возникновения проблемы отключите ведение журнала precert, выполнив следующие действия.  Это необходимо сделать перед повторным монтированием BoostFS SU.
1. Удаление папки DDLog из C: и ее содержимого
2. Удалите ddboost_precert.ini файл из папки C::



=====================================================================================================Включите журналы precert на сервере Linux с помощью приложения резервного копирования ddboost.

Процедура включения ведения журнала DDBoost Precert на сервере linux ddboost: 

Создайте каталог /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 Server с помощью приложения резервного копирования 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После сбора журналов precert после возникновения проблемы отключите ведение журнала precert, выполнив следующие действия. 
1. Удаление папки DDLog из C: и ее содержимого
2. Удалите ddboost_precert.ini файл из папки C::

Затронутые продукты

Data Domain

Продукты

Data Domain
Свойства статьи
Номер статьи: 000020437
Тип статьи: How To
Последнее изменение: 10 Nov 2025
Версия:  7
Получите ответы на свои вопросы от других пользователей Dell
Услуги технической поддержки
Проверьте, распространяются ли на ваше устройство услуги технической поддержки.