3 основные причины, а также другие распространенные проблемы, из-за которых переход на новую версию 3CX может не работать.

После выпуска Beta 1 of V20 и Update 9 мы уже провели множество обновлений – достаточно, чтобы получить статистику. По результатам тестирования мы выделили основные причины, по которым обновление v20 завершается неудачей.

Причина №1 – Недостаточно процессорных ядер – требуется 2 и более

Основная причина неудачи при обновлении – это отсутствие у компьютера 2 или более ядер. Для корректной работы 3CX требуется как минимум 2 ядра. 3CX – это приложение реального времени, которое обрабатывает аудио (а в некоторых случаях и видео) и не может ожидать доступа к процессору даже несколько секунд. Это сразу вызовет проблемы со звуком, создаст плохой пользовательский опыт и в конечном итоге повлияет на наш бренд. Если на компьютере недостаточно ядер, обновление не будет успешным – оно просто не запустится. Сначала используйте компьютер с 2 ядрами.

№2 – Список исходников изменен

Вторая причина, по которой обновление не будет работать – установке в ISO-образ 3CX неподдерживаемых пакетов. В этом случае мы не можем гарантировать результат обновления, поэтому просто не будем его запускать. Единственный способ обновить систему в этом случае – сделать резервную копию и восстановить ее на чистый образ. Вот несколько примеров сторонних исходников, которые мы обнаружили: osconfig_managed_7a718e6aad.list, busylight.list, mysql.list, hetzner-mirror.list.

№3 – Не хватает ОЗУ – требуется 2 Гб

Помимо обработки аудио и видео в реальном времени, 3CX также имеет веб-сервер с полнофункциональным веб-клиентом. Это занимает немного памяти. Всего 1 Гб в наши дни – это слишком мало. Для работы критически важной системы связи 2 Гб – это действительно минимум. Поэтому необходимо обновить систему, если памяти недостаточно.

Протестированные среды

  • Установка ISO-образа 3CX без каких-либо изменений на голое железо или в поддерживаемых виртуальных средах.
  • Ведущие поставщики облачных платформ:
    • Google Cloud (Compute Engine)
    • Amazon AWS (+LightSail)
    • DigitalOcean
    • Microsoft Azure (не рекомендуется)
    • Vultr

Процесс

Что происходит при обновлении? Ваша система будет обновляться с Debian 10 до Debian 11, а затем до 12. В зависимости от характеристик машины, размера инсталляции 3CX, интернет-соединения, а также от установленных ранее обновлений, процесс может занять от 10-15 минут до часа и больше. После успешного обновления система перезагрузится. Администратору будет отправлен E-mail с результатом обновления. В письме будет указан статус: прервано, не удалось или успешно.

Важно

  • Не пытайтесь взаимодействовать с системой/экземпляром во время процесса обновления.
  • Сделайте полную резервную копию 3CX и храните ее вне вашего экземпляра.
  • Если возможно, сделайте полный снимок виртуальной машины.
  • Во время обновления 3CX будет недоступен, поэтому запланируйте обновление вне рабочего времени.

Другие распространенные проблемы

  • Вручную добавленные/удаленные репозитории.
  • Вручную установленные пакеты, вызывающие проблемы с зависимостями.
  • Инструменты удаленного администрирования или мониторинга, которые могут повлиять на процесс обновления (например, блокировка APT, попытка перезапуска служб).
  • Измененные настройки локали или TZdata.
  • Измененные/поврежденные файлы конфигурации/пакеты.
  • Поддельные корневые сертификаты.
  • Ограниченный доступ в интернет.
  • Взаимодействие пользователей с системой во время обновления.

Если обновление v20 не удалось

Если обновление не удалось, проверьте системные требования, устраните несоответствия и снова запустите обновление. Если не удалось повторно, придется создать полную резервную копию и восстановить 3CX на чистую систему.

Системные требования

  • Не менее 2 vCPU, 2 ГБ ОЗУ, 5 ГБ свободного места на диске
  • Без сторонних исходников в /etc/apt/sources.list.d/ (кроме 3CX и агентов поставщика)
  • Не установлено стороннее программное обеспечение
  • Непрерывное подключение к repo.3cx.com и deb.debian.org

Внимание! Мы собираем журналы исключительно для отладки. Они удаляются вскоре после завершения обновления. Журналы неудачных обновлений просматриваются нашими инженерами для определения потенциальных проблем и улучшения процесса обновления.

Резюме

Для работы выделенного экземпляра требуется правильно подобранный сервер. Для очень небольших инсталляций (менее 5-10 пользователей) рассмотрите использование сервисов 3CX SMB или 3CX FREE. Если клиенту действительно нужна выделенная система, он должен понимать, что ее характеристики должны соответствовать актуальным минимальным требованиям.

Следите за новостями

Поделитесь вашим мнением на форуме. Нажмите «Подписаться» на наших страницах X и LinkedIn, чтобы оставаться в курсе последних новинок.