Установка Recovery Manager

Цель выполнения

Установка Recovery Manager является опциональной и необходима, если планируется использование централизованного каталога резервных копий.

Внимание!

При установке Task Manager необходимо также обязательно установить:

Предусловия

Перед началом установки убедитесь, что выполнены следующие условия:

Подготовлено окружение.
Дистрибутив CopyWala распакован в соответствии с инструкцией, приведенной в разделе Установка, шаг Распаковка дистрибутива CopyWala.

Последовательность действий

Установите пакет recovery-manager-{component_version}-{OS_version}.x86_64.rpm из директории pbr/owned/dbbr/rpms:

SberLinux, РЕД ОС, CentOS
Astra Linux
Альт СП

sudo dnf install {component_name}-{component_version}-{OS_version}.x86_64.rpm

sudo apt install {component_name}-{component_version}-{OS_version}.x86_64.deb

sudo apt-get install {component_name}-{component_version}-{OS_version}.x86_64.rpm

Пример заполненной команды:

sudo dnf install recovery-manager-1.1.0-sberlinux9.x86_64.rpm

Инициируйте создание конфигурационного файла командой recovery-manager.
Откройте файл конфигурации recovery-manager.yaml:
```
sudo vi ~/.pbr/recovery-manager.yaml
```

Заполните конфигурационные параметры.

Пример заполненных параметров

# --------------------------------------
# Настройки для взаимодействия с API Gateway
# --------------------------------------
api_gateway:
  address: http://api.pbr.host:29000 # адрес API Gateway
  trusted_ca: root.crt               # путь к доверенному сертификату для безопасного взаимодействия с API Gateway

# --------------------------------------
# Общие настройки приложения
# --------------------------------------
common:
  timeout: 10s # максимальное время выполнения запроса

# --------------------------------------
# Настройки для взаимодействия с OpenID
# --------------------------------------
open_id:
  realm_url: https://keycloak.host/realms/realm-name
  client_id: some-client-id         # идентификатор клиента из keycloak
  client_secret: some-client-secret # секрет из keycloak
  trusted_ca: root.crt              # путь к доверенному сертификату для безопасного взаимодействия с OpenID

# --------------------------------------
# Настройки для взаимодействия с AI-агентом (LLM-провайдером)
# --------------------------------------
ai:
  api_key: copywala@sbertech.ru|some-api-key # API-ключ для аутентификации в LLM-провайдере
  base_url: https://api.ai.sbt/openai/v1     # базовый URL LLM-провайдера (OpenAI-compatible endpoint)
  model: GigaChat-2                          # идентификатор LLM

# --------------------------------------
# Настройка ведения журналов приложения
# --------------------------------------
log:
  path: /var/log/pbr/recovery-manager.log     # путь к лог-файлу
  max_size: 100                               # максимальный размер лог-файла в мегабайтах. По умолчанию `100 МБ`
  max_age: 90                                 # максимальный возраст лог-файла в днях
  max_backups: 10                             # максимальное количество резервных копий лог-файлов, которые будут храниться. Если выбрано 0, то количество файлов не ограничено
  use_local_time: true                        # параметр определяет, в каком формате будут записываться метки времени в имена файлов при ротации. Если выбрано true, используется локальное системное время, при false (и по умолчанию) – `UTC`.
  compress_backups: false                     # параметр определяет необходимость сжатия резервных копий лог-файлов. Если выбрано true, лог-файлы будут сжаты, если false, лог-файлы будут храниться без сжатия

примечание

С подробной информацией о настройках конфигурации логов можно ознакомиться в разделе «Системный журнал».

Настройка TLS-сертификатов для Recovery Manager

примечание

Ниже приведены шаги настройки TLS-сертификатов для Copywala VDB. Настройка сертификатов для текущего компонента выполняется аналогичным образом.

Для обеспечения взаимодействия с Vector DB по протоколу HTTPS/mTLS выполните описанные ниже шаги:

Сгенерируйте корневой сертификат (далее – Root CA).

примечание
Данный шаг является опциональным, выполните его, если в инфраструктуре отсутствует готовый Root CA. В противном случае следует использовать уже существующий Root CA.
Важно помнить, что при самостоятельной генерации Root CA, его необходимо использовать для подписи сертификата сервера (Vector DB).

Пример команды:
```
openssl req -subj "/CN=RootCA" -newkey rsa:2048 -nodes \
-keyout rootCA.key \
-new -x509 \
-days 365 \
-out rootCA.crt
```
В результате будут получены:
- rootCA.key — приватный ключ Root CA;
- rootCA.crt — самоподписанный корневой сертификат.

Создайте файл openssl.cnf, указав актуальные значения, включая SAN-параметры:

[ req ]
default_bits        = 2048
default_md          = sha256
prompt              = no
distinguished_name  = req_distinguished_name
req_extensions      = req_ext

[ req_distinguished_name ]
C                   = RU
ST                  = Moscow
L                   = Moscow
O                   = myCompany
OU                  = IT Department
CN                  = example.com

[ req_ext ]
subjectAltName      = DNS:<dns_name>, DNS:localhost, IP:<ip>, IP:127.0.0.1

Замените <dns_name> и <ip> на фактические значения, используемые в инфраструктуре.

Сгенерируйте приватный ключ и CSR (пример команды):

openssl genpkey -algorithm RSA -out copywala-vdb.key

openssl req -new \
-key copywala-vdb.key \
-out copywala-vdb.csr \
-config openssl.cnf

Подпишите CSR с использованием Root CA (существующего или сгенерированного):
```
openssl x509 -req \
-in copywala-vdb.csr \
-CA rootCA.crt \
-CAkey rootCA.key \
-CAcreateserial \
-out copywala-vdb.crt \
-days 365 \
-extfile openssl.cnf \
-extensions req_ext
```
В результате будет создан сертификат для Copywala VDB – copywala-vdb.crt.
Для проверки корректности сертификата используйте команду:
```
openssl x509 -in copywala-vdb.crt -text -noout
```
В результате выполнения команды отображается:
- Subject и Issuer;
- срок действия;
- расширения сертификата (включая SAN);
- другие параметры X.509.
После генерации и/или получения сертификатов настройте подключение к Vector DB. Для этого в конфигурационном файле copywala-vdb.yaml заполните секцию tls, указав пути к созданным TLS-артефактам.

Проверка результата

Для проверки установки и работоспособности компонентов CopyWala обратитесь к разделу Чек-лист проверки корректности работы.

к сведению

После завершения установки данного модуля:

При необходимости выполните установку других модулей Platform V CopyWala.
Перейдите к следующему шагу — Настройка интеграции Platform V CopyWala с внешними сервисами.

Цель выполнения​

Предусловия​

Последовательность действий​

Настройка TLS-сертификатов для Recovery Manager​

Проверка результата​

Цель выполнения

Предусловия

Последовательность действий

Настройка TLS-сертификатов для Recovery Manager

Проверка результата