...

|| DeviceType | Облачный сервис мониторинга и управления конфигурациями "ELTEX" |
|| DocTitleAdditional | Руководство по эксплуатации |
|| DeviceName | ECCM |
|| DocTitleAdditional | Руководство пользователя |
|| fwversion | 0.6 |
|| username | eccm |
|| password | eccm |

Введение

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

...

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

Image Modified

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

...

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

Image RemovedImage Added

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

Image Modified

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

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

Image Modified

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

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

Image Modified

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

...

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

Image Modified

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

...

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

Image Modified

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

...

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

Image Modified

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

...

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

Image Modified

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

...

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

Image Modified

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

...

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

Image Modified

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

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

Image Modified

Адаптер

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

Image Modified

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

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

Image Modified

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

Image Modified

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

...

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

Image Modified

Задачи

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

Image Modified

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

...

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

Image Modified

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

...

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

Image Modified

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

...

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

Image Modified

Image RemovedImage Added

График

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

Image Modified

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

...

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

Image Modified

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

...

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

Image Modified

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

...

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

Image Modified

Устройства 

...

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

Image Modified

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

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

Image Modified

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

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

Image Modified

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

...

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

Image Modified

Применить

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

Image Modified

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

...

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

Image Modified

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

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

Image ModifiedImage Modified

...

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

Image Modified

Задачи

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

Image Modified

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

...

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

Image Modified

Настройки

Раздел, содержащий общие настройки системы.

Содержит две вкладки:

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

Image Modified

Доступ

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

Image Modified

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

...

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

Image Modified

Чтобы добавить новую группу, необходимо указать ее название и нажать кнопку "Создать".

Для групп типа "DEVICES" отображается список устройств, находящихся в группе (1), кнопка для добавления устройств (2) и кнопка для удаления устройств из группы (3).

Image Modified

...

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

Image Modified