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

Текущая версия от 10:46, 30 августа 2024

en | ru

Дата обновления: май 2019

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

Несколько слов от автора - особенности версии

Наконец-то, после многих лет проб и ошибок, мы придумали как выводить на одной странице схему коммутации между двумя произвольными узлами или муфтами. Основная ведь проблема была в том, что все муфты и узлы - разного размера и в них входит с разных направления и в разном порядке неизвестное заранее количество ВОЛС.

Внедрена новая адресная система. Мы ушли от работы с областями/районами областей/населёнными пунктами/районами/улицами а внедрили универсальную систему, где можно учитывать и работать с любыми типами объектов. Город может входить в другой город. Дом иметь четыре и более адресов, улица может иметь множество алиасов (текущее название, историческое название, название на другом языке и т.п.) и множество других вариантов. Да, существует терминология "токенов" чтобы программа понимала - что это за объект - город или улица или что-то ещё, но это сделано больше для обратной совместимости с биллинговыми системами, которые не оперируют подобной иерархией.

Теперь в новых инсталляциях UserSide будет только одна карта покрытия с типом "гео-служба". Добавлять новые карты с типом "файл" можно без проблем, однако "гео-карта" будет только одна. Для существующих клиентов - все имеющиеся карты с типом "гео-служба" будут оставаться, однако новые добавить уже нельзя. Мы давно стимулируем клиентов к переходу на использование только одной карты - так лучше и удобнее для всех. Подробнее на эту тему можно почитать в FAQ.

Прямо с карты можно добавлять новые здания. Нажимаем на карту - обратный геокодер получает адрес этой точки на карте и пытается найти в базе населённый пункт, улицу и подставляет их в диалог создания нового дома. Указывает номер дома и рисует полигон этого здания. Попробуйте!

Также можно прямо с карты создавать новую ВОЛС. Нажимаем на первом узле/муфте, на втором - и открывается окно добавления ВОЛС

Изменена работа с интерфейсами устройств. Ранее мы в карточке оборудования и в целом по системе оперировали физическими портами оборудования. Это иногда влекло к значительным трудностями, т.к. есть порты, есть интерфейсы, а ещё бывают и индексы интерфейсов, которые в разных VLAN могут быть ещё и разными... Кроме того в разных моделях оборудования какие-то порты нужны, а какие-то не нужны, бывают платы расширения и т.п. Поэтому гораздо проще дать вам возможность самостоятельно настраивать для устройств какие интерфейсы вам нужны, в каком порядке. Можете настраивать на уровне конкретного устройства или скопировать настройки уже с существующего устройства такой же модели.

Учётные записи операторов объединены с учётными записями сотрудников. Теперь одна общая запись для человека (это также повлекло ликвидацию секции API->operator. Используйте API->staff).

Убрана поддержка т.н. "внутреннего биллинга"

Добавили возможность экспорта ВОЛС в KML (Google Earth)

Решён давний вопрос со сменой раздела у наименования ТМЦ. Напомню, что например нельзя было для "Коммутатора" поставить тип "Радиооборудование" или для "Прочего" поставить тип "Медиаконвертер". Однако были большие проблемы у клиентов, которые неверно внесли, к примеру 1000 ONU с типом "Прочее", а необходимо было их перевести в "Коммутаторы/OLT/ONU". Теперь это решено.

Сделали собственные координаты у оборудования. Устройство может теперь на карте покрытия находится не прямо на узле связи, а на отдалении (актуально для радиооборудования и камер)

Внесены изменения в "Регламент технической поддержки". Мы будем поддерживать осуществлять консультацию и разбор ошибок только в рамках 3 последних версий (соответственно 3.13, 3.12 и 3.11). Для более ранних версий будем только рекомендовать обновление до последних сборок.

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

Ещё у нас есть канал для новостей: https://t.me/userside

И напоследок, пожалуйста, нет не так - ПОЖАЛУЙСТА - прямо сейчас проверьте свой бэкап системы. Действительно ли он формируется (конечно на другой физической машине) и действительно ли он разворачивается без проблем? Мы гораздо чаще чем это нам бы хотелось слышим о фактах отсутствия бэкапов или о невозможности их развёртывания.

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

Если у вас Docker - ознакомьтесь со страницей: Docker окружение

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

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

Обновите PHP до версии 7.1

Если отсутствует PHP библиотека hash - необходимо её добавить (актуальнее для FreeBSD)

Обновите PostgreSQL до 10 версии или выше. Не забудьте библиотеку postgis подключить.

Установите Redis

С помощью автоматического инсталлятора выполните обновление. В случае ошибки в процессе обновления или если работа инсталлятора не была завершена корректно, запустите инсталлятор в режиме восстановления:

sudo -u www-data php userside_install.phar repair

После обновления проверьте ситуацию с учётными записями сотрудников и операторов. Они должны быть объединены, для тех операторов у которых не было записей о сотрудников - информация была дополнена нужными полями автоматически. То же касается и информации об операторах для тех сотрудников, кто не имели учёток доступа в userside.

Если у операторов был настроен доступ по диапазонам IP-адресов - то был перенесён только первый IP-адрес диапазона

Для сотрудников у которых не было учётных записей операторов - эти учётные записи были созданы с заблокированным состоянием

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

Осуществлён переезд на новую адресную систему. Проверьте настройки рекламных кампаний и SMS-рассылок. Корректно ли адреса указаны в них.

При использовании сателлитов - проведите замену на новый модуль сателлита

При использовании модуля us_gps замените его на usm_gps 2

При использовании модуля usm_ping замените его на usm_checker

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

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

@@ Строка 1: / Строка 1: @@
-Дата обновления: '''в разработке...'''
+[[Upgrade_3.13|en]] | [[Обновление_3.13|ru]]
+Дата обновления: '''май 2019'''
 Требуется версия: '''[[3.10]] и выше'''
 == Несколько слов от автора - особенности версии ==
+* Наконец-то, после многих лет проб и ошибок, мы придумали как выводить на одной странице схему коммутации между двумя произвольными узлами или муфтами. Основная ведь проблема была в том, что все муфты и узлы - разного размера и в них входит с разных направления и в разном порядке неизвестное заранее количество ВОЛС.
 * Внедрена новая адресная система. Мы ушли от работы с областями/районами областей/населёнными пунктами/районами/улицами а внедрили универсальную систему, где можно учитывать и работать с любыми типами объектов. Город может входить в другой город. Дом иметь четыре и более адресов, улица может иметь множество алиасов ''(текущее название, историческое название, название на другом языке и т.п.)'' и множество других вариантов. Да, существует терминология "токенов" чтобы программа понимала - что это за объект - город или улица или что-то ещё, но это сделано больше для обратной совместимости с биллинговыми системами, которые не оперируют подобной иерархией.
+* Теперь в новых инсталляциях UserSide будет только одна карта покрытия с типом "гео-служба". Добавлять новые карты с типом "файл" можно без проблем, однако "гео-карта" будет только одна. Для существующих клиентов - все имеющиеся карты с типом "гео-служба" будут оставаться, однако новые добавить уже нельзя. Мы давно стимулируем клиентов к переходу на использование только одной карты - так лучше и удобнее для всех. Подробнее на эту тему можно почитать в [[FAQ. Использовать в работе одну карту или несколько карт|FAQ]].
 * Прямо с карты можно добавлять новые здания. Нажимаем на карту - обратный геокодер получает адрес этой точки на карте и пытается найти в базе населённый пункт, улицу и подставляет их в диалог создания нового дома. Указывает номер дома и рисует полигон этого здания. Попробуйте!
@@ Строка 11: / Строка 17: @@
 * Также можно прямо с карты создавать новую ВОЛС. Нажимаем на первом узле/муфте, на втором - и открывается окно добавления ВОЛС
-* Учётные записи операторов объединены с учётными записями сотрудников. Теперь одна общая запись для человека.
+* Изменена работа с интерфейсами устройств. Ранее мы в карточке оборудования и в целом по системе оперировали физическими портами оборудования. Это иногда влекло к значительным трудностями, т.к. есть порты, есть интерфейсы, а ещё бывают и индексы интерфейсов, которые в разных VLAN могут быть ещё и разными... Кроме того в разных моделях оборудования какие-то порты нужны, а какие-то не нужны, бывают платы расширения и т.п. Поэтому гораздо проще дать вам возможность самостоятельно настраивать для устройств какие интерфейсы вам нужны, в каком порядке. Можете настраивать на уровне конкретного устройства или скопировать настройки уже с существующего устройства такой же модели.
+* Учётные записи операторов объединены с учётными записями сотрудников. Теперь одна общая запись для человека ''(это также повлекло ликвидацию секции API->operator. Используйте API->staff)''.
 * Убрана поддержка т.н. "внутреннего биллинга"
-* Напоминаю про нашу группу в Telegram для взаимного общения клиентов и разработчиков между собой: https://t.me/usersideeu
+* Добавили возможность экспорта ВОЛС в KML ''(Google Earth)''
+* Решён давний вопрос со сменой раздела у наименования ТМЦ. Напомню, что например нельзя было для "Коммутатора" поставить тип "Радиооборудование" или для "Прочего" поставить тип "Медиаконвертер". Однако были большие проблемы у клиентов, которые неверно внесли, к примеру 1000 ONU с типом "Прочее", а необходимо было их перевести в "Коммутаторы/OLT/ONU". Теперь это решено.
-* Ещё у нас есть канал для новостей: https://t.me/userside
+* Сделали собственные координаты у оборудования. Устройство может теперь на карте покрытия находится не прямо на узле связи, а на отдалении ''(актуально для радиооборудования и камер)''
-== Замечания для альфа-версии ==
+* Внесены изменения в "[[Регламент технической поддержки]]". Мы будем поддерживать осуществлять консультацию и разбор ошибок только в рамках 3 последних версий ''(соответственно 3.13, 3.12 и 3.11)''. Для более ранних версий будем только рекомендовать обновление до последних сборок.
-''(будет находится здесь до момента перехода версии 3.13 в стадию RC)''
+* Напоминаю про нашу группу в Telegram для взаимного общения клиентов и разработчиков между собой: https://t.me/usersideeu
-'''ЭТО ВАЖНО!'''
+* Ещё у нас есть канал для новостей: https://t.me/userside
-Адресация - это очень важный аспект USERSIDE. Почти все объекты завязаны на адресацию - дома, абоненты, узлы связи, ВОЛС, задания и т.п. В процессе внедрения новой системы адресации мы были вынуждены во-многом переделать почти весь код USERSIDE. Также внедрялся определённый комплекс автотестов, что также потребовало изменение кода. Поэтому выпуск версии 3.13 затянулся на срок более года. Однако доработка версии 3.13 продолжается и сейчас и многие ошибки ещё не выявлены, не устранены и не обложены тестами. Просим вашей поддержки и энтузиазма в ознакомлении с альфа/бета-версиями 3.13. Сообщайте нам о найденных недоработках. Будем их оперативно решать. Нам помогает ваша поддержка.
+* И напоследок, пожалуйста, нет не так - '''ПОЖАЛУЙСТА''' - прямо сейчас проверьте свой бэкап системы. Действительно ли он формируется ''(конечно на другой физической машине)'' и действительно ли он разворачивается без проблем? Мы гораздо чаще чем это нам бы хотелось слышим о фактах отсутствия бэкапов или о невозможности их развёртывания.
 == Особенности в проведении обновления ==
+* Если у вас Docker - ознакомьтесь со страницей: [[Docker окружение#Обновление с устаревшей версии 3.12 на новую|Docker окружение]]
 * Если вы обновляетесь с версии 3.10 - ознакомьтесь со страницей: [[Обновление 3.11]]
@@ Строка 33: / Строка 45: @@
 * Если вы обновляетесь с версии 3.11 и ранеее - ознакомьтесь со страницей: [[Обновление 3.12]]
-* Обновите PHP до версии 7.1. Версия PHP 7.2 пока не поддерживается.
+* Обновите PHP до версии 7.1
-* С помощью автоматического [[Инсталлятор|инсталлятора]] выполните [[Обновление (инсталлятор)|обновление]].
+* Если отсутствует PHP библиотека hash - необходимо её добавить ''(актуальнее для FreeBSD)''
+* Обновите PostgreSQL до 10 версии или выше. Не забудьте библиотеку postgis подключить.
+* [[Установка#Redis|Установите Redis]]
+* С помощью автоматического [[Инсталлятор|инсталлятора]] выполните [[Обновление|обновление]]. В случае ошибки в процессе обновления или если работа инсталлятора не была завершена корректно, запустите инсталлятор в режиме восстановления:
+ sudo -u www-data php userside_install.phar repair
 * После обновления проверьте ситуацию с учётными записями сотрудников и операторов. Они должны быть объединены, для тех операторов у которых не было записей о сотрудников - информация была дополнена нужными полями автоматически. То же касается и информации об операторах для тех сотрудников, кто не имели учёток доступа в userside.
-* При использовании модуля [[us_gps]] замените его на [[usm_gps]]
+* Если у операторов был настроен доступ по диапазонам IP-адресов - то был перенесён только первый IP-адрес диапазона
+* Для сотрудников у которых не было учётных записей операторов - эти учётные записи были созданы с заблокированным состоянием
+* В связи с переработкой интерфейса фильтров - в списке абонентов и списке заданий может возникнуть необходимость перенастроить собственные фильтры
+* Осуществлён переезд на новую [[Адресная система|адресную систему]]. Проверьте настройки рекламных кампаний и SMS-рассылок. Корректно ли адреса указаны в них.
+* При использовании сателлитов - проведите замену на новый модуль [[usm_satellite|сателлита]]
+* При использовании модуля [[us_gps]] замените его на [[usm_gps_2|usm_gps 2]]
-* При использовании модуля us_ping замените его на [[usm_checker]]
+* При использовании модуля [[usm_ping]] замените его на [[usm_checker]]
 '''Список изменений:''' [[3.13|просмотреть]]
-'''Проведение обновления:''' [[Обновление (инсталлятор)|инструкция]]
+'''Проведение обновления:''' [[Обновление|инструкция]]