Быстрый запуск

Раздел предоставляет оптимальный путь для первоначального знакомства с продуктом Platform V CopyWala.

Предусловие

При отсутствии базы данных необходимо выполнить развертывание БД Platform V Pangolin DB (или PostgreSQL) согласно документации разработчика.

Последовательность действий для быстрого начала работы с CopyWala

Выполните следующие шаги:

1. Загрузите архив с дистрибутивом на целевую машину:

   $ scp PBR-X.X.X-XX_<версия ОС>-distrib.zip <hostname>:/home/user/copywala-distrib

2. Перейдите в директорию с дистрибутивом (в примере – copywala-distrib) и распакуйте дистрибутив CopyWala:

   $ cd copywala-distrib
   $ unzip PBRA-X.X.X-XX_<версия ОС>-distrib.zip

3. Выполните установку компонента Copywala:

   SberLinux, РЕД ОС, CentOS

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

   Astra Linux

   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

Настройте пользователя backup_user:

• Если пользователь существует, выдайте ему следующие разрешения:

  -- Разрешить наследование ролей (для работы pg_read_all_settings)
  ALTER USER backup_user WITH INHERIT;
  -- Предоставить доступ к чтению системных настроек
  GRANT pg_read_all_settings TO backup_user;
  -- Предоставить права на чтение системных представлений и функций, используемых для диагностики и наблюдения за работой сервера
  GRANT pg_monitor TO backup_user;

• Если пользователя не существует, создайте его:

  CREATE ROLE backup_user WITH PASSWORD '<пароль>';
  ALTER ROLE backup_user WITH
      NOSUPERUSER
      INHERIT
      NOCREATEROLE
      NOCREATEDB
      LOGIN
      REPLICATION
      NOBYPASSRLS;

  Предоставьте ему следующие разрешения:

  BEGIN;
  GRANT USAGE ON SCHEMA pg_catalog TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.current_setting(text) TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.pg_is_in_recovery() TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.pg_backup_start(text, boolean) TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.pg_backup_stop(boolean) TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.pg_create_restore_point(text) TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.pg_switch_wal() TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.pg_last_wal_replay_lsn() TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.txid_current() TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.txid_current_snapshot() TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.txid_snapshot_xmax(txid_snapshot) TO backup_user;
  GRANT EXECUTE ON FUNCTION pg_catalog.pg_control_checkpoint() TO backup_user;
  GRANT pg_read_all_settings TO backup_user;
  GRANT pg_monitor TO backup_user;
  COMMIT;

Проверьте наличие записей в файле pg_hba.conf для подключения пользователя backup_user:

host postgres backup_user 127.0.0.1/32 scram-sha-256
host replication backup_user 127.0.0.1/32 scram-sha-256

Создайте схему для хранения метаданных в резервных копиях:

CREATE SCHEMA pbr AUTHORIZATION backup_user;

7. Настройте в конфигурационном файле copywala.yaml раздел target_db для подключения к базе данных:

   target_db:
       host: {IP_ADDRESS}
       port: 5433
       user: <backup_user>
       password: <password>
       database: <postgres>
       query_params: search_path=pbr

Инициализируйте экземпляр copywala командой copywala init <agent_name>.

Где <name> – имя агента (agent_name), используемое для автоматического формирования уникального имени экземпляра агента (instance_name).

Настройте в конфигурационном файле copywala.yaml значение backup_destination_uri для указания места назначения резервных копий:

backup_destination_uri: /home/postgres/backups

10. Инициируйте резервное копирование от имени пользователя postgres через CLI copywala командой copywala create-backup.

11. Запустите команду copywala storage instances через CLI copywala для получения сгенерированного имени экземпляра БД и последующего его использования при восстановлении (параметр restore_instance_name).

12. Настройте в конфигурационном файле copywala.yaml параметры restore_data_path и restore_instance_name.

13. Выполните восстановление резервной копии от имени пользователя postgres через CLI copywala командой copywala restore latest.

примечание

Подробные инструкции для установки всех компонентов продукта приведены в руководстве по уcтановке, в разделе Установка.