# Руководство по внедрению в среде OpenUDS

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

Предположим, что у нас есть две независимые инсталляции OpenUDS на разных физических серверах: vdi-primary.test (Primary Broker) и vdi-secondary.test (Secondary Broker).

Основной брокер (Primary Broker) управляет доступом пользователей к активным сервисам, несущим бизнес-нагрузку организации. Однако, несмотря на предпринятые меры предосторожности, иногда возникают аварийные ситуации, такие как отказы оборудования, сетевые проблемы или другие непредвиденные события, которые могут привести к недоступности основного брокера.

В таких критических сценариях, необходимо быстро и эффективно восстановить доступ к сервисам организации. Для этого используется резервный брокер (Secondary Broker), предварительно подготовленный к принятию ресурсов VDI с основного в случае аварии.

В данном контексте мы будем рассматривать сценарий, в котором возникла аварийная ситуация на площадке с основным брокером (vdi-primary.test), и нам необходимо выполнить аварийное восстановление на резервный брокер (vdi-secondary.test). Разберем пошаговый план и действия, необходимые для успешного восстановления доступа к сервисам, используя модуль **xrm\_OpenUDS**, на примере нашего тестового стенда.

**Описание стенда:**

Две независимые инсталляции OpenUDS на разных физических серверах. Основной брокер управляет доступом к сервису Windows Static Multiple.

| Параметр       | Основной брокер         | Резервный брокер   |
| -------------- | ----------------------- | ------------------ |
| Адрес брокера  | vdi-primary.test        | vdi-secondary.test |
| Сервис-пул     | Windows Static Multiple | -                  |
| Учётная запись | user                    | root               |
| Аутентификатор | ActiveDirectory         | admin              |

**Основной брокер (Primary Broker):**

* **vdi-primary.test** – FQDN основного брокера, управляющего доступом к сервису Windows Static Multiple, с которого генерируем план восстановления;
* **Windows Static Multiple** – сервис-пул на основе провайдера машин со статическим IP;
* **user** – учётная запись с основного брокера;
* **ActiveDirectory** – аутентификатор Active Directory ;
* **RDP** – транспорт для подключения к сервису Windows Static Multiple типа Direct RDP.

**Резервная площадка (Secondary Site):**

* **vdi-secondary.test** – резервный брокер, предварительно подготовленный к принятию ресурсов VDI с основного в случае аварии;
* **root** – встроенная учётная запись администратора;
* **admin** – встроенный аутентификатор.

#### Шаг 1. Настройка раздела "ПАРАМЕТРЫ" модуля xrm\_OpenUDS для создания, удаления и запуска плана восстановления. <a href="#shag-1.-nastroika-razdela-parametry-modulya-xrm_openuds-dlya-sozdaniya-udaleniya-i-zapuska-plana-vos" id="shag-1.-nastroika-razdela-parametry-modulya-xrm_openuds-dlya-sozdaniya-udaleniya-i-zapuska-plana-vos"></a>

Войти в XRM, используя[ ](https://kb.x-rm.ru/dokumentaciya/dokumentaciya/xrm-versiya-1.2/rukovodstvo-polzovatelya)[Руководство пользователя](https://kb.pvhostvm.ru/hostvm-xrm/xrm-versii-1.2.1/rukovodstvo-polzovatelya). На верхней панели в меню навигации выбрать **МОДУЛИ**, слева в разделе **INSTALLED** выбрать модуль **xrm\_OpenUDS**

XRM, секция ПАРАМЕТРЫ модуля xrm\_OpenUDS

Cправа в секции **ПАРАМЕТРЫ** необходимо настроить требуемые параметры.

#### Шаг 2. Создание, удаление, и запуск планов восстановления. <a href="#shag-2.-sozdanie-udalenie-i-zapusk-planov-vosstanovleniya" id="shag-2.-sozdanie-udalenie-i-zapusk-planov-vosstanovleniya"></a>

Войти в XRM, на верхней панели в меню навигации выбрать **ДЕЙСТВИЯ**, слева развернуть раздел **XRM\_OPENUDS**.

XRM подключается к внешним системам с помощью расширяемого набора модулей, содержащих действия.

Действия - это набор сценариев доступных в составе модуля XRM. C помощью действий выполняются основные операции по управлению внешними системами, например, создание и запуск планов восстановления.

**В модуле доступны следующие действия с планами восстановления:**

| Действие                                                 | Описание                                                                                                                                                                                                                                                                                                                       |
| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Generate (Generate recovery plan configuration)          | <p><strong>Генерация нового плана восстановления.</strong></p><p>При запуске действия необходимо указать уникальное наименование плана (по умолчанию - test).</p>                                                                                                                                                              |
| Delete (Delete recovery plan configuration)              | <p><strong>Удаление существующего плана восстановления.</strong></p><p>При запуске действия необходимо указать наименование плана (по умолчанию - test).</p>                                                                                                                                                                   |
| Fail\_Over (Perform disaster recovery to secondary Site) | <p><strong>Запуск созданного с помощью действия Generate восстановления сервисов на резервной площадке.</strong></p><p>В рамках выполнения действия происходит перенос сервисов после сбоя на резервный брокер (Secondary Broker).</p><p>При запуске действия необходимо указать наименование плана (по умолчанию - test).</p> |

Для эффективного выполнения действия **Fail\_Over** (Выполнение процедуры аварийного восстановления на резервном брокере), необходимо сначала сгенерировать план восстановления – **Generate**.

**Шаг 2.1. Генерация плана восстановления.**

План определяет последовательность действий, необходимых для восстановления сервисов после аварии.

В меню навигации **XRM** выберите **ДЕЙСТВИЯ**, в левой части окна разверните раздел **XRM\_OPENUDS** и выберите опцию **Generate** (Generate recovery plan configuration).

В правой части окна укажите наименование плана восстановления **plan\_name**. Рекомендуется выбирать имя, которое ясно отражает суть аварийного восстановления, В нашем примере: **Plan\_Recovery**. После указания наименования плана восстановления, следует нажать кнопку **ЗАПУСТИТЬ**. После нажатия, в левом нижнем углу экрана отобразится всплывающее зеленое окно с надписью **Действие 'xrm\_openuds\_Generate' было успешно запущено.**

Чтобы убедиться в успешном завершении операции по генерации плана восстановления, в меню навигации XRM выберите **ИСТОРИЯ** в этом разделе находится история операций и событий. В левой части окна найдите запись, связанную с выполнением операции по генерации плана восстановления (**xrm\_openuds.Generate**). Если процесс генерации плана восстановления все еще выполняется, в правой части окна отображается надпись СТАТУС **Выполняется**. Это информирует вас о том, что операция еще не завершилась, и ей требуется дополнительное время для выполнения. В этом случае, дождитесь завершения процесса генерации. После внимательно просмотрите статус этой записи. Если операция завершилась успешно, вы увидите зеленую галочку и зеленую надпись **Успешно**.

В случае неуспешного выполнения, отобразится статус **Ошибка**. Для просмотра логов хода операции в правой части, на сером блоке с названием **result**, перейдите по ссылке **expand**.

После успешной генерации плана восстановления и сбора конфигурационных данных с основного брокера (Primary Broker) **vdi-primary.test** у нас теперь имеется готовый и эффективный план восстановления!

Когда аварийная ситуация произошла и основной брокер **vdi-primary.test** недоступен, резервный брокер **vdi-secondary.test** готов взять на себя роль основного для обеспечения непрерывности вашей инфраструктуры VDI. Давайте перейдем к следующему действию, которое заключается в запуске сервисов после сбоя на резервном брокере (Secondary Broker).

**Шаг 2.2. Процедура Fail\_Over. Восстановление работоспособности системы управления средой VDI. (Secondary Broker).**

В меню навигации **XRM** выберите **ДЕЙСТВИЯ**, в левой части окна разверните раздел **XRM\_OPENUDS** и выберите опцию **Fail\_Over** (Perform disaster recovery to secondary Site). В правой части окна укажите наименование плана восстановления **plan\_name**, который вы указывали в шаге 2.1. Генерация плана восстановления, в нашем примере: **Plan\_Recovery.** После указания имени плана восстановления, вам следует нажать кнопку **ЗАПУСТИТЬ**.

После нажатия, в левом нижнем углу экрана отобразится всплывающее зеленое окно с надписью **Действие 'xrm\_openuds\_Fail\_Over' было успешно запущено**.

Это сообщение указывает на то, что задача на выполнение операции Fail\_Over была успешно создана, и поставлена в очередь для выполнения.

В меню навигации **ИСТОРИЯ** вы так же можете отслеживать ход выполнения процедуры **xrm\_openuds.Fail\_Over** по аналогии с предыдущим шагом.

Процедура **Fail\_Over** успешно завершена. Сервис-пул добавлен на резервную площадку.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.x-rm.ru/dokumentaciya/dokumentaciya-xrm/xrm-versiya-1.2.1/rukovodstvo-administratora-modul-xrm_openuds/rukovodstvo-po-vnedreniyu-v-srede-openuds.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.