Data Domain. Включение ведения журнала API DD Boost | Журналы Precert
Summary: В этой статье базы знаний объясняется, как включить ведение журнала подключаемого модуля DD Boost при устранении проблем, связанных с Boost и BoostFS. Это называется журналом precert.
Instructions
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
- Создание
/DDLogкаталог:mkdir /DDLogchmod 777 /DDLog
-
Создание
/ddboost_precert.iniс вышеуказанной конфигурацией. -
Убедитесь, что BoostFS размонтирована и повторно смонтирована.
mount -o log-level=debug <mount_point>
Настройка клиента Windows BOOSTFS
- Создание
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
-
-
Создание
C:\DDLogи назначьте полные разрешения на чтение/запись. -
Размонтируйте и повторно смонтируйте BoostFS с включенным ведением журнала отладки.
Очистка и отключение ведения журнала
- Удалите файл
ddboost_precert.ini. - Удалите файл
DDLogи его содержимое. - Повторно смонтируйте BoostFS, чтобы применить изменения.
- Соберите журналы 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, может потребоваться перезапуск служб, если не создан файл журнала для обнаружения наличия или отсутствия файла ddboost_precert.ini
=====================================================================================================
Действия по включению журналов 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::