ELTEX Cloud Configuration Manager
Руководство по эксплуатации
Версия ПО 1.5.0

Введение

ECCM (ELTEX Cloud Configuration Manager) — это централизованная система управления сетевым оборудованием. Управление системой осуществляется с помощью web-интерфейса, который предоставляет удобные инструменты для настройки системы и сетевого оборудования под нужды пользователя. Данное руководство содержит описание интерфейса пользователя и основных приемов работы с ним.

Доступ к пользовательскому интерфейсу

Для подключения к интерфейсу пользователя необходимо ввести в адресной строке браузера ссылку http://<ECCM_ADDRESS>:80/, где <ECCM_ADDRESS> — это адрес сервера ECCM в вашей сети (это может быть IP-адрес или доменное имя, если у вас настроен DNS).

Откроется страница с формой авторизации:

Введите логин eccm и пароль eccm в соответствующие поля и нажмите кнопку "Войти". 

Интерфейс системы управления

Пользовательский интерфейс представляет собой одностраничное web-приложение, которое состоит из нескольких основных частей:

1. Панель навигации по разделам.
2. Селектор выбора языка интерфейса.
3. Сведения об учетной записи и ссылка на Персональную страницу пользователя.
4. Кнопка для выхода из системы. При нажатии на нее сессия будет разорвана.
5. Рабочая область. В зависимости от выбранного раздела здесь будут представлены различные виджеты.
6. Кнопка сворачивания панели навигации (для расширения рабочей области).

Персональная страница 

Раздел с информацией о пользовательском аккаунте, отражающий роль пользователя и группы, в которых он состоит:

Фильтры в таблицах

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

1. Выпадающий список с заголовками из таблицы, доступными для фильтрации.
2. Выпадающий список со списком операций, доступных для данного типа фильтра.
3. Поле для ввода запроса. Данное поле может быть представлено в виде одного или нескольких элементов пользовательского интерфейса, поддерживающих пользовательский ввод.

Для каждого фильтра доступны следующие кнопки:

1. Кнопка удаления настраиваемого фильтра.
2. Кнопка добавления нового фильтра.
3. Кнопка применения настроенных на странице фильтров.

Кнопки добавления и применения фильтров по умолчанию находятся в неактивном состоянии до того времени, пока все имеющиеся на странице фильтры не будут заполнены.

По умолчанию после загрузки страницы над таблицей располагается место для фильтров, а также один незаполненный фильтр. В новом фильтре доступен только выпадающий список с заголовками таблицы для фильтрации. Остальные поля недоступны для ввода. После указания значения для заголовка таблицы в карточке фильтра появляется возможность указать оператор и ввести запрос для поиска или фильтрации. Фильтр может использоваться самостоятельно, а также в совокупности с другими фильтрами.

Порядок использования фильтров:

• Зайдите на страницу с таблицей. По умолчанию на ней имеется один незаполненный фильтр.
• В карточке фильтра нажмите на поле "Фильтр" и выберите название таблицы для фильтрации.
• Далее выберите операцию в поле "Операция". По умолчанию выбраны операторы CONTAINS или EQ.
• В поле "Значение" введите значение для поиска.
• Нажмите кнопку "Применить фильтр". На странице отобразятся строки, соответствующие искомому значению.
• Для возврата в исходное состояние удалите все имеющиеся фильтры на странице, используя кнопку удаления, и после этого нажмите кнопку "Применить фильтр".

Пример поиска устройств модели ESR-10 со статусом UP и заданной частью IP-адреса:

Сводная информация

В данном разделе отображаются данные о состоянии системы:

1. Общая статистика — счетчики, показывающие отношение недоступных устройств к общему количеству устройств в системе, а также отношение сработавших триггеров (преднастроенных порогов, пересечение которых требует особого внимания) к общему количеству устройств. Дает представление об общих проблемах в сети.
2. Статистика недоступных устройств по группам — счетчики недоступных устройств по каждой административной группе. Если группа содержит устройства, к которым был утерян доступ, ее рамка подсвечивается цветом. Если недоступно менее 5% — розовым, если более 5% — красным.
3. Недоступные устройства — список устройств, доступ к которым был утерян. В таблице отображается название устройства (в виде активной ссылки), время потери доступа и длительность простоя.
4. Проблемы — список сработавших триггеров. В таблице отображается название устройства, на котором сработал триггер (в виде активной ссылки), название триггера, время его срабатывания и уровень важности.

Данные автоматически обновляются каждую минуту. В случае возникновения проблем с доступом на сервер на странице кэшируются последние данные и отображается время последнего успешного обновления.

Карты сети

В данном разделе содержится информации о картах сети. Карта сети — это логико-графико-схематическое представление взаимодействия сетевых устройств.

Данный раздел позволяет определять связь устройств в рамках одной группы и осуществлять мониторинг доступности устройств на карте.

В разделе отображаются инструменты для управления картами сети (1) и их список (2):

1. Инструменты управления картами:
   • Создать — создать новую карту сети.
   • Удалить — удалить выбранные карты из списка.
2. Список карт, доступных в системе:
   • Название — название карты.
   • Группа — группа устройств, которые доступны для использования на карте.

Просмотр карты сети

Для просмотра карты сети необходимо кликнуть на ее название в списке. На странице карты отображается кнопка редактирования карты (1) и сама карта сети (2).

Элементы карты сети

Карта сети состоит из следующих элементов:

• Узел сети — ( для маршрутизаторов) и (для коммутаторов) . Отображает устройство сети и его статус в системе:

  Цвет узла	Описание статуса
  Синий	Устройство доступно для работы в системе
  Серый	Устройство ещё не синхронизировано
  Тёмно-серый	Устройство недоступно или заблокировано в системе
  Красный	Устройство недоступно
  Оранжевый	На устройстве есть проблемы с ресурсами

• Информация об устройстве —  . Отображает имя устройства (в качестве имени устройства используется его hostname) и информацию о его статусах доступности (сетевой, мониторинга, управления).
• Связь между узлами — отображает связь между сетевыми устройствами для представления топологии сети (на связи подписаны интерфейсы устройств, через которые они соединены друг с другом).

Создание карты

Для создания новой карты сети необходимо в разделе "Карты сети" нажать кнопку "Создать", после чего откроется редактор карты сети.

Редактирование карты

Для редактирования карты сети необходимо выбрать карту в разделе "Карты сети", перейти на страницу просмотра карты и нажать кнопку "Редактировать". Откроется редактор карты сети:

Элементы управления редактором карты сети:

1. Название — имя создаваемой карты сети.
2. Группа — группа устройств, доступных для использования в редакторе (можно задать только при создании новой карты).
3. Добавить устройства — кнопка, открывающая список устройств из выбранной группы для добавления их на карту.
4. Добавить облако — кнопка, добавляющая на карту облако.
5. Удалить — кнопка для удаления выбранного устройства с карты.
6. Создать подкарту — кнопка для привязки к объекту подкарты.
7. Сохранить — кнопка для сохранения данных карты сети.
8. Вернуться — кнопка для возврата к списку карт сети (без сохранения изменений/создания новой карты).

Добавление устройства

Для добавления устройства необходимо в редакторе карты сети нажать на кнопку "Добавить устройство", после чего откроется окно выбора устройства. Выбор устройства осуществляется нажатием на флаг в соответствующей строке.

1. Инструменты управления:
   • Выбрать — добавляет выбранное устройство на карту.
   • Отменить — закрывает окно выбора устройств.
2. Фильтр таблицы выбора устройств.
3. Таблица устройств, в которой отображаются данные о состоянии устройств, входящих в выбранную группу. Стоит обратить внимание на следующие столбцы:
   • IP — IP-адрес устройства. Отображается в виде ссылки, по которой можно перейти на страницу управления устройством.
   • Обслуживание —  статус обслуживания устройства в системе. Если он обозначен как 'ENABLED', то устройство полностью обслуживается системой (опрос доступности, метрик, резервное копирование конфигурации, управление). В других случаях функции обслуживания могут быть приостановлены.
   • Доступность — статус доступности устройства по протоколам TCP/ICMP, SNMP, SSH .

После добавления устройства из списка узел устройства окажется на карте. При помощи курсора мыши его можно перенести в другое место.

Удаление устройства

Для удаления устройства выберите его в редакторе карты сети и нажмите кнопку "Удалить":

Подтвердите действие:

Добавление облака

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

Для добавления облака необходимо в редакторе сети нажать на кнопку "Добавить облако"  и указать его название ( дополнительно можно указать телефон, если облако используется для обозначения стыка с провайдером):

Добавление связи

Для добавления связи между узлами необходимо, чтобы на карте было 2 устройства и более. Наведите курсор мыши на первый узел устройства:

Щелкните левой кнопкой мыши на появившуюся на узле точку и, удерживая мышь, перенесите её на второй узел устройства:

После этого откроется окно выбора интерфейсов подключения, в котором необходимо выбрать интерфейсы, через которые устройства взаимодействуют:

Создание подкарты

Подкарты используются для перехода между картами сетей в системе при мониторинге.

Для создания подкарты в редакторе карт выберите объект или несколько объектов, нажмите кнопку "Создать" и выберите карту на которую будет ссылаться подкарта:

Удаление связи

Для удаления связи между узлами сети сделайте клик на связь между узлами:

Подтвердите действие удаления связи:

Удаление подкарты

Для удаления подкарты в редакторе карт выберите подкарту или объект, к которому подкарта привязана, и нажмите кнопку "Удалить":

Подтвердите действие удаления подкарты:

Автоматическое создание связей по LLDP

Группы

В данном разделе представлена информация об устройствах системы, разделенных на административные группы. Раздел позволяет добавлять и удалять группы и устройства в системе. 

В верхней части страницы отображается навигационная цепочка в стиле "breadcrumbs". Она отображает путь к текущей группе и позволяет выполнить быстрый возврат к любой из родительских групп. В зависимости от типа группы в таблице групп может отображаться разная информация. 

Для группы типа 'GROUPS' отображаются: навигационная цепочка (1), кнопка для добавления новой группы (2) и таблица со списком вложенных групп (3): 

Есть два типа групп: 'DEVICES' для устройств и 'GROUPS' для групп. В группе типа 'GROUPS' отображаются вложенные группы типа 'DEVICE' и счетчики, отражающие суммарную информацию по всем вложенным группам.

В таблице отображается информация:

• Имя группы — активная ссылка для перехода в группу.
• Всего устройств — суммарное количество устройств в группе или в дочерних группах.
• Устройства с проблемами — суммарное количество устройств в группе или в дочерних группах, в которых обнаружены сработавшие триггеры.
• Недоступные устройства — суммарное количество устройств в группе или в дочерних группах, к которым был потерян доступ с сервера управления.

В группе типа 'DEVICES' отображается список устройств, принадлежащих этой группе, и инструменты для управления устройствами:

1. Навигационная цепочка
2. Инструменты управления устройствами:
   • Добавить устройства.
   • Переместить — переместить устройство в другую группу.
   • Удалить — удалить устройство из системы.
   • Заблокировать/Разблокировать — в статусе "Заблокировано" устройство перестает опрашиваться системой, при этом все данные мониторинга и конфигурации устройства, полученные ранее, будут сохранены.
3. Фильтр таблицы устройств.
4. Таблица со списком устройств, в которой отображаются данные о состоянии устройств, входящих в выбранную группу:
   • IP — IP-адрес устройства. Отображается в виде ссылки, по которой можно перейти на страницу управления устройством.
   • Обслуживание —  статус обслуживания устройства в системе. Если он обозначен как 'ENABLED', то устройство полностью обслуживается системой (опрос доступности, метрик, резервное копирование конфигурации, управление). В других случаях функции обслуживания могут быть приостановлены.
   • Доступность — статус доступности устройства по протоколам TCP/ICMPT, SNMP, SSH.
   • Длительность текущего статуса — время, прошедшее после смены статуса устройства. Высчитывается каждый раз при обновлении таблицы. 
   • Триггеры — отношение сработавших триггеров к общему количеству триггеров.

Добавление устройств - Ручное добавление

Во вкладке "Ручное добавление" можно добавить новые устройства в систему. Каждое устройство отображается в отдельной строке, в которой нужно указать его IP и модель. Система проводит проверку введенных данных и в поле Статус отображает, возможно ли добавить устройство в систему (статус == OK), или есть какие-либо ошибки (например, некорректный IP-адрес или недостаток лицензий для выбранной модели).

Элементы интерфейса:

1. IP — поле для указания IP-адреса нового устройства. В это поле можно скопировать список адресов, разделенных пробелом. Они автоматически будут преобразованы в несколько строк.
2. Модель — в этом поле отображается название модели, а в скобках указано количество устройств, которое можно добавить согласно установленной лицензии.
3. Статус — результат проверки введенных данных. Возможные статусы:
   1. OK — проверка прошла успешно, это устройство можно добавить в систему.
   2. INVALID_IP — адрес не прошел валидацию: формат некорректен, или есть лишние символы.
   3. NO_LICENSE — достигнут лимит количества устройств данной модели в лицензии.
   4. DUPLICATE_IP — в системе или в списке устройств на добавление уже есть устройство с указанным IP-адресом.
4. Кнопка для удаления устройства из списка.
5. Кнопка для добавления дополнительного устройства в список. 
6. Кнопки управления: 

• Отменить — закрыть окно без сохранения.
• Добавить устройства — добавить все устройства, прошедшие валидацию (имеющие статус "ОК"). Не прошедшие валидацию устройства будут проигнорированы.

Добавление устройств - Обнаружение

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

Во вкладке доступны следующие поля:

1. Диапазон — поле для указания диапазона адресов. Поддерживает ввод в различных форматах. Примеры:
   • 10.25.96.1-90
   • 10.25.96.1-10.25.96.90

   • 10.25.96.1/24

     Из диапазона будет обработано ограниченное количество устройств, по умолчанию лимит выставлен на 1024 устройства.
2. Версия snmp — выпадающий список с возможностью выбора версии протокола. Поддерживаются протоколы:
   1. V1 — для устройств со старой версией SNMP.
   2. V2C — по умолчанию подходит под большинство устройств.
3. Порт snmp — чаще всего используется 161, но можно указать иное значение.
4. Communities — пароль для доступа к snmp.
5. Поиск — кнопка для выполнения запроса поиска устройств после заполнения формы.

В результате поиска устройств будет предложен выбор устройств для добавления в ECCM.

Результаты поиска отображаются в таблице со следующими полями:

• IP — IP-адрес нового устройства.
• Модель — название модели.
• Серийный номер — серийный номер устройства.
• MAC — MAC-адрес устройства.
• Версия — версия ПО, установленная на устройстве.
• Статус — статус устройства в системе ECCM.

С результатами поиска можно выполнить следующие операции:

• Вручную выбрать отдельные устройства для добавления (1). Некоторые устройства могут быть недоступны для выбора по причинам, отраженным в поле "Статус" (2).
• Выбрать группу устройств определённой модели, отметив ее целиком (3).
• Выбрать все обнаруженные устройства (4).

После завершения выбора устройств нажмите кнопку "Добавить устройства" (5).

Устройства

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

В таблице отображается следующая информация:

• ID — порядковый номер устройства в системе управления, присваивается при добавлении устройства в систему. Нумерация начинается от 100, каждый номер уникален и не может быть использован повторно.
• Серийный номер — комбинация цифр и букв, которая вычитывается с устройства по SNMP и хранится в базе данных.
• IP — IP-адрес устройства в сети управления устройствами (каждое устройство имеет уникальный IP-адрес). Отображается в виде ссылки, по которой можно перейти на страницу управления устройством.
• Hostname — имя хоста, вычитывается с устройства по SNMP и хранится в базе данных.
• MAC — MAC-адрес устройства, вычитывается с устройства по SNMP и хранится в базе данных.
• Серия — название модельного ряда, вычитывается с устройства по SNMP и хранится в базе данных.
• Группа — группа, к которой относится устройство.
• Модель — название модели, вычитывается с устройства по SNMP и хранится в базе данных.
• Версия — номер прошивки, установленной на устройстве, вычитывается с устройства по SNMP и хранится в базе данных.
• Обслуживание —  статус обслуживания устройства в системе. Если он обозначен как 'ENABLED' - то устройство полностью обслуживается системой (опрос доступности, метрик, резервное копирование конфигурации, управление). В других случаях функции обслуживания могут быть приостановлены.
• Доступность — статус доступности устройства по протоколам TCP/ICMPT, SNMP, SSH .

Страница устройства

Интерфейс для работы с отдельным устройством.

Состоит из следующих элементов:

1. Заголовок — содержит название устройства и его IP-адрес.
2. Меню со вкладками: 
   • Информация об устройстве
   • Конфигурации
   • Доступ
   • Обновление ПО
   • События
   • Задачи
   • Мониторинг.

Информация об устройстве

На данной странице отображаются собранные инвентарные данные об устройстве:

Конфигурация

Функционал для управления конфигурацией устройства. 

Процесс конфигурирования отличается для устройств ESR и MES. Устройства ESR применяют или отклоняют конфигурацию целиком, в то время как MES применяют отдельные изменения сразу. В связи с этим, при работе с ESR создаются "черновики конфигурации", содержащие полную конфигурацию устройства, а для MES используются "макросы", содержащие только необходимые изменения.

Элементы управления:

1. Блок функций 1:
   • Перезагрузить — отправить команду для перезагрузки устройства.
   • Синхронизировать — получить текущую конфигурацию с устройства. Если она не будет совпадать с последней полученной с устройства (RUNNING) конфигурацией, она будет сохранена в системе как новая конфигурация.
   • Сравнение — перейти к сравнению двух выбранных конфигураций. Для перехода требуется выбрать (отметить галочками) две конфигурации из списка.
2. Блок функций 2:
   • Создать черновик / Создать макрос — создать новую пустую конфигурацию.
   • Редактировать — открыть редактор конфигурации.
   • Скачать — получить выбранную конфигурацию в виде текстового файла.
   • Применить / Запустить — применить выбранную конфигурацию на устройство.
3. Фильтр конфигураций.
4. Таблица конфигураций — отобразить список имеющихся конфигураций для устройства. 
5. Превью конфигурации — панель для отображения выбранной конфигурации (выбор производится по клику на строке конфигурации (не по флажку, расположенному напротив).

Типы конфигураций

RUNNING — последняя полученная с устройства конфигурация.

DRAFT — конфигурация, подготовленная для загрузки на устройство.

BACKUP — резервная копия конфигурации с устройства перед применением новой конфигурации. В случае смены текущей конфигурации на новую ей назначается тип BACKUP, а новой — RUNNING.

Редактор конфигурации

Позволяет создать копию (DRAFT) текущей версии конфигурации. При этом существующая конфигурация останется в базе данных и изменена не будет, оставляя возможность вернуться к ней.

1. Аннотация — комментарий к конфигурации. Указывается при создании новой конфигурации, после этого изменить аннотацию нельзя.
2. Область редактирования — текстовый редактор, позволяющий работать с большим объемом информации и обеспечивающий подсветку синтаксиса и внесенных изменений.
3. Кнопки управления:
   • Отменить — закрыть окно без сохранения.
   • Сохранить — сохранить изменения, создав новую конфигурацию с типом "Черновик" ("DRAFT").
   • Сохранить и Применить — сохранить новую конфигурацию как черновик и сразу же попытаться применить ее на устройство.

Редактор предоставляет инструменты для поиска по всей конфигурации. Для того чтобы воспользоваться поиском, нужно установить курсор в область редактирования и нажать сочетание клавиш Сtrl+F:

Доступ

Настройка Ansible-адаптера для выполнения операций на устройстве. Например, для применения конфигурации или перезагрузки.

По умолчанию для доступа к устройству используются глобальные параметры, которые можно изменить в разделе "Настройки" -> "Доступ". Чтобы настроить индивидуальные параметры доступа к устройству, нужно выставить флаг "Индивидуальные". Включение этой опции заставляет систему использовать все настройки на этой странице вместо глобальных, поэтому необходимо настроить все параметры:

• логины и пароли для доступа к устройству по SSH и SFTP* — доступ необходим для управления устройствами и получения конфигурации (*SFTP поддерживается только для ESR).
• snmp — здесь определяются настройки SNMP для проверки доступности устройства по этому протоколу. Данные параметры не изменяют настройки, используемые для получения метрик с устройства (эти параметры определяются только глобально). 
• network — настройки определения сетевой доступности устройства. Проверка может выполняться по протоколу ICMP ("обычный пинг") и проверкой установки TCP-соединения (более быстрый способ). Во втором случае дополнительно необходимо указать, на какой порт будет устанавливаться соединение.

Обновление ПО

Интерфейс для обновления прошивки на устройстве. В таблице отображается список ПО, имеющегося на сервере для данного типа устройства (добавление новых прошивок выполняется в разделе ПО). Если на сервере есть прошивка той же версии, которая установлена на устройстве, она будет отмечена красным индикатором (radiobutton) слева:

Для того чтобы обновить версию прошивки на устройстве, необходимо выставить флаг напротив соответствующей прошивки. Отобразится сообщение с подтверждением действия:

Если на сервере отсутствует прошивка, установленная сейчас на устройстве, в диалоговом окне отобразится сообщение с предупреждением.

События

В таблице отображается список событий, произошедших с устройством. Важные события, сообщающие о проблемах, обозначаются красным цветом.

Задачи

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

• Статус — текущий статус выполнения задачи.
• Тип — суть задачи.
• Описание — параметры, с которыми задача была запущена.
• Дата создания — дата и время создания задачи.
• Дата запуска — дата и время запуска задачи в активную работу. Может не совпадать с датой создания, т.к. задача может находиться в очереди обработчика.
• Дата завершения — дата и время завершения работы над задачей. При этом задача может завершиться успешно или не успешно.
• Лог — открыть журнал выполнения задачи из Ansible.

Мониторинг

Отображение данных мониторинга устройства. 

1. Выбор типа данных
2. Выбор временного диапазона выборки
3. График 

Типы данных 

Полный список типов собираемых данных зависит от конкретного устройства и его конфигураций, например от количества имеющихся процессорных ядер или сконфигурированных сущностей. Кроме этого есть общие метрики для всех устройств, например доступность по ICMP.

Все собираемые данные отображаются в выпадающем списке:

Временной диапазон выборки

Позволяет установить диапазон времени, в котором находятся интересующие данные. По умолчанию отображается диапазон с 00:00 текущего дня.

Для выбора даты и времени предусмотрены соответствующие инструменты:

График

В области отображения графика находятся элементы:

1. Временная шкала с превью графика, которая позволяет указать конкретный диапазон времени для отображения данных из выборки, полученной с сервера.
2. Интерактивная легенда, позволяющая включать и отключать отдельные линии графиков.

Сравнение

Раздел для сравнения конфигураций друг с другом. Содержит следующие элементы:

1. Инструменты для выбора устройства и конфигурации.
2. Область для отображения конфигурации.

Выбор устройства и конфигурации

Для сравнения конфигураций устройств нажмите кнопку "Выберите устройство". Установите флаг напротив необходимого устройства:

Нажмите "Выберите конфигурацию". Установите флаг напротив необходимой конфигурации:

Область для отображения конфигурации

После выбора двух конфигураций они сопоставляются друг с другом, и различия отмечаются цветом:

ПО

Раздел, позволяющий добавлять, удалять и просматривать прошивки устройств.

В рабочей области расположены следующие элементы:

1. Кнопки для добавления и удаления файлов ПО.
2. Таблица прошивок, добавленных в систему.

Добавление новой прошивки

При нажатии на кнопку добавления новой прошивки открывается диалоговое окно со следующими элементами:

1. Выберите файл ПО — открыть диалоговое окно для выбора файла на компьютере пользователя.
2. Версия — номер прошивки в принятом у вендора формате. Формат для прошивок ELTEX: 'X.X.X build X'.
3. Серия — серия устройств (модельный ряд).
4. Описание — комментарий к загружаемому файлу.
5. Отменить — закрыть окно без сохранения изменений.
6. Загрузить — кнопка для начала загрузки. Неактивна, пока не заполнены все требуемые поля.

Обновить группу устройств

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

Устройства 

На этом шаге происходит выбор группы устройств, над которыми будут выполняться дальнейшие действия. Для этого используются две таблицы:

1. Таблица, содержащая список всех устройств данной модели.
2. Таблица выбранных устройств, которые будут обновлены.

При выборе первого устройства в верхней таблице (1) устройства других моделей автоматически отфильтровываются и становятся недоступными для выбора. Все выбранные устройства добавляются в нижнюю таблицу (2).

Выбор прошивки

На этом шаге нужно выбрать прошивку, которая будет загружена на выбранные ранее устройства, установив флаг напротив неё:

Установка расписания

Позволяет настроить время начала и завершения выполнения задачи.

Предлагаемые опции:

1. Начать в ближайшее время — поставить задачи в очередь планировщика сразу после создания. Начало выполнения будет зависеть от загруженности планировщика. Снятие этого флага позволяет установить начало окна проведения операции обновления.
2. Не запускать новые подзадачи после указанного времени — позволяет ограничить окно проведения операции обновления, запрещая запуск дополнительных задач. При этом выполненные операции не будут отменены, но устройства, для которых обновление не было запущено, останутся без обновления.
3. Стратегия:
   • Параллельно — одновременный запуск с использованием всех имеющихся обработчиков.
   • Последовательно — обновление по порядку, с использованием одного обработчика.

При выборе опций "Начать в ближайшее время" и "Не запускать новые подзадачи после указанного времени" отображаются инструменты выбора даты и времени начала и завершения обновления:

Применить

На данном шаге на экране отображаются все ранее указанные параметры:

После нажатия кнопки "Применить" будет создана задача, выполнение которой начнется в указанное время.

Групповое конфигурирование

Раздел для создания и применения шаблонов конфигурации на группу устройств. Интерфейс содержит две вкладки:

• Запуск — для создания задачи применения конфигурации на группу устройств.
• Шаблоны — интерфейс создания и управления шаблонами конфигураций.

Шаблоны

Интерфейс для создания и редактирования шаблонов конфигурации включает в себя список шаблонов конфигураций (1) и область редактирования шаблона (2).

Создание шаблона

Для создания шаблона укажите его название в соответствующем поле:

После указания имени новый пустой шаблон появится в списке шаблонов. В области редактирования справа задайте его содержимое:

После этого сохраните изменения, нажав на кнопку "Сохранить".

Запуск

Раздел предназначен для создания задачи группового конфигурирования. Представляет собой последовательность из 4 шагов:

1. Выбор устройств
2. Выбор шаблона
3. Установка расписания
4. Применить

Выбор устройств

На этом шаге необходимо выбрать, к каким устройствам будет применен шаблон конфигурации. Интерфейс содержит две таблицы: в верхней отображаются все доступные для управления устройства, в нижней показаны выбранные устройства для создания задачи.

Выбор шаблона

Раздел для выбора шаблона конфигурации. В левой части отображается таблица существующих в системе шаблонов (1), в правой части отображается содержимое выбранного шаблона (2).

Установка расписания

Позволяет настроить время начала и завершения выполнения задачи.

Предлагаемые опции:

1. Начать в ближайшее время — поставить задачи в очередь планировщика сразу после создания. Начало выполнения будет зависеть от загруженности планировщика. Снятие этого флага позволяет установить начало окна проведения операции обновления.
2. Не запускать новые подзадачи после указанного времени — позволяет ограничить окно проведения операции обновления, запрещая запуск дополнительных задач. При этом выполненные операции не будут отменены, но устройства, для которых обновление не было запущено, останутся без обновления.
3. Стратегия:
   • Параллельно — одновременный запуск с использованием всех имеющихся обработчиков.

Последовательно — обновление по порядку, с использованием одного обработчика.

Применить

В интерфейсе резюмируются ранее настроенные параметры расписания, отображаются выбранный шаблон и список устройств.

Инициализация устройств

Раздел для автоматического обновления и конфигурирования устройств (ZTP – Zero Touch Provisioning).

Интерфейс содержит три вкладки:

1. Настройки DHCP — для настройки DHCP-сервера.
2. Привязки — для создания привязки инициализации – сущности, в которой хранится информация о параметрах ожидаемого устройства.
3. Состояние инициализации — текущее состояние инициализации устройства в системе и журнал предыдущих состояний.

Настройки DHCP

На данной вкладке располагаются настройки для конфигурирования DHCP-сервера. 

1. Вкл./выкл. DHCP-сервера.
2. Сохранение состояния вкл./выкл. (п.1).
3. Начальный адрес IP-диапазона DHCP-пула.
4. Конечный адрес IP-диапазона DHCP-пула.
5. Префикс сети DHCP-пула.
6. Шлюз по умолчанию, который будет выдан устройству, пришедшему за DHCP.
7. Сохранение настроек пп. 3 - 6.
8. Сброс настроек пп. 3 - 6.

Привязки

На данной вкладке можно увидеть список всех привязок, а также создать, отредактировать или удалить привязку.

При нажатии на кнопку "Создать" или "Редактировать" открывается диалоговое окно редактирования привязки:

1. МАС-адрес ожидаемого целевого устройства. Когда устройство с данным МАС появится в сети, для него запустится процедура автоматического конфигурирования.
2. IP-адрес, который будет выдан данному устройству.
3. Группа, куда данное устройство будет помещено после добавления в систему.
4. Модель устройства.
5. Версия прошивки, на которую устройство будет автоматически обновлено.
6. Конфигурация, которая будет применена к устройству.

Состояние инициализации

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

1. В левой части экрана отображается таблица с привязками и их текущими статусами.
2. По клику на привязку из п.1 в правой части экрана открывается журнал с логами по данной привязке, в котором можно поэтапно отследить процесс инициализации соответствующего устройства.

Задачи

В разделе отображается таблица с задачами, выполняемыми в системе от имени пользователя. Периодические системные задачи, такие как синхронизация устройств, по умолчанию скрыты. Их можно отобразить, нажав "Показать" в последнем столбце таблицы.

Таблица состоит из следующих полей:

• Статус — текущий статус выполнения задачи.
• Тип — суть задачи.
• Описание — параметры, с которыми задача была запущена.
• Дата создания — дата и время создания задачи.
• Дата запуска — дата и время запуска задачи в активную работу. Может не совпадать с датой создания, т.к. задача может находиться в очереди обработчика.
• Дата завершения — дата и время завершения работы над задачей. При этом задача может завершиться успешно или не успешно.
• Лог — открыть журнал выполнения задачи из Ansible.
• Подзадачи — задачи для работы над каждым отдельным устройством. При отображении таблицы задач все подзадачи скрыты, и отображается только родительская задача с интегральным статусом. Эта кнопка используется для отображения всех подзадач для групповой операции.

События

Отображает список событий, произошедших в системе. Важные события, сообщающие о проблемах, выделяются красным цветом, информационные — зеленым.

Настройки

Раздел общих настроек системы. Содержит вкладки:

1. Доступ
2. Пользователи
3. Роли
4. Лицензия
5. Резервное копирование
6. Определение статусов устройств

Доступ

Интерфейс для настройки параметров по умолчанию для доступа к устройствам. 

Настройки разделены на четыре группы:

1. SSH и SFTP — используются для управления устройствами и передачи файлов на устройства.  Для настройки доступны логин и пароль.
2. SNMP — используется для мониторинга устройств и получения инвентарных данных. Для настройки доступно read community.
3. network — настройки определения сетевой доступности устройства. Проверка может выполняться по протоколу ICMP ("обычный пинг") и проверкой установки TCP-соединения (более быстрый способ). Во втором случае дополнительно необходимо указать, на какой порт будет устанавливаться соединение.
4. SNMP COMMUNITY-RO — определение community для сбора метрик с устройств по SNMP. Для этого используется отдельный механизм опроса, настройки которого возможны только глобально для всей системы.

Пользователи

Раздел для управления учетными записями пользователей системы.

1. Кнопки добавления и удаления пользователей.

2. Таблица пользователей.

   Для редактирования существующей учетной записи нужно дважды кликнуть левой кнопкой мыши по соответствующей строке.

Создание новой учетной записи 

При нажатии кнопки "Добавить" откроется диалоговое окно, в котором необходимо указать параметры для новой учетной записи:

1. Атрибуты учетной записи (обязательные поля отмечены знаком "*"):
   
   • Логин и пароль — используются для авторизации в системе.
   • Роль — определяет набор привилегий, доступных пользователю в системе.
   • Фамилия, Имя, Отчество — необходимы для идентификации человека, которому принадлежит учетная запись.
   • E-mail — адрес для отправки уведомлений пользователю. 
2. Группы устройств и системных объектов, к которым пользователю будет предоставлен доступ.
3. Кнопки отмены и сохранения.

Добавление групп для пользователя

Элементы интерфейса окна добавления группы:

1. Строка навигации — отображает текущую выбранную группу. Именно эта группа будет сохранена в учетную запись пользователя после нажатия кнопки "Добавить".

2. Таблица вложенных групп — позволяет выбрать одну из дочерних групп и перейти дальше по дереву.

   Для возвращения в родительскую группу кликните по ее названию в строке навигации.

3. Кнопки отмены и сохранения.

Роли

Интерфейс для управления ролями пользователей системы.

1. Кнопки для добавления и удаления ролей.
2. Таблица ролей.

Предустановленный набор ролей

В систему по умолчанию добавлено три роли:

1. SuperAdmin — роль для управления системой ECCM. Привилегии: управление пользователями, ролями. Управление глобальными настройками доступа к устройствам. Также доступны все возможности, доступные другим ролям.
2. Administrator — роль для специалистов, пользующихся системой для настройки оборудования. Привилегии: управление оборудованием (ввод/вывод устройств в работу, конфигурация, обновление, перезагрузка), управление группами устройств. Также доступны возможности, предоставленные оператору.
3. Operator — роль для осуществления мониторинга работы оборудования. Привилегии: просмотр данных мониторинга (состояние устройств, статистика, аварии, отчеты).

Создание новой роли

1. Название роли.
2. Описание — краткое пояснение, для кого и для чего предназначена роль.
3. Набор привилегий, доступных пользователю в этой роли. Пользователь может применять свои привилегии ко всем устройствам и объектам, которые находятся в его группах.
4. Кнопки отмены и сохранения.

Таблица привилегий

Лицензия

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

1. id — уникальный номер лицензии.
2. Издатель — название компании или имя сотрудника, выпустившего лицензию.
3. Получатель — название организации, приобретающей лицензию.
4. Дата издания — дата генерации лицензии.
5. Дата истечения — дата, после которой лицензия считается недействительной. После наступления этой даты доступ к управлению устройствами будет ограничен.

Описание интерфейса 

1. Инструменты управления лицензиями:
   • Загрузить — загрузить на сервер новый лицензионный файл.
   • Экспортировать — получить файл активной лицензии.
2. Информация об установленной в систему лицензии: основные данные и суммарное количество поддерживаемых моделей устройств.
3. Список моделей и количество единиц оборудования каждой модели, которое поддержано в лицензии.

Загрузка новой лицензии

После нажатия кнопки "Загрузить" будет открыто системное окно, в котором нужно выбрать новый файл с лицензией и загрузить его на сервер. После этого ECCM произведет анализ загруженной лицензии и откроет окно для сравнения новой лицензии с активной.

Элементы интерфейса:

1. Название загруженного файла.
2. Информация об активной лицензии.
3. Информация о новой лицензии.
4. Таблица для сравнения количества поддерживаемых устройств.
5. Кнопки для отмены и подтверждения действия.

Если новая лицензия устарела или не поддерживает работу всех добавленных в систему устройств, при ее применении будет отображена ошибка.

Резервное копирование

Раздел предназначен для создания копий (экспорта) списка устройств из системы в файл типа csv, а также для импорта списков устройств в систему. 

Для экспорта списка устройств нажмите кнопку "Экспорт устройств": файл будет скачан браузером.

Формат файла экспорта/импорта:

GROUP;IP;MODEL
eccm/group1/;172.24.0.8;ESR-1000
eccm/group1/;172.24.0.7;ESR-100
eccm/group1/;172.24.0.6;ESR-20
eccm/group1/;172.24.0.5;ESR-10
eccm/group1/;172.24.0.9;ESR-1200

где:

GROUP — группа, в которой находилось, или куда нужно поместить устройство,

IP — IP-адрес устройства,

MODEL — модель устройства.

В качестве разделителя используется символ точка с запятой ';'.

Импорт устройств

Для импорта устройств нажмите кнопку "Импорт устройств" и выберите подходящий файл для импорта. Файл будет загружен в систему и обработан, после чего откроется диалоговое окно добавления устройств:

1. Счетчики устройств — показывают, сколько всего устройств было извлечено из файла и сколько из них имеет проблемы в описании. Если в списке есть устройства с проблемами, добавление списка будет невозможным: его необходимо отредактировать и исправить/удалить некорректные данные.
2. Показывать только невалидные (устройства) — включить фильтр списка устройств для отображения некорректных записей. 
3. Список устройств —  таблица устройств, отображающая данные, полученные из импортированного файла. 
4. Кнопки отмены и добавления.

Определение статусов устройств

Раздел для настройки функции проверки статуса доступности устройств по протоколам TCP/ICMP, SNMP.

Форма настроек содержит следующие поля:

• Интервал опроса — параметр, определяющий частоту выполнения опроса устройств по протоколам TCP/ICMP и SNMP.
• Таймаут запросов — время на выполнение опроса.
• Количество повторных попыток — параметр, определяющий число повторных попыток опроса.

И кнопки управления разделом:

• Сохранить — для применения настроек к ECCM.
• Сбросить — для сброса значений до предыдущего сохранённого состояния.