База знаний Comindware - Резервное копирование и восстановление в Windows

Введение

Здесь представлены инструкции по резервному копированию и восстановлению данных Comindware Platform в ОС Windows.

См. также «Резервное копирование. Настройка и запуск, просмотр журнала сеансов».

Подготовка к резервному копированию и восстановлению данных

Для создания резервных копий и восстановления из них данных Comindware Platform необходимо подготовить перечисленные ниже сведения.

Подготовьте данные о конфигурации экземпляра ПО:
- Имя экземпляра ПО — <instanceName>.
- Путь к папке резервных копий базы данных — <DatabaseBackupPath> (например, X:\DatabaseBackups). См. «Настройка конфигураций и запуск резервного копирования».
- <distPath> — путь к распакованному дистрибутиву ПО Comindware Platform.
Подготовьте данные о конфигурации OpenSearch (Elasticsearch):
- Путь к файлу конфигурации OpenSearch (Elasticsearch) elasticsearch.yml (например: C:\ElasticsearchData\elasticsearch.yml)
- Имя репозитория снимков OpenSearch (Elasticsearch) — <repository_name> (например, elastic_backup).
- Путь к репозиторию снимков OpenSearch (Elasticsearch) — <elastic_backup_path>(например, e:\elastic_backup).
- Имя снимка OpenSearch (Elasticsearch) — <snapshot_name> (например, <instanceName>01022022080800 — в формате <instanceName><Date><Time>).
См. документацию OpenSearch (Elasticsearch) по формированию имён снимков.

Порядок резервного копирования данных экземпляра ПО

Данные экземпляра ПО находятся в двух хранилищах: базе данных экземпляра ПО и на сервере OpenSearch (Elasticsearch). Cм. «Подготовка к резервному копированию и восстановлению данных».

Здесь представлен следующий порядок резервного копирования:

Сохраните резервную копию базы данных экземпляра продукта.
Создайте снимок сервера OpenSearch (Elasticsearch). Этот шаг может не потребоваться в зависимости от вашей конфигурации OpenSearch (Elasticsearch).

Регистрация репозитория и создание снимка OpenSearch (Elasticsearch)

Определения

OpenSearch (Elasticsearch) — служба журналирования транзакций в составе Comindware Platform.

Снимок — набор данных, сохранённый на определённый момент времени.

Настройте конфигурацию репозитория снимков сервера OpenSearch (Elasticsearch) в файле elasticsearch.yml:
path.repo: <elastic_backup_path>
Чтобы зарегистрировать репозиторий, выполните следующую команду, указав в URL имя репозитория <repository_name> (см. «Подготовка к резервному копированию и восстановлению данных»), а в параметре location — путь к репозиторию из директивы path.repo в файле конфигурации сервера OpenSearch (Elasticsearch):
curl -X PUT "<openSearchHost>:<opeSearchPort>/_snapshot/<repository_name>?pretty" -H 'Content-Type: application/json' -d' {"type": "fs", "settings": {"location": "<elastic_backup_path>"}}'
См. документацию OpenSearch (Elasticsearch) по регистрации репозитория.
Чтобы создать снимок OpenSearch (Elasticsearch), выполните следующую команду, указав имя снимка <snapshot_name>, а в параметре indices — индексы, которые требуется включить в снимок (индексы Comindware Platform имеют префикс, например, cmw_<instanceName>_):
curl -X PUT "<openSearchHost>:<opeSearchPort>/_snapshot/<repository_name>/<snapshot_name>?wait_for_completion=true&pretty" -H 'Content-Type: application/json' -d' {"indices": "cmw_<instanceName>_*", "ignore_unavailable": true, "include_global_state": false}'
См. документацию OpenSearch (Elasticsearch) по созданию снимков.

Порядок восстановления данных экземпляра ПО

Внимание!

Перед восстановлением данных остановите экземпляр ПО.

См. «Установка, запуск, инициализация и остановка Comindware Platform в Windows».

Восстановите базу данных экземпляра ПО.
Восстановите снимок данных OpenSearch (Elasticsearch). Этот шаг может не потребоваться в зависимости от вашей конфигурации OpenSearch (Elasticsearch).

Восстановление базы данных экземпляра продукта

Запустите PowerShell от имени администратора.
Перейдите в директорию со скриптами для развёртывания ПО Comindware Platform:
cd "<distPath>\CMW_Windows<versionNumber>\scripts"
Остановите экземпляр ПО:
.\instance_stop.ps1 -name <instanceName>
Удалите или переместите директорию Database из директории экземпляра ПО:
Remove-Item -Path "C:\ProgramData\comindware\Instances\<instanceName>\Database" -Recurse
Распакуйте zip-архив резервной копии экземпляра ПО с расширением CDBBZ из папки <DatabaseBackupPath>.
Скопируйте в экземпляр ПО распакованную резервную копию базы данных:
Copy-Item -Path "<config_backup_path>\Database" -Destination "C:\ProgramData\сomindware\Instances\<instanceName>" -Recurse -Force
Здесь: <config_backup_path> — директория с распакованной резервной копией.

Запустите экземпляр ПО:

.\instance_start.ps1 -name <instanceName> 

Откройте сайт экземпляра ПО в браузере, одновременно открыв выдачу журналов экземпляра в PowerShell:
Get-Content "C:\ProgramData\comindware\Instances\<instanceName>\Logs\heartbeat_<ГГГГ-ММ-ДД>.log" -Wait
Проверьте и при необходимости исправьте конфигурацию экземпляра ПО. См. «Проверка и настройка конфигурации экземпляра ПО Comindware Platform после восстановления из резервной копии».
Проверьте и работоспособность экземпляра ПО.
Создайте резервную копию работоспособного экземпляра Comindware Platform.

Восстановление снимка OpenSearch (Elasticsearch)

Выполните следующую команду, указав имя репозитория <repository_name> и имя снимка <snapshot_name> (см. «Подготовка к резервному копированию и восстановлению данных»):

curl -X POST "<openSearchHost>:<opeSearchPort>/_snapshot/<repository_name>/<snapshot_name>/_restore?pretty" 

Подробные сведения о восстановлении снимков OpenSearch (Elasticsearch) см. в официальной документации (на английском языке): https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshots-restore-snapshot.html

Резервное копирование и восстановление в Windows