Обновление 3.20 - История изменений

Uscld2 в 11:33, 8 июля 2025

2025-07-08T11:33:10Z

← Предыдущая версия		Версия от 11:33, 8 июля 2025
Строка 3:		Строка 3:
	Версия: '''[[3.20]]'''		Версия: '''[[3.20]]'''

	Требуется версия: '''[[3.10]] и выше'''		Требуется версия: '''[[3.12]] и выше'''

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

Admin: /* Несколько слов от автора */

2025-07-08T10:48:51Z

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

← Предыдущая версия		Версия от 10:48, 8 июля 2025
Строка 10:		Строка 10:
	* Таким образом обновление с 3.19 на 3.20 "бесшовное" и ничем особо не отличается от обновления скажем с 3.19.52 на 3.19.53. Дополнительных библиотек/модулей устанавливать не требуется		* Таким образом обновление с 3.19 на 3.20 "бесшовное" и ничем особо не отличается от обновления скажем с 3.19.52 на 3.19.53. Дополнительных библиотек/модулей устанавливать не требуется

	* ~~В версии 3.20~~ [[Лимиты объектов\|~~убран~~ лимит]] на количество адресных объектов ''(здания, улицы, населенные пункты)''		* [[Лимиты объектов\|Убран лимит]] на количество адресных объектов ''(здания, улицы, населенные пункты)''

	* В версии 3.20 удалены разделы:		* В версии 3.20 удалены разделы:

Admin: /* Несколько слов от автора */

2025-07-08T10:48:35Z

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

← Предыдущая версия		Версия от 10:48, 8 июля 2025
Строка 9:		Строка 9:

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

			* В версии 3.20 [[Лимиты объектов\|убран лимит]] на количество адресных объектов ''(здания, улицы, населенные пункты)''

	* В версии 3.20 удалены разделы:		* В версии 3.20 удалены разделы:

Admin в 10:06, 4 июля 2025

2025-07-04T10:06:12Z

Внесённые изменения

Admin: /* Несколько слов от автора */

2025-07-04T10:04:03Z

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

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

	* ~~У нас появилась~~ "~~[[Двухфакторная аутентификация (2FA)]]~~". ~~Не пренебрегайте безопасностью и используйте её~~.		* Таким образом обновление с 3.19 на 3.20 "бесшовное" и ничем особо не отличается от обновления скажем с 3.19.52 на 3.19.53. Дополнительных библиотек/модулей устанавливать не требуется

	* Большинство файлов из веб-директории userside с целью безопасности изменили своё местоположение на несколько уровней выше и теперь недоступны через веб. Также изменилось имя каталога, который должен быть корневым для web, на стандартное имя public.		* В версии 3.20 удалены разделы:
			** "Схема размещения строительных длин и смонтированных муфт для трасс кабельных линий"
	* Изменена маршрутизация страниц/ссылок системы		** "[[Неизвестные MAC-адреса]]"
	~~<pre>~~		** "Интерфейс технической поддержки"
	~~Было: /?core_section=customer&action=show&id=1234~~
	~~Стало: /customer/1234~~
	~~</pre>~~

	* В версии 3.~~19 объявляются устаревшими~~ разделы:
	** "Схема размещения строительных длин и смонтированных муфт для трасс кабельных линий"~~. В версии 3.20 раздел будет удалён~~
	** "[[Неизвестные MAC-адреса]]"~~. В версии 3.20 раздел будет удалён~~
	** "Интерфейс технической поддержки"~~. В версии 3.20 раздел будет удалён~~

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

Admin: Новая страница: «en | ru Версия: '''3.20''' Требуется версия: '''3.10 и выше''' == Несколько слов от автора == * Версию 3.19 мы дорабатывали динамически. Добавляли в рабочем порядке как небольшие возможности так и крупные доработки. Цель - чтоб клиенты не ж...»

2025-07-04T07:00:16Z

Новая страница: «en | ru Версия: '''3.20''' Требуется версия: '''3.10 и выше''' == Несколько слов от автора == * Версию 3.19 мы дорабатывали динамически. Добавляли в рабочем порядке как небольшие возможности так и крупные доработки. Цель - чтоб клиенты не ж...»

Новая страница

[[Upgrade_3.20|en]] | [[Обновление_3.20|ru]]

Версия: '''[[3.20]]'''

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

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

* У нас появилась "[[Двухфакторная аутентификация (2FA)]]". Не пренебрегайте безопасностью и используйте её.

* Большинство файлов из веб-директории userside с целью безопасности изменили своё местоположение на несколько уровней выше и теперь недоступны через веб. Также изменилось имя каталога, который должен быть корневым для web, на стандартное имя public.

* Изменена маршрутизация страниц/ссылок системы
<pre>
Было: /?core_section=customer&action=show&id=1234
Стало: /customer/1234
</pre>

* В версии 3.19 объявляются устаревшими разделы:
** "Схема размещения строительных длин и смонтированных муфт для трасс кабельных линий". В версии 3.20 раздел будет удалён
** "[[Неизвестные MAC-адреса]]". В версии 3.20 раздел будет удалён
** "Интерфейс технической поддержки". В версии 3.20 раздел будет удалён

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

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

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

При обновлении в Docker-окружении, обратитесь к [https://github.com/userside/userside-docker/tree/v3.18 инструкциям] в репозитории 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]]

* Перенесите/удалите посторонние файлы, каталоги и прочее из директории userside (/var/www/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.19|просмотреть]]

'''Проведение обновления:''' [[Обновление|инструкция]]