Обновление в облаке

Обновление MikoPBX, развернутой как виртуальная машина в облаке

Рекомендуется производить обновления последовательно, «не перепрыгивая» через релизы и версии.

Эта инструкция предназначена для MikoPBX, работающей как полноценная облачная виртуальная машина: из Marketplace либо из импортированного RAW, VHD или другого дискового образа.

Встроенный механизм обновления рассчитан на штатную дисковую установку MikoPBX с загрузочным разделом, разделом конфигурации /cf и подключённым Storage. Он не предназначен для Docker и LXC.

Основной способ обновления облачной станции — через web-интерфейс с использованием .img-образа. Возможность загрузки с ISO зависит от конкретного облачного провайдера и не является универсальной.

Перед обновлением создайте две независимые точки восстановления: резервную копию настроек MikoPBX и snapshot системного диска или всей виртуальной машины в панели облачного провайдера.

Перед началом

1. Проверьте, что у вас есть доступ к панели управления облаком и web-интерфейсу MikoPBX. Сохраните резервную копию настроек MikoPBX, а так же записей разговоров вне обновляемой виртуальной машины.

2. Создайте snapshot системного диска. При наличии отдельного диска с записями создайте snapshot и для него либо используйте резервное копирование хранилища.

3. Запишите текущий внешний и внутренний IP-адреса, правила Security Group, подключённые диски и параметры сети.

4. Убедитесь, что на системном диске с MikoPBX свободно не менее 400 МБ.

5. Запланируйте техническое окно: активные вызовы будут завершены.

Обновление заменой виртуальной машины

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

При штатной работе MikoPBX сохраняет служебную копию базы настроек на Storage каждые 5 минут. Если новая система запускается с заводской конфигурацией, MikoPBX ищет эти копии на подключённых дисках, выбирает самую свежую, восстанавливает /cf/conf/mikopbx.db, проверяет целостность базы и перезагружается.

Это не восстановление старого системного образа: операционная система остаётся новой. Записи разговоров, история вызовов, модули и другие данные не копируются обратно, а продолжают использоваться непосредственно с подключённого Storage.

Подготовка

1. Создайте резервную копию настроек средствами MikoPBX и скачайте её на компьютер. Резервная копия, сохранённая вне облака, нужна на случай, если служебная копия на Storage окажется недоступна или повреждена.

2. После последнего изменения настроек подождите не менее 5 минут, чтобы MikoPBX успела записать свежую служебную копию базы на Storage.

3. Завершите активные вызовы и остановите старую VM. Создайте snapshot отдельного диска Storage. Для надёжного отката также сохраните snapshot старого системного диска или всей VM.

4. Зафиксируйте параметры старой VM: архитектуру процессора, внутренний и публичный IP-адреса, подсеть, Security Group, тип и порядок подключения дисков.

Создание и переключение ВМ

1. Создайте новую виртуальную машину с MikoPBX требуемой версии и той же архитектуры процессора. Например, в Yandex Cloud можно использовать доступный образ MikoPBX из Marketplace.

2. Не запускайте новую VM и не изменяйте её заводские настройки до подключения Storage.

3. Создайте из snapshot отдельный диск Storage и подключите его к новой VM как дополнительный диск. Snapshot должен сохранять исходную разметку, файловую систему и каталог mikopbx/backup/db.

4. Запустите новую VM. Во время первой загрузки MikoPBX обнаружит заводскую конфигурацию, найдёт служебную копию настроек на Storage и восстановит её. После успешного восстановления система автоматически перезагрузится ещё раз — не прерывайте этот процесс.

5. Войдите в web-интерфейс и проверьте:

   • установленную версию MikoPBX;

   • внутренние номера, провайдеров и маршруты;

   • подключение Storage;

   • историю вызовов, записи разговоров, звуковые файлы и модули;

   • сетевые настройки и доступность телефонии.

6. Оставив старую VM выключенной, перенесите её публичный IP-адрес на новую VM. Ещё раз проверьте входящие и исходящие вызовы.

7. Не удаляйте старую VM и snapshots до завершения проверки и создания свежей резервной копии уже обновлённой станции.

Онлайн-обновление

1. Войдите в web-интерфейс MikoPBX.

2. Откройте "Обслуживание" → "Обновление PBX".

Раздел "Обновление PBX"

1. Найдите необходимую версию в таблице "Доступны онлайн обновления". Ознакомьтесь со списком изменений и запустите загрузку.

1. После завершения загрузки введите фразу "Да, у меня есть резервная копия". Нажмите Обновить.

Подтверждение наличия резервной копии

1. Не выполняйте Restart или Stop из панели облака: MikoPBX сама подготовит обновление и перезагрузится. Во время перезагрузки соединение с web-интерфейсом прервётся. Следить за процессом безопаснее через serial console или web console облачного провайдера.

Обновление скачанным IMG-файлом

Используйте локальный файл, если версия отсутствует в списке или облачная VM не имеет прямого доступа к серверу обновлений.

1. Скачайте .img нужной версии со страницы релизов MikoPBX.

Обратите внимание на архитектуру Вашей MikoPBX: в случае если у Вас ARM MikoPBX, то используйте файл обновления с "arm64" в названии. Если у Вас X86 MikoPBX, то используйте файл обновления с "x86_64" в названии.

1. Проверьте, что архитектура образа совпадает с архитектурой VM.

2. Откройте Обслуживание → Обновление PBX.

Раздел "Обслуживание" -> "Обновление PBX"

1. Выберите скачанный .img и нажмите Применить обновление.

Применение обновления

1. Введите фразу "Да, у меня есть резервная копия" и подтвердите операцию.

Подтверждение наличия резервной копии

1. Дождитесь автоматической перезагрузки и повторного запуска сервисов.

Можно ли обновить облачную VM через ISO

Обновление через ISO возможно только тогда, когда облачная платформа одновременно позволяет:

• загрузить или подключить пользовательский ISO;

• изменить порядок загрузки VM;

• открыть интерактивную консоль;

• после обновления отключить ISO и снова загрузиться с системного диска.

Если провайдер не поддерживает ISO, не пытайтесь имитировать этот способ заменой системного диска. Используйте web-обновление либо восстановление из snapshot.

Если все условия выполняются (например как в Vultr), порядок действий совпадает с обычной виртуальной машиной:

1. Скачайте и подключите ISO-образ нужной версии со страницы релизов MikoPBX.

Загрузка .iso c GitHub MikoPBX

1. Запустите машину и откройте её консоль. Дождитесь сообщения о загрузке в режиме восстановления — System booted in recovery mode (Live CD).

Загруженная MikoPBX в Recovery mode

1. Нажмите на любую клавишу, чтобы перейти к консольному меню. Далее откройте "[4] Install or recover".

Раздел "Install or recover" в консольном меню MikoPBX

1. Выберите "Update to version...". В русской локализации пункт называется "Обновить до версии...".

Не выбирайте пункт Install. Он запускает новую установку и предупреждает об удалении данных на выбранном диске. Для обновления с сохранением настроек нужен пункт Update to version...

Обновление версии на 2026.3.40

1. После завершения отключите ISO и загрузитесь с системного диска.