Раздел «Обслуживание» в MikoPBX — это интерфейс для управления техническими аспектами системы и обеспечения ее стабильной работы. Здесь администраторы могут выполнять задачи по резервному копированию и восстановлению данных, обновлению программного обеспечения, мониторингу состояния системы и управлению журналами событий. Этот раздел помогает поддерживать работоспособность телефонной системы, своевременно обнаруживать и устранять возможные проблемы.

Обновление системы

Раздел «Обновление» в MikoPBX — это интерфейс для управления обновлениями программного обеспечения системы. Здесь администраторы могут проверять наличие новых версий, устанавливать обновления и просматривать историю изменений. Регулярное использование этого раздела обеспечивает актуальность, безопасность и стабильность работы MikoPBX.

Диагностика системы

Раздел «Диагностика системы» в MikoPBX — это инструмент для мониторинга и анализа состояния телефонной системы. Здесь администраторы могут просматривать журналы событий, проверять с помощью них статус различных сервисов и компонентов системы, а также выполнять тестирование соединений и вызовов. Использование этого раздела помогает своевременно обнаруживать и устранять технические проблемы, обеспечивая стабильную и эффективную работу MikoPBX.

Перезагрузка и выключение системы

Раздел «Перезагрузка и выключение системы» в MikoPBX — это интерфейс для безопасного управления состоянием телефонной системы через веб-интерфейс. Здесь администраторы могут перезагрузить систему для применения новых настроек или корректно выключить ее для технического обслуживания. Использование этого раздела предотвращает возможные ошибки и обеспечивает стабильную работу MikoPBX. Помимо этого, будет рассмотрена возможность перезагрузки через консоль.

Ниже приведен пример с АТС, установленной на виртуальную машину VirtualBOX. Обновление производится с версии 2022.2.102 до версии 2022.3.15. Скачайте из репозитория iso-образ нужной вам версии АТС.

В программе VirtualBOX откройте настройки виртуальной машины на которой установлена АТС. Перейдите в раздел Носители. Выделите виртуальный оптический привод. Нажмите на значок в группе Атрибуты, нажмите Выбрать файл диска. Выберите скачанный iso-образ АТС. Запустите машину.

В консоли отобразится соответствующая строка "The system loaded in Recovery mode" («АТС загружена в режиме восстановления» на русском).

Выберите Install / Repair (или нажмите на клавиатуре цифру 8) и нажмите «Enter».

Вам нужна команда "Update to version ****.*.**". Нажмите на клавиатуре цифру 2, затем нажмите «Enter». Начнется установка обновления. Когда она завершится, АТС перезагрузится.

После перезагрузки АТС сообщения "The system loaded in Recovery mode" уже не будет, что означает, что АТС загрузилась с жесткого диска, а не с виртуального оптического привода. Вверху зеленым шрифтом будет обозначена установленная версия обновления.

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

Обновление Docker контейнера

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

# Остановка текущего контейнера
sudo docker stop mikopbx

# Удаление текущего контейнера
sudo docker rm mikopbx

Для запуска нового контейнера с использованием последней версии образа и теми же настройками, что и ранее (включая монтирование томов и прочие параметры сети), воспользуйтесь следующими командами:

# Скачивание последней версии образа контейнера
sudo docker pull ghcr.io/mikopbx/mikopbx-x86-64:latest

# Запуск контейнера в не привилегированном режиме
sudo docker run --cap-add=NET_ADMIN --net=host --name mikopbx --hostname mikopbx \
           -v data_volume:/cf \
           -v data_volume:/storage \
           -e SSH_PORT=23 \
           -it -d --restart always ghcr.io/mikopbx/mikopbx-x86-64:latest

Обновление с помощью docker compose

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

# Остановка текущего контейнера
sudo docker stop mikopbx

# Удаление текущего контейнера
sudo docker rm mikopbx

Следующий шаг — это скачивание последней версии образа MikoPBX:

# Скачивание последней версии образа контейнера
sudo docker pull ghcr.io/mikopbx/mikopbx-x86-64:latest

Пример файла docker-compose.yml, который может быть использован для обновления вашего контейнера MikoPBX через Docker Compose:

services:
  mikopbx:
    container_name: "mikopbx"
    image: "ghcr.io/mikopbx/mikopbx-x86-64:latest"
    network_mode: "host"
    cap_add:
      - NET_ADMIN
    entrypoint: "/sbin/docker-entrypoint"
    hostname:  "mikopbx-in-a-docker"
    volumes:
      - data_volume:/cf
      - data_volume:/storage
    tty: true
    environment:
      # Изменение имени станции через переменные окружения
      - PBX_NAME=MikoPBX-in-Docker
      # Изменение стандартного порта SSH на 23
      - SSH_PORT=23
      # Изменение стандартного порта WEB на 8080
      - WEB_PORT=8080
      # Изменение стандартного порта WEB HTTPS на 8443
      - WEB_HTTPS_PORT=8443
      
volumes:
  data_volume:

Сохраните содержимое в файл docker-compose.yml, выполните необходимые корректировки и запускайте командой:

sudo docker compose -f docker-compose.yml up

Примечания

• Данные: Поскольку данные сохраняются в Docker Volume, они остаются нетронутыми при обновлении, что позволяет сохранить настройки и пользовательские данные.

• Переменные окружения: Убедитесь, что все необходимые переменные окружения передаются корректно.

• Безопасность: Перед обновлением всегда рекомендуется создать резервные копии ваших данных.

Эти шаги помогут обеспечить гладкое и безопасное обновление вашего контейнера MikoPBX.

Перезагрузка станции через интерфейс MikoPBX

Меню выключения/перезагрузки системы вы можете найти в MikoPBX в "Перезагрузка" -> "Обслуживание".

При открытии страницы будет отображен список активных звонков на АТС. Отображается дата начала звонка, «Кто» и «Кому» звонит.

• «Перезагрузить АТС» - команда начинает перезагрузку станции.

• «Выключение АТС» - завершает все процессы и отключает станцию.

Перезагрузка станции через консольное меню

Вы можете перезагрузить станцию через консольное меню. Для этого выберете раздел «[3] Перезагрузить систему».

Если вы хотите перезагрузить станцию: нажмите «[1] Перезагрузить MikoPBX».

Если вы хотите выключить станцию: нажмите «[2] Выключить».

Перезагрузка с проверкой диска

В случае аварийной перезагрузки АТС (например, выключение электроэнергии) может потребоваться выполнить проверку диска на ошибки.

В консольном меню АТС введите команду «[9] Консоль(Shell)» и нажмите Enter

Система запустит консоль АТС.

Введите команду Reboot. Нажмите Enter

Система перезагрузится с проверкой диска.

В некоторых разделах интерфейса (например, Сотрудники) в правом нижнем углу указана текущая версия MikoPBX.

В web-интерфейсе АТС перейдите в Обслуживание → Обновление PBX.

Если есть версии АТС новее вашей текущей, они будут отображены в таблице Доступны онлайн обновления, в которой в первом поле номер версии, а во втором - список изменений.

Далее возможны два варианта обновления: обновление онлайн, обновление скачанным img-файлом.

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

Обновления загружаются на АТС и сразу же применяются. Для обновления таким способом нажмите кнопку в нужной вам версии обновления.

Появится окно предупреждения. Нажмите в нем Обновить.

АТС загрузит и применит обновления, а затем перезагрузится.

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

Для обновления данным способом нажмите кнопку в нужной вам версии обновления.

Начнется скачивание img-образа. Дождитесь завершения загрузки.

Затем нажмите кнопку и выберите данный img-файл.

Затем нажмите Применить обновление, а в появившемся окне предупреждения нажмите Обновить.

Начнется применение обновлений. После окончания которого АТС перезагрузится.

Раздел «Диагностика системы» в MikoPBX — это инструмент для мониторинга и анализа состояния телефонной системы. Использование этого раздела помогает своевременно обнаруживать и устранять технические проблемы, обеспечивая стабильную и эффективную работу MikoPBX.

Расположение раздела: "Обслуживание" -> "Системные логи"

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

Просмотр логов

Раздел позволяет просмотреть файлы логов для детального анализа работы АТС

1. Для начала работы - выберите файл.

2. Установите лимит строк для выборки.

3. Установите офсет - значение сдвига в выборке.

4. Установите фильтр по вхождению строки в выборку.

Доступны следующие возможности:

1. Cкачать полученную выборку в виде файла

2. Обновить выборку

3. Автоматическое обновление выборки

Пример. Анализ звонка

Допустим необходимо проанализировать прохождение исходящего звонка на номер 74952293042

1. Выберите файл для анализа asterisk/verbose.

2. В качестве фильтра установите номер телефона 74952293042.

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

4. В последней строке выборке следует найти идентификатор:

[2023-03-18 16:28:17] VERBOSE[21654][C-0000000f] app_stack.c: Spawn extension (SIP-1676196499-22-outgoing, 74952293042, 13) exited non-zero on 'PJSIP/302-0000001a'

В данном примере ID = C-0000000f.

1. Повторяем запрос лога, но уже с фильтром C-0000000f.

2. Будет получен весь лог прохождения dialplan.

3. Полученные данные можно отправить специалисту технической поддержки.

Информация о системе

Данная вкладка отображает следующую информацию:

• Сетевые настройки

• Нагрузка на CPU

• Потребляемая оперативная память

• Настройки iptables

Захват сетевых пакетов

Данный раздел позволяет произвести детальный анализ ошибок в работе АТС.

Сбор сетевых пакетов

Вы можете запустить сбор сетевых пакетов, проходящих через сетевой интерфейс.

1. Для запуска процесса нажмите кнопку "Старт".

1. Воспроизведите вашу проблему: совершите звонок или иное действие, приводящее к сбою / ошибке.

2. Нажмите кнопку "Остановить и скачать".

Сетевые пакеты будут автоматически сохранены в архив MikoPBXLogs_log-tcpdump-XXXXXXXXXX. Также они должны автоматически сохраниться в папку Загрузки вашего браузера.

Если в папке Загрузки архив найти не удалось , можете подключиться к АТС через WinSCP и скачать его из директории /storage/usbdisk1/mikopbx/tmp - файл log-tcpdump-XXXXXXXXXX.zip

Скачать все системные логи

Вы можете скачать все накопленные на АТС системные логи. Для этого нажмите кнопку "Скачать все системные логи".

Системные логи будут автоматически сохранены в архив MikoPBXLogs_log-sys-XXXXXXXXXX.zip. Логи автоматически должны сохраниться в папку Загрузки вашего браузера. Так же данный архив с логами можно получить из каталога /storage/usbdisk1/mikopbx/tmp, подключившись к АТС при помощи WinSCP. Файл - log-sys-XXXXXXXXXX.zip

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

• С помощью SSH-клиента

• С помощью утилиты Wireshark

• С помощью приложения tcpdump