Домен даних: Увімкнення логування API DD Boost | Журнали пресертифікації
Summary: У цій статті з бази знань пояснюється, як увімкнути логування плагіна DD Boost при усуненні проблем, пов'язаних із Boost і BoostFS. Це називається журналом пресертифікації.
Instructions
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
- Творити
/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" в місці, вказаному в таблиці нижче. Це призведе до того, що 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, може знадобитися перезапуск служб, якщо не створено файл журналу для виявлення наявності або відсутності ddboost_precert.ini файлу
=====================================================================================================
Кроки для ввімкнення журналів 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: