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

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

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. Включение ведения журнала 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.

Additional Information

Для версий 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::

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.