Введение

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

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

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

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

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

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

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

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

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

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

Фильтры поддерживают использование логических операторов OR, AND, а также группировку выражений с помощью скобок:

При поиске данных по полям с численными значениями можно использовать операторы '==', '>', '<', как показано в строке Фильтр на рисунке выше.

Для строковых значений поддерживается только оператор '==', но имеется возможность заменять неопределенную часть выражения символом '*':

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

Здесь расположены виджеты, отображающие данные о состоянии системы:

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

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

Группы

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

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

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

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

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

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

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

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

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

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

1. Ручной способ добавления устройств позволяет добавить в систему конкретный хост или список хостов, IP-адреса которых заранее известны. При этом устройства сразу будут добавлены в текущую группу, а после этого система автоматически определит их тип и, если тип устройства поддерживается системой, начнет обслуживание. Если устройство не поддерживается или недоступно, и данные о нем получить невозможно, оно останется в системе со статусом 'OTHER'.
2. Автоматическое обнаружение устройств. В этом сценарии в системе создается правило для обнаружения устройств, которое будет сканировать заранее заданный диапазон IP-адресов по протоколу SNMP. Когда в этом диапазоне будет обнаруживаться устройство поддерживаемого системой типа, информация о нем будет сохраняться в системе, но оно не будет автоматически помещено в группу. Такие устройства можно увидеть в разделе "Устройства" или добавить их в группу вручную.

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

1. Поле для ввода списка IP-адресов, которые следует добавить в систему. Адреса разделяются пробелом или переводом строки (Enter).
2. Кнопки подтверждения и отмены действия.

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

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

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

Устройства

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

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

1. ID — порядковый номер устройства в системе управления, присваивается при добавлении устройства в систему. Нумерация начинается от 100, каждый номер уникален и не может быть использован повторно.
2. Серийный номер — комбинация цифр и букв, которая вычитывается с устройства по SNMP и хранится в базе данных.
3. IP — IP-адрес устройства в сети управления устройствами (каждое устройство имеет уникальный IP-адрес). Отображается в виде ссылки, по которой можно перейти на страницу управления устройством.
4. Hostname — имя хоста, вычитывается с устройства по SNMP и хранится в базе данных.
5. MAC — MAC-адрес устройства, вычитывается с устройства по SNMP и хранится в базе данных.
6. Серия — название модельного ряда, вычитывается с устройства по SNMP и хранится в базе данных.
7. Модель — название модели, вычитывается с устройства по SNMP и хранится в базе данных.
8. Версия — номер прошивки, установленной на устройстве, вычитывается с устройства по SNMP и хранится в базе данных.
9. Статус — статус доступности устройства, проверяется периодическим ICMP-пингом с сервера на устройство.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Адаптер

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

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

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

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

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

События

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

Задачи

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

1. Статус — текущий статус выполнения задачи.
2. Тип — суть задачи.
3. Описание — параметры, с которыми задача была запущена.
4. Создано в — дата и время создания задачи.
5. Запущено в — дата и время запуска задачи в активную работу. Может не совпадать с датой создания, т.к. задача может находиться в очереди обработчика.
6. Остановлено в — дата и время завершения работы над задачей. При этом задача может завершиться успешно или не успешно.
7. Лог — открывает журнал выполнения задачи из Ansible.

Мониторинг

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

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

Типы данных 

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

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

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

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

График

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

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

ПО

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

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

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

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

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

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

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

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

Устройства 

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

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

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

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

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

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

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

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

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

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

Применить

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

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

Сравнение

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

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

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

Выберите устройства и их конфигурации с помощью кнопок "Выберите устройство" и "Выберите конфигурацию":

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

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

Задачи

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

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

1. Статус — текущий статус выполнения задачи.
2. Тип — суть задачи.
3. Описание — параметры, с которыми задача была запущена.
4. Создано в — дата и время создания задачи.
5. Запущено в — дата и время запуска задачи в активную работу. Может не совпадать с датой создания, т.к. задача может находиться в очереди обработчика.
6. Остановлено в — дата и время завершения работы над задачей. При этом задача может завершиться успешно или не успешно.
7. Лог — открывает журнал выполнения задачи из Ansible.
8. Подзадачи — задачи для работы над каждым отдельным устройством. При отображении таблицы задач все подзадачи скрыты, и отображается только родительская задача с интегральным статусом. Эта кнопка используется для отображения всех подзадач для групповой операции.

События

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

Настройки

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

1. Доступ
2. Группы

Доступ

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

1. Выбор настраиваемого адаптера:
   1. ESR Ansible — адаптер, применяемый для устройств ESR от Eltex.
   2. Generic — адаптер для устройств других производителей.
2. ssh — логин и пароль для доступа к устройствам по протоколу SSH.
3. sftp — логин и пароль для доступа к устройствам по SFTP.
4. Кнопки для сохранения и сброса настроек.

Настройки протоколов идентичны для обоих адаптеров.

Мониторинг

В этом разделе находятся настройки взаимодействия с устройствами по протоколу SNMP.

Обнаружение

В разделе доступны следующие элементы:

1. Диапазон обнаружения устройств — диапазон, в котором будет проводиться сканирование устройств. Может принимать следующие форматы:
   

   Один IP-адрес: 192.168.1.33
   Диапазон IP-адресов: 192.168.1.1-255

   Несколько диапазонов и адресов могут быть записаны одной строкой через запятую: 192.168.1.33,192.168.2.1-255,172.16.0.1-255
2. Интервал опроса устройств — промежуток времени между повторным опросом
3. Активировано — статус правила. Если флаг "Активировано" не установлен, то обнаружение будет выключено.
4. Кнопки сохранения и отмены изменений.

Опрос устройств выполняется по протоколу SNMP. Для обнаружения устройств необходимо, чтобы на них был настроен доступ для community 'public'. Его значение можно изменить в разделе SNMP.

SNMP

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

1. Строка community.
2. Кнопка для сохранения изменений.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Роли

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

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

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

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

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

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

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

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