Обновление 3.20: различия между версиями

Версия от 10:06, 4 июля 2025

en | ru

Версия: 3.20

Требуется версия: 3.10 и выше

Несколько слов от автора

Версию 3.19 мы дорабатывали динамически. Добавляли в рабочем порядке как небольшие возможности так и крупные доработки. Цель - чтоб клиенты не ждали год новую версию и новые востребованные функции, а пользовались ими уже сейчас. Соответственно почти все изменения, что указаны как доработки версии 3.20 - они постепенно становились доступны для версии 3.19. Скажем версия 3.19.54 мало чем отличается от версии 3.20.0. Строго говоря нововведения версии 3.20.0 - это те моменты на которые мы хотели обратить внимание по сравнению с версией 3.19.0.

Таким образом обновление с 3.19 на 3.20 "бесшовное" и ничем особо не отличается от обновления скажем с 3.19.52 на 3.19.53. Дополнительных библиотек/модулей устанавливать не требуется

В версии 3.20 удалены разделы:
- "Схема размещения строительных длин и смонтированных муфт для трасс кабельных линий"
- "Неизвестные MAC-адреса"
- "Интерфейс технической поддержки"

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

Наша группа в Telegram для взаимного общения клиентов между собой: https://t.me/usersideeu и канал для новостей: https://t.me/userside

Особенности в проведении обновления

При обновлении в Docker-окружении, обратитесь к инструкциям в репозитории Docker-бандла.

Если вы обновляетесь с версии 3.10 - ознакомьтесь со страницей: Обновление 3.11

Если вы обновляетесь с версии 3.11 и ранее - ознакомьтесь со страницей: Обновление 3.12

Если вы обновляетесь с версии 3.12 и ранее - ознакомьтесь со страницей: Обновление 3.13

Если вы обновляетесь с версии 3.13 и ранее - ознакомьтесь со страницей: Обновление 3.14

Если вы обновляетесь с версии 3.14 и ранее - ознакомьтесь со страницей: Обновление 3.15

Если вы обновляетесь с версии 3.15 и ранее - ознакомьтесь со страницей: Обновление 3.16

Если вы обновляетесь с версии 3.16 и ранее - ознакомьтесь со страницей: Обновление 3.17

Если вы обновляетесь с версии 3.17 и ранее - ознакомьтесь со страницей: Обновление 3.18

Если вы обновляетесь с версии 3.18 и ранее - ознакомьтесь со страницей: Обновление 3.19

Перенесите/удалите посторонние файлы, каталоги и прочее из директории userside. Там должны находится только дистрибутивные файлы самой системы и файлы, которые система создает во время своей работы. Модули userside (usm) также не должны там хранится. Используйте отдельные каталоги для них (например, /opt/userside). Посторонние файлы из директории userside могут быть удалены в процессе обновления

С помощью автоматического инсталлятора выполните обновление:

sudo -u www-data php userside_install.phar install

Не забудьте обновить все модули на их свежие версии

Список изменений: просмотреть

Проведение обновления: инструкция

@@ Строка 39: / Строка 39: @@
 * Если вы обновляетесь с версии 3.17 и ранее - ознакомьтесь со страницей: [[Обновление 3.18]]
-* Перенесите/удалите посторонние файлы, каталоги и прочее из директории userside (/var/www/userside). Там должны находится только дистрибутивные файлы самой системы и файлы, которые система создает во время своей работы. Модули userside (usm) также не должны там хранится. Используйте отдельные каталоги для них (например, /opt/userside). Посторонние файлы из директории userside могут быть удалены в процессе обновления
+* Если вы обновляетесь с версии 3.18 и ранее - ознакомьтесь со страницей: [[Обновление 3.19]]
-* Сохраните файлы ''(при их наличии)''
+* Перенесите/удалите посторонние файлы, каталоги и прочее из директории userside. Там должны находится только дистрибутивные файлы самой системы и файлы, которые система создает во время своей работы. Модули userside (usm) также не должны там хранится. Используйте отдельные каталоги для них (например, /opt/userside). Посторонние файлы из директории userside могут быть удалены в процессе обновления
- userside3/main/config/custom_api.php
- userside3/main/skins/user_style.css
- userside3/main/js/user_script.js
-Они могут пригодится в случае ошибок обновления и их удаления при этом. Если вы использовали собственные значки для типов сооружений связи и самостоятельно их загружали в какой-то каталог, что доступен из веб - то также их сохраните.
-* Большинство файлов из веб-директории userside с целью безопасности изменили своё местоположение на несколько уровней выше и теперь недоступны через веб.
-* Версия 3.19 требует PHP версии 8.3. Вы можете установить все необходимые пакеты дополнительно к уже существующей иной версии PHP. Если используете LDAP, то установите также php8.3-ldap. Если используете TurboSMS, то установите php8.3-soap.
- sudo apt install -y php8.3-{fpm,cli,common,curl,intl,mbstring,opcache,pgsql,readline,xml,zip,snmp,gd}
-* Если версия php8.3 отсутствует в вашем репозитории, то воспользуйтесь альтернативным репозиторием, например, deb.sury.org, добавив его в систему следующим образом и затем повторив команду установки PHP8.3 приведенную пунктом выше:
- sudo curl -sSLo /usr/share/keyrings/deb.sury.org-php.gpg https://packages.sury.org/php/apt.gpg
- sudo sh -c 'echo "deb [signed-by=/usr/share/keyrings/deb.sury.org-php.gpg] https://packages.sury.org/php/ $(lsb_release -sc) main" > /etc/apt/sources.list.d/php.list'
- sudo apt update
-* Измените конфигурацию PHP следующим образом и перезапустите службу php-fpm.
-<pre>
-sudo sed -i "s@^;date.timezone.*@date.timezone = $(cat /etc/timezone)@" /etc/php/8.3/fpm/php.ini
-sudo sed -i "s@^;date.timezone.*@date.timezone = $(cat /etc/timezone)@" /etc/php/8.3/cli/php.ini
-sudo sed -i "s@;cgi.fix_pathinfo=1@cgi.fix_pathinfo=0@" /etc/php/8.3/fpm/php.ini
-sudo sed -i "s@post_max_size = 8M@post_max_size = 100M@" /etc/php/8.3/fpm/php.ini
-sudo sed -i "s@upload_max_filesize = 2M@upload_max_filesize = 100M@" /etc/php/8.3/fpm/php.ini
-sudo sed -i "s@max_execution_time.*@max_execution_time = 300@" /etc/php/8.3/fpm/php.ini
-sudo sed -i "s@max_input_time.*@max_input_time = 300@" /etc/php/8.3/fpm/php.ini
-sudo systemctl restart php8.3-fpm
-</pre>
-* создайте новый каталог public внутри каталога userside (если у вас установлено в другом месте, отредактируйте команду перед выполнением):
-<pre>
-sudo mkdir -p /var/www/userside/public
-</pre>
-* В настройке NGINX-сервера (/etc/nginx/conf.d/userside.conf) измените пути к корневому каталогу. Строку:
-<pre>
-root   /var/www/userside/userside3;
-</pre>
-Замените на:
-<pre>
-root   /var/www/userside/public;
-</pre>
-* Там же измените <code>location /</code> целиком на следующий:
-<pre>
-location / {
-    try_files $uri $uri/ /index.php$is_args$args;
-}
-</pre>
-* Там же для <code>location ~ \.php$</code> измените значение для fastcgi_pass с:
- fastcgi_pass  unix:/run/php/php8.1-fpm.sock;
-на
- fastcgi_pass  unix:/run/php/php8.3-fpm.sock;
-и перечитайте конфигурацию nginx:
- sudo nginx -s reload
-* Для websocket-пользователя (websock-user) брокера RabbitMQ необходимо изменить разрешения следующим образом:
-<pre>
-sudo rabbitmqctl set_permissions -p "/" "websock-user" "^erp-stomp:id-.*" "" "^erp-stomp:id-.*"
-</pre>
-Если имя вашего websocket-пользователя отличается от websock-user, то укажите его вместо websock-user в приведенных выше командах.
-* Обратите внимание, что при вызове команды <code>php</code> из командной строки, теперь будет вызываться php8.3, так как это последняя установленная версия. Если вы где-либо до сих пор используете php8.1, то вам нужно изменить вызов php в этих местах либо изменить альтернативную команду php, чтобы она запускала нужную вам версию.
-* USERSIDE 3.19 ''требует Python3 любой поддерживаемой на данный момент версии. Статус версий можно посмотреть здесь: "[https://devguide.python.org/versions/ Status of Python versions]". Рекомендуется использовать версию с состоянием "security" или "bugfix". Версии отмеченные как "end-of-life" не поддерживаются. Отмеченные как "feature" не рекомендуется использовать. Если у вас на хосте неподдерживаемая версия ("end-of-life"), то нужно обязательно [[Python-update|установить дополнительно]] более свежую версию Python.''
 * С помощью автоматического [[Инсталлятор|инсталлятора]] выполните [[Обновление|обновление]]:
   sudo -u www-data php userside_install.phar install
-* Следующее действие нужно выполнять только если вы [[Python-update|обновили Python]]. Если не обновляли, можно не выполнять:
-<pre>
-cd /var/www/userside/microservice/poller
-sudo rm -rf venv
-sudo python3.11 -m venv venv
-</pre>
-* Необходимо обновить (установить) зависимости для поллера:
-<pre>
-cd /var/www/userside/microservice/poller
-sudo venv/bin/pip install --upgrade pip
-sudo venv/bin/pip install -U -r requirements.txt
-</pre>
-* И перезапустить службы
-<pre>
-sudo supervisorctl restart all
-</pre>
-* Переработан низкоуровневый опрос оборудования ''(PON, TDR)''.
-* Система двух SNMP-community заменена на один SNMP-community. Этим одним SNMP-community будет то, которое было указано в поле rw-community. Если поле rw-community было пустое - то будет использовано значение поля ro-community
 * Не забудьте обновить все модули на их свежие версии
-* Если вы используете модуль [[usm_pon]] - перенастройте в системном cron его запуск на нужную частоту в зависимости от количества у вас OLT. Теперь модуль опрашивает только одно устройство за запуск ''(ранее опрашивались все устройства одновременно без возможности смягчения нагрузки и пропуска ненужных устройств)''. Устройства будут опрашиваться по очереди. При каждом запуске на опрос будет подаваться следующее устройство у которого включен такой опрос.
+'''Список изменений:''' [[3.20|просмотреть]]
-* Для разных типов задач теперь можно настраивать отдельные шаблоны по уведомлениям. Проверьте в ваших существующих шаблонах корректность миграций.
-'''Список изменений:''' [[3.19|просмотреть]]
 '''Проведение обновления:''' [[Обновление|инструкция]]