33.1. Создание экземпляра #
Важно
Агенты автоматически обнаруживают установленные на сервере хосты, экземпляры, объекты экземпляров и другие компоненты и создают их в веб-приложении. Автоматическое обнаружение можно настроить в файле конфигурации агента ppem-agent.yml.
Автоматическое обнаружение и ряд других возможностей не поддерживаются при установке PPEM с усиленными мерами безопасности.
33.1.1. Создание нового экземпляра #
Создание нового экземпляра подразумевает создание нового каталога данных (data directory) и запуск службы экземпляра на сервере.
Чтобы создать новый экземпляр:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
В правом верхнем углу страницы нажмите Добавить экземпляр.
Выберите Создать новый экземпляр, затем нажмите Далее.
Укажите параметры нового экземпляра (помеченные звёздочкой параметры являются обязательными):
Имя.
Сервер: сервер, на котором установлен экземпляр.
Версия: версия Postgres Pro на сервере экземпляра.
Каталог данных: путь к каталогу на сервере, в котором размещены основные каталоги и файлы экземпляра.
Бинарный каталог (bindir): путь к каталогу сервера, в котором размещены исполняемые файлы экземпляра.
Системный пользователь: пользователь операционной системы, которому принадлежат файлы и каталоги экземпляра, и от имени которого запускается служба экземпляра. В большинстве случаев это пользователь
postgres.Убедитесь, что указанный пользователь существует в операционной системе.
Способ подключения: способ, который клиенты используют для подключения к экземпляру.
Возможные значения:
Сетевой адрес.
Для этого значения из выпадающего списка Сетевой адрес выберите сетевой адрес, который экземпляр использует для приёма клиентских подключений.
Unix-сокет.
Для этого значения в поле Каталог Unix-сокета введите путь к каталогу Unix-сокета, который экземпляр использует для приёма клиентских подключений.
Порт: номер порта, который экземпляр использует для приёма клиентских подключений.
Метод аутентификации: метод аутентификации, который экземпляр использует для проверки пользователей при приёме клиентских подключений.
Возможные значения:
scram-sha-256.
md5.
trust: не выполнять аутентификацию.
Рекомендуется выбирать это значение только для тестовой среды.
Суперпользователь БД и Пароль суперпользователя БД: имя и пароль суперпользователя СУБД, который создаётся, и от имени которого агент подключается к экземпляру.
Имя пользователя по умолчанию —
postgres.
Нажмите Далее, затем при необходимости укажите дополнительные параметры:
Пресет конфигурации: пресет конфигурации, который применяется к экземпляру.
Возможные значения:
—: не применять к экземпляру пресет конфигурации.
Settings for 1C: применить к экземпляру пресет конфигурации для 1C.
Settings for OLTP: применить к экземпляру пресет конфигурации для OLTP (Online Transaction Processing).
Вы можете применить другой пресет конфигурации к экземпляру позднее.
Параметры конфигурации: параметры конфигурации, которые применяются к экземпляру.
Чтобы добавить параметр, укажите параметр и его значение, затем нажмите Добавить.
Вы можете добавить несколько параметров. Добавленные параметры имеют приоритет перед ранее указанным пресетом конфигурации.
Теги: теги, которые назначены экземпляру.
Запустить экземпляр после создания: указывает, следует ли запустить службу экземпляра после его создания.
За подробной информацией обратитесь к Разделу 33.5.
Имя сервиса: имя службы экземпляра.
К указанному имени службы автоматически добавляется расширение
.service.
Нажмите Добавить экземпляр.
33.1.2. Создание экземпляра из резервной копии #
За подробной информацией обратитесь к Главе 58.
Перед выполнением этой инструкции создайте резервную копию.
Чтобы создать экземпляр из резервной копии:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
В правом верхнем углу страницы нажмите Добавить экземпляр.
Выберите Создать новый экземпляр из резервной копии, затем нажмите Далее.
Укажите параметры резервной копии, из которой создан экземпляр (помеченные звёздочкой параметры являются обязательными):
Хранилище: хранилище, в котором размещена резервная копия.
Можно использовать локальное или S3-хранилище. Локальное хранилище должно находиться на одном сервере с экземпляром, для которого создана резервная копия.
Экземпляр: экземпляр, для которого создана резервная копия.
Период: период, в который была создана резервная копия.
Резервная копия: резервная копия, из которой создан экземпляр.
Нажмите Далее, затем укажите параметры нового экземпляра (помеченные звёздочкой параметры являются обязательными):
Имя.
Сервер: сервер, на котором установлен экземпляр.
Версия: версия Postgres Pro на сервере экземпляра.
Каталог данных: путь к каталогу на сервере, в котором размещены основные каталоги и файлы экземпляра.
Бинарный каталог (bindir): путь к каталогу сервера, в котором размещены исполняемые файлы экземпляра.
Системный пользователь: пользователь операционной системы, которому принадлежат файлы и каталоги экземпляра, и от имени которого запускается служба экземпляра. В большинстве случаев это пользователь
postgres.Убедитесь, что указанный пользователь существует в операционной системе.
Доступное пространство: позволяет проверить, достаточно ли на сервере дискового пространства для создания экземпляра из резервной копии.
Чтобы запустить проверку, нажмите Проверить.
Внешние каталоги: если резервная копия включает каталоги, размещённые вне каталога данных экземпляра, этот параметр позволяет указать соответствующие каталоги для создаваемого экземпляра.
Точка восстановления: состояние, которое необходимо восстановить для экземпляра.
Возможные значения:
Последнее состояние резервной копии: Восстановить последнее состояние экземпляра в рамках резервной копии.
Дата и время: восстановить состояние экземпляра на указанную дату и время в рамках резервной копии.
Для этого значения в поле Дата и время укажите дату и время.
LSN: восстановить состояние экземпляра, соответствующее указанному последовательному номеру в WAL.
Для этого значения в поле LSN введите последовательный номер в WAL.
Идентификатор транзакции: восстановить состояние экземпляра, соответствующее указанному номеру транзакции.
Для этого значения в поле Иденификатор транзакции введите идентификатор транзакции.
Для значений Дата и время, LSN и Идентификатор транзакции укажите следующий параметр:
Восстановить состояние на указанные дату и время включительно / Восстановить состояние, соответствующее указанному LSN включительно / Restore the state corresponding to the specified transaction inclusive: указывает, следует ли восстановить экземпляр до указанного значения включительно.
Например, если в поле Идентификатор транзакции вы вводите
123456и устанавливаете флажок Восстановить состояние, соответствующее указанной транзакции включительно, для экземпляра восстанавливается состояние, соответствующее транзакции123456. Если вы не устанавливаете флажок Восстановить состояние, соответствующее указанной транзакции включительно, для экземпляра восстанавливается состояние, соответствующее транзакции с идентификатором123455.Восстановление баз данных: указывает, какие базы данных восстанавливаются или наоборот исключаются из процесса восстановения.
Возможные значения:
Восстановить все базы данных.
Исключить указанные базы данных.
Восстановить указанные базы данных.
Для значений Исключить указанные базы данных и Восстановить указанные базы данных в поле Исключить базы данных или Восстановить базы данных введите уникальное имя базы данных, затем нажмите Добавить.
Вы можете добавить несколько баз данных.
Нажмите Далее, затем укажите дополнительные параметры (помеченные звёздочкой параметры являются обязательными):
Действие после восстановления: указывает, какое действие следует выполнить на сервере после восстановления состояния для экземпляра.
Возможные значения:
Запустить экземпляр.
Не запускать экземпляр.
За подробной информацией обратитесь к Разделу 33.5.
Способ подключения: способ, который клиенты используют для подключения к экземпляру.
Возможные значения:
Сетевой адрес.
Для этого значения из выпадающего списка Сетевой адрес выберите сетевой адрес, который экземпляр использует для приёма клиентских подключений.
Unix-сокет.
Для этого значения в поле Каталог Unix-сокета введите путь к каталогу Unix-сокета, который экземпляр использует для приёма клиентских подключений.
Порт: номер порта, который экземпляр использует для приёма клиентских подключений.
Пресет конфигурации: пресет конфигурации, который применяется к экземпляру.
Возможные значения:
—: не применять к экземпляру пресет конфигурации.
Settings for 1C: применить к экземпляру пресет конфигурации для 1C.
Settings for OLTP: применить к экземпляру пресет конфигурации для OLTP (Online Transaction Processing).
Вы можете применить другой пресет конфигурации к экземпляру позднее.
Параметры конфигурации: параметры конфигурации, которые применяются к экземпляру.
Чтобы добавить параметр, укажите параметр и его значение, затем нажмите Добавить.
Вы можете добавить несколько параметров. Добавленные параметры имеют приоритет перед ранее указанным пресетом конфигурации.
Теги: теги, которые назначены экземпляру.
Имя сервиса: имя службы экземпляра.
К указанному имени службы автоматически добавляется расширение
.service.
Нажмите Добавить экземпляр.
33.1.3. Добавление существующего экземпляра #
Добавление существующего экземпляра может потребоваться, если у агента выключена функция автоматического обнаружения установленных на сервере экземпляров.
Перед выполнением этой инструкции убедитесь, что экземпляр запущен на сервере и готов принимать клиентские подключения.
Чтобы добавить существующий экземпляр:
В навигационной панели перейдите в Инфраструктура → Экземпляры.
В правом верхнем углу страницы нажмите Добавить экземпляр.
Выберите Добавить существующий экземпляр, затем нажмите Далее.
Укажите параметры обнаружения экземпляра (помеченные звёздочкой параметры являются обязательными), затем запустите процесс обнаружения:
Из выпадающего списка Агент выберите агента, который должен обнаружить экземпляры.
(Необязательно) В разделе Искать в директориях нажмите Добавить, затем укажите каталог сервера, в котором агент должен обнаружить экземпляры.
Вы можете добавить несколько каталогов. По умолчанию каталоги не добавлены, то есть агент обнаруживает экземпляры во всех каталогах на сервере.
Нажмите Начать поиск.
Выберите экземпляр из списка обнаруженных экземпляров.
Если список пуст, проверьте и исправьте параметры обнаружения, затем снова нажмите Начать поиск.
Нажмите Далее, затем укажите параметры нового экземпляра (помеченные звёздочкой параметры являются обязательными):
Имя.
Сервер: сервер, на котором установлен экземпляр.
Версия: версия Postgres Pro на сервере экземпляра.
Каталог данных: путь к каталогу на сервере, в котором размещены основные каталоги и файлы экземпляра.
Бинарный каталог (bindir): путь к каталогу сервера, в котором размещены исполняемые файлы экземпляра.
Системный пользователь: пользователь операционной системы, которому принадлежат файлы и каталоги экземпляра, и от имени которого запускается служба экземпляра. В большинстве случаев это пользователь
postgres.Убедитесь, что указанный пользователь существует в операционной системе.
Способ подключения: способ, который клиенты используют для подключения к экземпляру.
Возможные значения:
Сетевой адрес.
Для этого значения из выпадающего списка Сетевой адрес выберите сетевой адрес, который экземпляр использует для приёма клиентских подключений.
Unix-сокет.
Для этого значения в поле Каталог Unix-сокета введите путь к каталогу Unix-сокета, который экземпляр использует для приёма клиентских подключений.
Порт: номер порта, который экземпляр использует для приёма клиентских подключений.
Суперпользователь БД и Пароль суперпользователя БД: имя и пароль суперпользователя СУБД, который создаётся, и от имени которого агент подключается к экземпляру.
Имя пользователя по умолчанию —
postgres.Способ запуска: указывает способ запуска экземпляра.
Возможные значения:
systemd: запустить экземпляр с помощью модуля systemd.
Это рекомендуемый способ запуска.
pg_ctl: запустить экземпляр с помощью утилиты pg_ctl.
Теги: теги, которые назначены экземпляру.
Нажмите Добавить экземпляр.