База знаний 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м. «Подготовка к резервному копированию и восстановлению данных».

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

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

Резервное копирование крупных баз данных

Если размер базы данных превышает 10 ГБ, рекомендуется использовать скрипт резервного копирования на сервере для обеспечения оптимальной производительности резервного копирования и работы Comindware Platform.

Это связано с тем, что резервное копирование больших баз данных встроенными средствами Comindware Platform создаёт значительную вычислительную нагрузку и может приводить к снижению производительности.

См. «Настройка и использование скрипта для резервного копирования данных (Linux)».

Скрипт резервного копирования следует запросить у службы поддержки Comindware.
Создайте снимок сервера 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