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

Материал из WiKi - UserSide
Нет описания правки
Нет описания правки
 
(не показаны 24 промежуточные версии 3 участников)
Строка 1: Строка 1:
Дата обновления: '''в разработке...'''
[[Upgrade_3.13|en]] | [[Обновление_3.13|ru]]
 
Дата обновления: '''май 2019'''


Требуется версия: '''[[3.10]] и выше'''
Требуется версия: '''[[3.10]] и выше'''
Строка 8: Строка 10:


* Внедрена новая адресная система. Мы ушли от работы с областями/районами областей/населёнными пунктами/районами/улицами а внедрили универсальную систему, где можно учитывать и работать с любыми типами объектов. Город может входить в другой город. Дом иметь четыре и более адресов, улица может иметь множество алиасов ''(текущее название, историческое название, название на другом языке и т.п.)'' и множество других вариантов. Да, существует терминология "токенов" чтобы программа понимала - что это за объект - город или улица или что-то ещё, но это сделано больше для обратной совместимости с биллинговыми системами, которые не оперируют подобной иерархией.
* Внедрена новая адресная система. Мы ушли от работы с областями/районами областей/населёнными пунктами/районами/улицами а внедрили универсальную систему, где можно учитывать и работать с любыми типами объектов. Город может входить в другой город. Дом иметь четыре и более адресов, улица может иметь множество алиасов ''(текущее название, историческое название, название на другом языке и т.п.)'' и множество других вариантов. Да, существует терминология "токенов" чтобы программа понимала - что это за объект - город или улица или что-то ещё, но это сделано больше для обратной совместимости с биллинговыми системами, которые не оперируют подобной иерархией.
* Теперь в новых инсталляциях UserSide будет только одна карта покрытия с типом "гео-служба". Добавлять новые карты с типом "файл" можно без проблем, однако "гео-карта" будет только одна. Для существующих клиентов - все имеющиеся карты с типом "гео-служба" будут оставаться, однако новые добавить уже нельзя. Мы давно стимулируем клиентов к переходу на использование только одной карты - так лучше и удобнее для всех. Подробнее на эту тему можно почитать в [[FAQ. Использовать в работе одну карту или несколько карт|FAQ]].


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


* Убрана поддержка т.н. "внутреннего биллинга"
* Убрана поддержка т.н. "внутреннего биллинга"
* Добавили возможность экспорта ВОЛС в KML ''(Google Earth)''
* Решён давний вопрос со сменой раздела у наименования ТМЦ. Напомню, что например нельзя было для "Коммутатора" поставить тип "Радиооборудование" или для "Прочего" поставить тип "Медиаконвертер". Однако были большие проблемы у клиентов, которые неверно внесли, к примеру 1000 ONU с типом "Прочее", а необходимо было их перевести в "Коммутаторы/OLT/ONU". Теперь это решено.
* Сделали собственные координаты у оборудования. Устройство может теперь на карте покрытия находится не прямо на узле связи, а на отдалении ''(актуально для радиооборудования и камер)''


* Внесены изменения в "[[Регламент технической поддержки]]". Мы будем поддерживать осуществлять консультацию и разбор ошибок только в рамках 3 последних версий ''(соответственно 3.13, 3.12 и 3.11)''. Для более ранних версий будем только рекомендовать обновление до последних сборок.
* Внесены изменения в "[[Регламент технической поддержки]]". Мы будем поддерживать осуществлять консультацию и разбор ошибок только в рамках 3 последних версий ''(соответственно 3.13, 3.12 и 3.11)''. Для более ранних версий будем только рекомендовать обновление до последних сборок.
Строка 27: Строка 37:
* И напоследок, пожалуйста, нет не так - '''ПОЖАЛУЙСТА''' - прямо сейчас проверьте свой бэкап системы. Действительно ли он формируется ''(конечно на другой физической машине)'' и действительно ли он разворачивается без проблем? Мы гораздо чаще чем это нам бы хотелось слышим о фактах отсутствия бэкапов или о невозможности их развёртывания.
* И напоследок, пожалуйста, нет не так - '''ПОЖАЛУЙСТА''' - прямо сейчас проверьте свой бэкап системы. Действительно ли он формируется ''(конечно на другой физической машине)'' и действительно ли он разворачивается без проблем? Мы гораздо чаще чем это нам бы хотелось слышим о фактах отсутствия бэкапов или о невозможности их развёртывания.


== Замечания для альфа-версии ==
== Особенности в проведении обновления ==


''(будет находится здесь до момента перехода версии 3.13 в стадию RC)''
* Если у вас Docker - ознакомьтесь со страницей: [[Docker окружение#Обновление с устаревшей версии 3.12 на новую|Docker окружение]]


'''ЭТО ВАЖНО!'''
* Если вы обновляетесь с версии 3.10 - ознакомьтесь со страницей: [[Обновление 3.11]]


Адресация - это очень важный аспект USERSIDE. Почти все объекты завязаны на адресацию - дома, абоненты, узлы связи, ВОЛС, задания и т.п. В процессе внедрения новой системы адресации мы были вынуждены во-многом переделать почти весь код USERSIDE. Также внедрялся определённый комплекс автотестов, что также потребовало изменение кода. Поэтому выпуск версии 3.13 затянулся на срок более года. Однако доработка версии 3.13 продолжается и сейчас и многие ошибки ещё не выявлены, не устранены и не обложены тестами. Просим вашей поддержки и энтузиазма в ознакомлении с альфа/бета-версиями 3.13. Сообщайте нам о найденных недоработках. Будем их оперативно решать. Нам помогает ваша поддержка.
* Если вы обновляетесь с версии 3.11 и ранеее - ознакомьтесь со страницей: [[Обновление 3.12]]


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


* Если вы обновляетесь с версии 3.10 - ознакомьтесь со страницей: [[Обновление 3.11]]
* Если отсутствует PHP библиотека hash - необходимо её добавить ''(актуальнее для FreeBSD)''


* Если вы обновляетесь с версии 3.11 и ранеее - ознакомьтесь со страницей: [[Обновление 3.12]]
* Обновите PostgreSQL до 10 версии или выше. Не забудьте библиотеку postgis подключить.


* Обновите PHP до версии 7.1 ''(PHP 7.2 пока не поддерживается)''
* [[Установка#Redis|Установите Redis]]


* С помощью автоматического [[Инсталлятор|инсталлятора]] выполните [[Обновление (инсталлятор)|обновление]].  
* С помощью автоматического [[Инсталлятор|инсталлятора]] выполните [[Обновление|обновление]]. В случае ошибки в процессе обновления или если работа инсталлятора не была завершена корректно, запустите инсталлятор в режиме восстановления:
sudo -u www-data php userside_install.phar repair


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


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


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


* При использовании модуля [[usm_ping]] замените его на [[usm_checker]]
* При использовании модуля [[usm_ping]] замените его на [[usm_checker]]
Строка 61: Строка 74:
'''Список изменений:''' [[3.13|просмотреть]]
'''Список изменений:''' [[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
  • И напоследок, пожалуйста, нет не так - ПОЖАЛУЙСТА - прямо сейчас проверьте свой бэкап системы. Действительно ли он формируется (конечно на другой физической машине) и действительно ли он разворачивается без проблем? Мы гораздо чаще чем это нам бы хотелось слышим о фактах отсутствия бэкапов или о невозможности их развёртывания.

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

  • Если вы обновляетесь с версии 3.10 - ознакомьтесь со страницей: Обновление 3.11
  • Если вы обновляетесь с версии 3.11 и ранеее - ознакомьтесь со страницей: Обновление 3.12
  • Обновите PHP до версии 7.1
  • Если отсутствует PHP библиотека hash - необходимо её добавить (актуальнее для FreeBSD)
  • Обновите PostgreSQL до 10 версии или выше. Не забудьте библиотеку postgis подключить.
  • С помощью автоматического инсталлятора выполните обновление. В случае ошибки в процессе обновления или если работа инсталлятора не была завершена корректно, запустите инсталлятор в режиме восстановления:
sudo -u www-data php userside_install.phar repair
  • После обновления проверьте ситуацию с учётными записями сотрудников и операторов. Они должны быть объединены, для тех операторов у которых не было записей о сотрудников - информация была дополнена нужными полями автоматически. То же касается и информации об операторах для тех сотрудников, кто не имели учёток доступа в userside.
  • Если у операторов был настроен доступ по диапазонам IP-адресов - то был перенесён только первый IP-адрес диапазона
  • Для сотрудников у которых не было учётных записей операторов - эти учётные записи были созданы с заблокированным состоянием
  • В связи с переработкой интерфейса фильтров - в списке абонентов и списке заданий может возникнуть необходимость перенастроить собственные фильтры
  • Осуществлён переезд на новую адресную систему. Проверьте настройки рекламных кампаний и SMS-рассылок. Корректно ли адреса указаны в них.
  • При использовании сателлитов - проведите замену на новый модуль сателлита
  • При использовании модуля us_gps замените его на usm_gps 2
  • При использовании модуля usm_ping замените его на usm_checker

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

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