Резервное копирование данных кластера

Sharx Base позволяет настроить резервное копирование логов, настроек и данных кластера.

Основные логи находятся в директории /var/lib/sharx/logs/.

База данных, содержащая описание кластера, находится в директории /var/lib/sharx/db/.

Логи Cassandra находятся в /var/log/cassandra/.

Настроить резервное копирование кластера

Чтобы настроить резервное копирование, выполните следующие шаги:

Предварительно настройте параметры экспорта командой
```
logdump export param add [--pre_exec <PRE_EXEC>]
                         [--post_exec <POST_EXEC>]
                         [--dirs <DIRS>]
                         [--files <FILES>]
                         [--db <DB>]
                         [--sosreport <SOSREPORT>]
                         [--path <PATH>]
                         [--passwd <PASSWD>]
```
где
- pre_exec — команда для выполнения до операции экспорта;
- post_exec — команда для выполнения после операции экспорта;
- dirs — список директорий, которые будут добавлены в ZIP-архив для экспорта. Задается в виде JSON-строки;
- files — список файлов, которые будут добавлены в ZIP-архив для экспорта. Задается в виде JSON-строки;
- db — экспорт всех данных из БД Cassandra.
  Возможные значения:
  - yes — экспорт выполняется,
  - no — экспорт не выполняется;
- sosreport — экспорт в архив различных журналов: веб-сервера, событий узлов кластера, логов отладки и РСХД, распределенной БД, ОС, плагинов ядра.
  Возможные значения:
  - yes — экспорт выполняется,
  - no — экспорт не выполняется;
- path — путь к директории, в которую будет экспортирован архив. По умолчанию — директория /var/tmp/;
- passwd — пароль для распаковки архива.
Чтобы посмотреть параметры экспорта в пределах ВЦОД, введите команду
```
logdump export param show
```

Обновить параметры

logdump export param update [--pre_exec <PRE_EXEC>]
                            [--post_exec <POST_EXEC>]
                            [--dirs <DIRS>]
                            [--files <FILES>]
                            [--db <DB>]
                            [--sosreport <SOSREPORT>]
                            [--path <PATH>]
                            [--passwd <PASSWD>]

После определения параметров выполните команду экспорта
```
logdump export add --node <UUID>
                   [--pre_exec <PRE_EXEC>]
                   [--post_exec <POST_EXEC>]
                   [--dirs <DIRS>]
                   [--files <FILES>]
                   [--db <DB>]
                   [--sosreport <SOSREPORT>]
                   [--path <PATH>]
                   [--passwd <PASSWD>]
                   [--delete_after <DELETE_AFTER>]
```
где
- node — идентификатор узла;
- pre_exec — команда для выполнения до операции экспорта;
- post_exec — команда для выполнения после операции экспорта;
- dirs — список директорий, которые будут добавлены в ZIP-архив для экспорта. Задается в виде JSON-строки;
- files — список файлов, которые будут добавлены в ZIP-архив для экспорта. Задается в виде JSON-строки;
- db — экспорт всех данных из БД Cassandra.
  Возможные значения:
  - yes — экспорт выполняется,
  - no — экспорт не выполняется;
- sosreport — экспорт в архив различных журналов: веб-сервера, событий узлов кластера, логов отладки и РСХД, распределенной БД, ОС, плагинов ядра.
  Возможные значения:
  - yes — экспорт выполняется,
  - no — экспорт не выполняется;
- path — путь к директории, в которую будет экспортирован архив. По умолчанию — директория /var/tmp/;
- passwd — пароль для распаковки архива;
- delete_after — дата удаления архива. Формат: YYYY-MM-DD или n, где n — целое число, которое обозначает количество дней, через которые архив будет удален. Например, 2, 3 и т.д.
При корректном экспорте в директории /var/tmp/ появится ZIP-архив с соответствующим именем узла, с которого был произведен экспорт журнала. Формат имени ZIP-архива uuid.zip
Просмотр списка всех выполненных операций экспорта
```
logdump export list
```
Просмотр определенной операции экспорта

bash logdump export show --uuid <export_uuid> [--node <NODE>]

где
- uuid — идентификатор операции;
- node — идентификатор узла.

Важно

Импорт резервных копий на другой кластер выполняет техническая поддержка Sharx Base

Cбор логов по операции

После выполнения команд в конце вывода или ответа всегда присутствует трейс-токен, имеющий вид 1efd1c0f-aa18-6c96-bc4a-f6d36bd9b3a5.

По трейс-токену можно собрать в архив логи всех плагинов, которые были затронуты в процессе вызова операции.

Чтобы собрать логи в архив, выполните команду

logdump trace --trace_token <token>

где trace_token - имя трейс-токена вида 1efd1c0f-aa18-6c96-bc4a-f6d36bd9b3a5.

Процесс сборки архива будет отображен в общем перечне архивов логдамп. После успешного завершения процесса на узле появится архив в директории /var/tmp.

Примечание

Данная команда доступна только Администратору кластера.
При возникновении ошибки во ВЦОД Администратор ВЦОД должен передать токен Администратору кластера, чтобы он собрал архив для изучения технической поддержкой

Термины и определения содержатся в статьях: