Автоматическое обновление — Linux

Процесс обновления платформы Navixy обычно состоит из трех частей: обновление базы данных, обновление файлов Java-сервисов и обновление файлов веб-сервисов. Важно внимательно следовать инструкции по обновлению и убедиться, что каждая часть обновления успешно завершена и по ходу не возникло ошибок.

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

Проверка предварительных требований

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

1. Java Development Kit 21 Начиная с марта 2025 года платформа устарела версия 17 и старее.

2. MySQL 8.0 Начиная с марта 2024 года платформа устарела MySQL 5.7. Эта версия достигла EOL и больше не поддерживается.

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

Начало обновления

Распакуйте пакет дистрибутива платформы, полученный от Navixy, обычно это .tar.gz файл.

tar -zxvf $PACKAGENAME

(где $PACKAGENAME — это имя tar.gz файла)

Он будет распакован в /navixy-package директорию, содержащую все файлы платформы. В дальнейшем это будет основная директория дистрибутива.

Автоматизированное обновление

Для инстансов, размещенных на серверах Linux, доступно решение для автоматизированного обновления. Настоятельно рекомендуется использовать update.sh скрипт. Он выполняет пошаговое обновление базы данных и файлов приложения, и вам не нужно выполнять внутренние операции вручную.

Запустите update.sh скрипт из директории /navixy-package . Если ваша платформа размещена на двух серверах, запустите скрипт на сервере приложений (где работают Java-сервисы).

root@server:/home/navixy-package# ./update.sh

Скрипт начнёт с обновления базы данных. Если база данных находится на отдельном сервере, скрипт получит данные подключения из конфигурации Java-сервисов.

После обновления базы данных (что может занять некоторое время) скрипт обновит системные файлы платформы.

Если ваш инстанс не обновлялся длительное время, во время обновления вы можете увидеть следующее сообщение: It seems Navixy services is not under systemd control. Do you want to create systemd services (runit services will be removed)? (y/n) Рекомендуется ответить утвердительно. Дело в том, что мы устарили runit метод запуска сервисов, и теперь используем systemd для этой цели. Скрипт выполнит все необходимые действия за вас. Однако если по какой-то причине вы ответите «нет», это не приведёт к сбою системы, и runit продолжит работу. Вы можете переключиться на systemd при следующем обновлении.

Обновление базы данных (опционально)

Вы можете выполнить обновление базы данных отдельно от остальной части платформы при необходимости. Для этого запустите update-db.sh скрипт из директории /navixy-package из директории. Это можно сделать как на сервере базы данных (localhost), так и с другого сервера, указав адрес хоста. После запуска скрипта вы увидите следующий диалог:

Enter mysql host [localhost]:
Enter mysql port [3306]:
Enter mysql user name [root]:
Updating Navixy db..
Enter password:

Параметры по умолчанию показаны в квадратных скобках. Если они совпадают с актуальными (обновление выполняется на сервере базы данных), вводить что-либо не нужно — просто нажмите Enter. Если вы хотите указать другой хост, кастомный порт или другого пользователя, заполните соответствующие параметры.

Если после обновления что-то работает некорректно, попробуйте перезапустить сервисы платформы с помощью restart-navixy скрипта. Дополнительно очистите данные браузера или проверьте работу в режиме инкогнито.

---

Ручное обновление

Автоматизированное обновление платформы, развернутой на Linux, является проверенным рабочим решением, и его настоятельно рекомендуется использовать. Поэтому следующая информация предоставляется только для сведения и для случаев специальных нестандартных установок.

Обновление базы данных

Откройте navixy-package/db директорию и выполните updates.sql файл с помощью следующей команды:

mysql -uroot -p$ROOTPASSWORD google < updates.sql

(где $ROOTPASSWORD — пароль root для MySQL)

Удалите updates.sql и google.sql из папки db.

Это необходимо сделать чтобы не перезаписать базу данных на следующем шаге.

rm updates.sql
rm google.sql

Убедитесь, что эти файлы удалены, и затем выполните все остальные sql-файлы.

cat *.sql | mysql -uroot -p$ROOTPASSWORD google

Обновление Java-сервисов

Обновление Java-сервисов просто означает замену файлов в директориях сервисов под /home/java. Эти директории:

• api-server

• sms-server

• tcp-server

Найдите соответствующие директории в navixy-package. Вам необходимо заменить все файлы, кроме config.properties и db.properties в conf папках. Сравните существующие config.properties файлы с теми, что в новом дистрибутиве. Если вы увидите какие-либо новые параметры — добавьте их в существующую конфигурацию.

Обновление веб-сервисов

Перейдите в /var/www директорию. Замените все файлы в panel-v2 и pro-ui директориях файлами из соответствующих директорий пакета дистрибутива. Это не испортит настройки, поскольку файлы конфигурации в пакете называются как example, и не перезапишут существующие.

Сравните эти файлы:

• panel-v2/Config.js,

• pro-ui/PConfig.js

• pro-ui/static/app_config.js

с примерами в пакете дистрибутива.

Если вы увидите какие-либо новые параметры, добавьте их.

Заключительные шаги

Перезапустите Java-сервисы Navixy. Как правило, это делается командой:

restart-navixy

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