Обновление физического сервера

Обновление MikoPBX, установленной на отдельный физический компьютер

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

Эта инструкция подходит для отдельного компьютера или сервера, на котором установлена MikoPBX.

Основной способ - обновление через web-интерфейс. Если станция не загружается штатно или web-интерфейс недоступен, используйте ISO-образ, записанный на отдельный USB-носитель.

Перед обновлением обязательно создайте резервную копию настроек и сохраните её на другом устройстве. Так же сохраните копию записей разговоров.

Подготовка

1. Убедитесь, что у вас есть физический доступ к серверу либо рабочая консоль. Создайте резервную копию настроек MikoPBX и записей разговоров.

2. Убедитесь, что в Storage свободно не менее 400 МБ.

3. Завершите активные вызовы и запланируйте перерыв в работе телефонии.

Обновление заменой Bootable USB

Для физического сервера с отдельным диском Storage рекомендуемый режим работы — постоянная загрузка MikoPBX с Bootable USB. Система размещается на USB-носителе, а записи разговоров, история вызовов, модули и другие рабочие данные хранятся на HDD или SSD, подключённом как Storage.

При такой установке обновление можно выполнить заменой загрузочного USB-носителя:

1. Создайте резервную копию настроек MikoPBX и сохраните её на другом устройстве. Дополнительно создайте резервную копию диска Storage.

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

3. Скачайте RAW-образ требуемой версии с официальной страницы загрузки MikoPBX и запишите его на другой USB-носитель по инструкции Bootable USB. Архитектура образа должна совпадать с архитектурой сервера.

4. Корректно выключите сервер. Отключите старый Bootable USB, подключите новый, а диск Storage оставьте подключённым. Проверьте порядок загрузки в BIOS/UEFI.

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

6. После повторной загрузки проверьте версию MikoPBX, сетевые настройки, внутренние номера, провайдеров, маршруты, историю вызовов, записи разговоров и модули.

7. Сохраните старый USB-носитель и резервную копию Storage до завершения проверки и создания новой резервной копии обновлённой станции.

Новый USB-носитель содержит новую систему. Из Storage автоматически восстанавливается база настроек, а остальные данные продолжают использоваться непосредственно с диска Storage. После успешного восстановления первая загрузка завершается дополнительной автоматической перезагрузкой.

Не перезаписывайте старый Bootable USB: он является одной из точек отката. Однако одного старого USB недостаточно для гарантированного возврата на прежнюю версию, поскольку новая MikoPBX могла изменить данные на Storage. Для надёжного отката необходима резервная копия Storage, созданная до обновления.

Обновление через web-интерфейс

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

1. В web-интерфейсе откройте "Обслуживание" → "Обновление PBX".

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

1. Выберите желаемую версию в списке. Ознакомьтесь со списком изменений и запустите процесс обновления.

Кнопка для обновления станции из веб интерфейса

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

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

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

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

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

Загрузка .img для обновления

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

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

1. Выберите скачанный файл .img.

Выбор файла обновления

1. Нажмите Применить обновление.

Кнопка для применения обновления

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

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

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

Станция на новой версии

Обновление с ISO на USB-носителе

Этот способ подходит для восстановления и обновления станции с локальной консоли.

Создание загрузочного носителя

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

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

1. Подключите отдельную USB-флешку объёмом не менее 1 ГБ.

2. Запишите ISO в режиме образа диска с помощью Rufus, balenaEtcher или dd. Инструкцию по записи ISO образа Вы можете найти здесь.

При записи ISO все данные на выбранной USB-флешке будут удалены. Внимательно проверьте выбранное устройство.

Запуск обновления

1. Подключите подготовленную флешку к серверу. В BIOS/UEFI или Boot Menu выберите загрузку с USB.

2. Дождитесь запуска MikoPBX в Recovery mode.

MikoPBX в Recovery Mode

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

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

1. Выберите "2) Update to version...".

Пункт Install предназначен для новой установки и удаляет данные на выбранном устройстве. Для обновления с сохранением настроек выбирайте только "Update to version..."

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

1. Дождитесь окончания записи и перезагрузки. Извлеките USB-флешку либо верните системный диск на первое место в порядке загрузки.

Успешное обновление станции на версию 2026.3.40