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

Текущая версия от 14:40, 29 мая 2026

en | uk | ru

Версия: 3.21

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

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

Сделан архитектурный переход от числовых идентификаторов объектов (ID) к строковым идентификаторам (UUID). Для многих типов объектов - старый ID остался для удобства (например "Задание №7562" удобнее чем "Задание №ae4ae420-7643-4572-a752-9ecfdbeca371"). Но внутри базы и ядра - привязка идёт по UUID. Кроме прочего это даёт возможность чуть позже сделать следующий шаг - возможность объединения нескольких систем в одну при необходимости. Очень важно - так как такая миграция ID/UUID затрагивает практически всю базу (и часто неоднократно) то после завершения обновления необходимо сделать FULL VACUUM. Без этого шага всё будет работать очень медленно. Также стоит учесть, что на большой базе обновление/миграция может занимать часы.

Проведён глубокий рефакторинг и обновление UI/UX. Исключена т.н. "мобильная версия" как таковая и сделан упор на комфортный внешний вид в мобильных устройствах.

В схеме коммутации переработана механика - ускорение в 2-10 раз по отображению плюс коммутация в схеме теперь не перезагружает страницу. Также напоминаю, что у нас есть "Горячие клавиши" которые ещё больше ускоряют работу.

У нас появилась/переработана/документирована событийная система Internal API v2. Версия v1 пока поддерживается (custom_api.php) но постепенно переходите на v2.

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

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

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

Если вы обновляетесь с версии 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

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

Если вы используете кастомизацию - перенесите файлы по новому пути

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

Версия 3.21 требует PHP версии 8.4. Остальные требования остаются такими же как для версии 3.20

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

curl -fsSL https://my.userside.eu/install.sh | sudo -u www-data bash
sudo -u www-data ./installer install

Обязательно выполните VACUUM FULL + ANALYZE после обновления:

sudo -u postgres vacuumdb --full --analyze userside

или тоже самое при помощи SQL-запроса:

sudo -u postgres psql -d userside -c "vacuum full analyze"

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

Возможно часть сохранённых пользовательских фильтров собьётся (в списке абонентов, заданий...), т.к. поменялись как ID/UUID так и расширены возможности фильтрации очень сильно. Их необходимо будет перенастроить по-новой.

Теперь все API-запросы на "запись/изменение данных" выполняются через POST. Доработайте свои скрипты, при необходимости.

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

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

@@ Строка 40: / Строка 40: @@
 * Если вы обновляетесь с версии 3.19 и ранее - ознакомьтесь со страницей: [[Обновление 3.20]]
+* Если вы используете [[Кастомизация|кастомизацию]] - перенесите файлы по новому пути
 * Перенесите/удалите посторонние файлы, каталоги и прочее из директории userside. Там должны находится только дистрибутивные файлы самой системы и файлы, которые система создает во время своей работы. Модули userside (usm) также не должны там хранится. Используйте отдельные каталоги для них (например, /opt/userside). Посторонние файлы из директории userside могут быть удалены в процессе обновления
@@ Строка 63: / Строка 65: @@
 * Возможно часть сохранённых пользовательских фильтров собьётся ''(в списке абонентов, заданий...)'', т.к. поменялись как ID/UUID так и расширены возможности фильтрации очень сильно. Их необходимо будет перенастроить по-новой.
+* Теперь все API-запросы на "запись/изменение данных" выполняются через POST. Доработайте свои скрипты, при необходимости.
 '''Список изменений:''' [[3.21|просмотреть]]
 '''Проведение обновления:''' [[Обновление|инструкция]]