====== Установка мажорных обновлений ======
Установка мажорных обновлений подразумевает переход на новую версию продукта, например с 7.x.x на 8.x.x. Данная процедура подробно будет описана в документе "Руководство по обновлению
системы серверной виртуализации Р-Виртуализация", который будет выпущен вместе с новой версией продукта. 

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

Обновление до следующих мажорных версий желательно должно проводиться с участием сервисной службы производителя или поставщика решения. Обязательными этапами процесса обновления должны быть:
  - Подготовка детального плана работ, который должен включать в себя: 
    - актуальную карту настроек оборудования;
    - этапность проведения работ;
    - действия необходимые для проведения обновления (часть данного руководства);
    - действия в случае сбоя обновления для возврата к исходному состоянию;
    - контакты ответственных лиц заказчика, исполнителя, поставщика или производителя ПО Росплатформа для оказания технической поддержки при необходимости.
  - Высвобождение, перенос с другого проекта или приобретение как минимум 2 отдельных серверов для создания нового кластера виртуализации;
  - Очистка серверов и установка ПО Р-Виртуализация новой версии;
  - Создание нового кластера виртуализации, настройка параметров кластера;
  - Миграция части виртуальных машин, в соответствии со свободными ресурсами нового кластера;
  - Тестовая эксплуатация кластера собранного на новой версии программного обеспечения;
  - Принятие решения о продолжении или о возврате к исходному состоянию;
  - Поочередное высвобождение серверов и подключение к одною из кластеров в зависимости от принятого решения;
  - Миграция виртуальных машин в зависимости от принятого решения на новый или на старый кластер виртуализации.
  - Актуализация эксплуатационной документации.

===== Методика проведения миграции =====

Для обновления путем миграции виртуальных машин и контейнеров со старого кластера ПК Р-Хранилище на базе ПК Р-Виртуализация старой версии в новый кластер ПК Р-Хранилище на базе ПК Р-Виртуализация новой версии, необходимо выполнить следующие действия:
  - Установить обновления на все серверы в существующем кластере при помощи команды ''yum update''.
  - На наборе выделенных серверов необходимо создать новый кластер ПК Р-Хранилище на базе новой версии ПК Р-Виртуализация. Для этого необходимо руководствоваться актуальной на момент проведения работ инструкцией "Руководство по установке ПК Р-Виртуализация".
  - Далее необходимо провести миграцию виртуальных машин и контейнеров из старого кластера в новый кластер, согласно разделу данного руководства: "Миграция виртуальных машин и контейнеров со старых серверов ПК Р-Виртуализация на серверы с новой версией".
  - При наличии iSCSI сервера в существующем кластере необходимо провести миграцию, согласно разделу данного руководства: "Перемещение целей iSCSI между кластерами ПК Р-Хранилище"
  - При сохранении резервных копий на Р-Хранилище в существующем кластере виртуализации необходимо провести миграцию, согласно разделу данного руководства "Перенос резервных копий Р-Виртуализация на новые серверы ПК Р-Виртуализация"

==== Миграция виртуальных машин и контейнеров со старых серверов ПК Р-Виртуализация на серверы с новой версией ====

Система виртуализации поддерживает миграцию виртуальных машин только во включенном состоянии. Миграция контейнеров должна производиться только в выключенном состоянии. В процессе миграции виртуальные среды будут конвертированы в формат новой версии ПК Р-Виртуализация. Устройства виртуальных машин будут заменены на аналогичные устройства, поддерживаемые новой версией ПК Р-Виртуализация.
Для миграции виртуальных машин под управлением ОС Microsoft Windows в них должны быть установлены гостевые утилиты. 

Для запуска миграции работающей виртуальной машины или остановленного контейнера необходимо выполнить следующую команду на существующем кластере виртуализации:
<code bash> prlctl migrate <VM_or_CT_name> root@<New_IP_address_or_hostname> </code>

На время миграции виртуальная среда будет приостановлена. Скорость миграции а также время простоя зависят от пропускной способности сети, объема ОЗУ виртуальной машины и загрузки сервера. Для уменьшения времени простоя рекомендуется выполнять миграцию при минимальной загрузке сервера

==== Перемещение целей iSCSI между кластерами ПК Р-Хранилище ====

Для переноса iSCSI сервера с одного кластера на другой, необходимо выполнить следующие действия в командной строке:
  * Остановить цели iSCSI, если они запущены, и отменить их регистрацию на сервере. Командой
<code bash>
#Выполняется на старом сервере
vstorage-iscsi stop -t <iqn>
vstorage-iscsi unregister -t <iqn>
</code>
  * Назначить роль iSCSI сетевому интерфейсу нового сервера в панели управления ПК Р-Хранилище;
  * Скопировать директорию, содержащую цели iSCSI, со старого кластера в новый кластер. Расположение директорий приведено ниже:
    * ПК Р-Хранилище с управлением при помощи командной строки: ''/vstorage/<cluster_name>/iscsi/'',
    * ПК Р-Хранилище с управлением при помощи графического интерфейса ''/mnt/vstorage/vols/iscsi/''.
  * Зарегистрировать и запустить скопированные цели iSCSI на сервере с новой версией ПК Р-Виртуализация. Командой:
<code bash>
#Выполняется на новом сервере
vstorage-iscsi register -t <iqn>
vstorage-iscsi start -t <iqn>
</code>

==== Перенос резервных копий Р-Виртуализация на новые серверы ПК Р-Виртуализация ====
Для переноса резервной копии виртуальной среды на сервер с новой версией ПК Р-Виртуализация необходимо выполнить следующие действия:
  * Получить идентификатор резервной копии путем вывода списка резервных копий, которые хранятся на сервере ПК Р-Виртуализация:
<code bash> 
#Выполняется на новом сервере
prlctl backup-list root@<backup_server> 
</code>
  * Получить директорию для хранения резервных копий по умолчанию на сервере с новой версией ПК Р-Виртуализация:
<code bash> 
#Выполняется на старом сервере
prlsrvctl info | grep ”Backup path” 
</code>
  * Скопировать необходимые файлы резервных копий в директорию для хранения резервных копий на сервере с новой версией ПК Р-Виртуализация.
<code bash>
#Выполняется на новом сервере 
scp -r root@<legacy_server>:/<Backup path>/<VM_UUID> /vz/vmprivate/backups/
</code>