5. Руководство администратора ПО
5.1. Владелец системы (System owner): первое подключение, лицензирование и необходимые начальные действия для обеспечения работы ПО
Описанные в этом разделе действия, осуществляются только Владельцем системы.
5.1.1. Первое подключение к ПО и смена пароля:
после завершения установки наберите в Интернет браузере адрес установленного ПО, полученного от вендора ПО, ответственного за установку ПО. Появится окно подключения к ПО:
введите адрес электронной почты, переданный во время установки персоналу, ответственному за установку ПО, в текстовое поле “Email” (“Адрес электронной почты”) (цифра 1 на рисунке выше);
введите начальный пароль, полученный от персонала, ответственному за установку ПО, после завершения установки, в текстовое поле “Password” (“Пароль”) (цифра 2 на рисунке выше). Этот пароль необходимо сменить после первого подключения;
нажмите на кнопку “Login” (“Подключиться”) (цифра 3 на рисунке выше). Появится окно «New password»(«Смена пароля»):
введите новый пароль в текстовое поле (цифра 1 на рисунке выше). Новый пароль пользователя должен отвечать следующим требованиям:
длина пароля должна быть не менее 8 символов;
пароль должен состоять из букв латинского алфавита (A-z) и арабских цифр (0-9);
буквенная часть пароля должна содержать как строчные, так и прописные (заглавные) буквы;
подтвердите новый пароль в текстовом поле (цифра 2 на рисунке выше);
нажмите на кнопку «Change password» («Изменить пароль») (цифра 3 на рисунке выше). Произойдет смена пароля и автоматический выход из ПО. Появится окно подключения к ПО (рисунок выше):
введите адрес электронной почты, переданный во время установки персоналу, ответственному за установку ПО, в текстовое поле Email (Адрес электронной почты) (цифра 1 на рисунке выше);
введите новый пароль в текстовое поле Password (Пароль) (цифра 1 на рисунке выше);
нажмите на кнопку «Login» («Подключиться») (цифра 3 на рисунке выше).
5.1.2. Лицензирование ПО
После первого успешного подключения к ПО и смены пароля Владельцу системы необходимо ввести лицензию ПО для обеспечения функционирования ПО.
5.1.2.1. Передача клиентского ключа в службу поддержки Разработчика
После подключения к ПО с новым паролем появится окно «License» («Лицензия») (рисунок выше).
Скачайте уникальный для каждой установки клиентский ключ (client key) (цифра 1 на рисунке выше) нажав на кнопку «DOWNLOAD KEY FILE» («Скачать клиентский ключ»).
Скачается файл с названием clientkey.dat. Местоположение скачанного ключа зависит от настроек браузера.
Этот файл необходимо передать в службу поддержки Разработчика с уточнением имени Заказчика по адресу support@tantorlabs.ru.
5.1.2.2. Загрузка и применение лицензии
Служба поддержки Разработчика создаст новую лицензию на основе полученного клиентского ключа и в обратном письме вышлет ее Заказчику.
Сохраните полученный файл лицензии так, чтобы его можно было загрузить в ПО через открытый браузер.
Нажмите кнопку «Browse» («Просмотреть») (цифра 3 на рисунке выше). Откроется окно позволяющее найти и выбрать файл лицензии (зависит от операционной системы):
Выберете файл лицензии и нажмите кнопку «Open» («Открыть») (зависит от операционной системы) (цифра 2 на рисунке выше). Имя файла появится на экране:
Для загрузки и применения лицензии нажмите кнопку «APPLY LICENSE» («Применить лицензию») (цифра 2 на рисунке выше). Появится информационное окно с сообщением статуса применения лицензии:
Далее вам будет необходимо подключиться заново к ПО:
Будет произведено автоматическое отсоединение и появится окно подключения к ПО.
Подключитесь к ПО, используя адрес электронной почты и пароль.
5.1.3. Необходимые начальные действия для обеспечения работы ПО
Минимальные необходимые действия для обеспечения работы ПО:
создание Рабочего пространства (Добавление нового рабочего пространства);
создание записи пользователя (Добавление пользователя) и предоставление ему разрешения на работу с рабочим пространством (Предоставление разрешения на работу с рабочим пространством);
интеграция с каналом оповещения (например канал электронной почты (Добавить новый канал)) и добавления нового правила / критерии для отправки сообщений через этот канал (Добавление правила).
Все действия описаны ниже в документе.
5.2. Рабочие пространства (Workspaces)
5.2.1. Добавление нового рабочего пространства
Добавить новое рабочее пространство может только пользователь с ролью владельца. Рабочее пространство необходимо, прежде чем добавить в него новый инстанс PostgreSQL.
Добавление нового рабочего пространства выполняется в два этапа:
Сначала перейдите на страницу рабочих пространств. На этой странице, нажмите кнопку “NEW WORKSPACE” (“НОВОЕ РАБОЧЕЕ ПРОСТРАНСТВО”) (обозначенную цифрой 1 на рисунке выше).
После того, как вы нажмете эту кнопку, появится всплывающее окно “ADD A NEW WORKSPACE” (“ДОБАВИТЬ НОВОЕ РАБОЧЕЕ ПРОСТРАНСТВО”). Назовите новое рабочее пространство в всплывающем окне (обозначено цифрой 1 на рисунке выше). Поле «Имя» не должно оставаться пустым, имя не должно дублировать другие имена рабочих пространств. Затем нажмите кнопку “Add Workspace” (“Добавить рабочее пространство”) (обозначено цифрой 2 на рисунке выше).
5.2.2. Тайл рабочего пространства
В этом разделе вы узнаете о функциях и индикаторах тайла рабочего пространства.
Обратите внимание на нумерацию на рисунке выше:
Красная линия говорит о том, что в рабочем пространстве есть инстансы PostgreSQL, и что существуют предупреждения, касающиеся одного из инстансов.
Зеленая линия говорит о том, что в рабочей области есть инстансы PostgreSQL, и что нет предупреждении, касающиеся одного из инстансов.
Желтая линия говорит о том, что в рабочей области нет инстансов PostgreSQL, и, следовательно, нет предупреждений.
Название рабочей области написано посередине тайла.
Индикатор инстансов показывает, сколько инстансов добавлено в эту рабочее пространство.
Индикатор предупреждений показывает, сколько открытых предупреждений есть у добавленных инстансов.
Нажатие кнопки с тремя точками вызывает меню со следующими двумя вариантами:
Если вы выберите «Переименовать» («Rename») из списка в меню, то появится окно «RENAME WORKSPACE» («ПЕРЕИМЕНОВАТЬ РАБОЧЕЕ ПРОСТРАНСТВО»). Переименуйте рабочее пространство (обозначено цифрой 1 на рисунке ниже). Поле «Имя» не должно оставаться пустым, имя не должно дублировать другие имена рабочих пространств. Затем нажмите кнопку «Rename Workspace» («Переименовать рабочее пространство») (обозначено цифрой 2 ниже):
Если вы выберите «Delete» («Удалить») из списка меню, появится окно «DELETE WORKSPACE» («УДАЛИТЬ РАБОЧЕЕ ПРОСТРАНСТВО»). Напишите «delete», чтобы удалить рабочее пространство в данном поле (обозначенном цифрой 1 на рисунке ниже). Затем нажмите кнопку «Delete Workspace» («Удалить рабочее пространство»), чтобы удалить рабочее пространство (обозначено цифрой на рисунке 2 ниже):
5.2.3. Верхняя панель и навигационная цепочка (дублирующее меню)
Верхняя панель состоит из нескольких вариантов. Ниже мы обсудим каждый вариант в соответствии с нумерацией, представленной на рисунке:
Опция «навигационной цепочки» поможет вам вернуться на страницу или изменить рабочее пространство. Для проверки возможности этой опции по нумерации ниже:
Щелкните на выпадающий список рядом с именем рабочего пространства (обозначено цифрой 1 на рисунке выше). Это откроет поле со списком и возможностью перехода к другому рабочему пространству (обозначенной цифрой 2 на рисунке выше) или перехода на страницу рабочих пространств, нажав соответствующую кнопку (обозначенную цифрой 3 на рисунке выше);
Остальные элементы в навигационной цепочке действуют как обычное дублирующее меню на любом веб-сайте. Вы можете нажать на любое из них, чтобы перейти на определенную страницу:
Сервис поиска отфильтрует элементы на текущей странице. В этом примере служба поиска отфильтрует рабочие пространства по имени (обозначенному цифрой 1 на рисунке выше);
Символ настройки «cog» (обозначенный цифрой 2 на рисунке выше), доступный только пользователям с ролью владельца, открывает меню со следующими параметрами:
Пользователи (“Users”) - открывает страницу управления пользователями для управления доступом платформе;
Интеграции (“Integrations”) - открывает страницу для управления каналами оповещения: e-mail, Telegram и Slack;
Символ предупреждений «колокольчик» открывает меню со следующими параметрами (обозначенными цифрой 3 на рисунке двумя изображениями выше):
Список предупреждений; при нажатии на предупреждение открывается страница с конкретным предупреждением;
Кнопка «View all» («Просмотреть все»); когда вы нажмете эту кнопку, откроется страница всех предупреждений:
Красный квадрат с начальными буквами (обозначен цифрой 4 на трех изображениях выше) открывает меню пользователя со следующими параметрами:
выбрав опцию «User account» («Учетная запись пользователя»), вы перейдете к учетной записи авторизованного пользователя;
при нажатии на опцию «Subscription Management» («Управление подпиской»), открытой только для пользователю с правами владельца, открывается окно с лицензионным данными;
нажатие кнопки «Logout» («Выйти») приведет к выходу из пользовательского интерфейса платформы.
5.3. Настройки (Configurations)
5.3.1. Пользователи
Напомним, что страница «Пользователи» доступна только пользователю с правами владельца. Эта страница содержит важные параметры, относящиеся к пользователями, а также необходимую функциональность, она поможет вам управлять пользователями:
Мы сосредоточимся на наиболее важных функциях этой страницы и пройдемся по ней в соответствии с рисунком выше:
столбец “IS OWNER” («ВЛАДЕЛЕЦ») (цифра 1 на рисунке выше) указывает, какой пользователь является владельцем (“Yes” («да)» означает пользователя-владельца);
столбец “STATUS” («СТАТУС») (цифра 2 на рисунке выше) указывает, какие пользователи активны;
столбец “MENU” («МЕНЮ») (цифра 3 на рисунке выше) предоставляет функциональные возможности для управления пользователями. Меню может быть трех типов, в зависимости от параметров “IS OWNER” («ВЛАДЕЛЕЦ») и “STATUS” («СТАТУС»).
Пример ниже для пользователя-владельца: этот пользователь всегда активен - обратите внимание на контекстное меню (цифра 1 на рисунке ниже):
Пример ниже для обычного пользователя: этот пользователь активен - обратите внимание на контекстное меню (цифра 1 на рисунке ниже):
Пример ниже для обычного пользователя: этот пользователь отключен. Обратите внимание на контекстное меню (цифра 1 на рисунке ниже):
5.3.1.1. Добавление пользователя
Кнопка “Add new user” (“Добавить нового пользователя”) дает нам возможность добавлять новых пользователей. Добавление пользователя происходит в три этапа, рассмотрим их по рисунку:
Заполните поле имени. Это упростит вам идентификацию пользователя;
Поле электронной почты необходимо для того, чтобы отправить пароль на этот адрес электронной почты и использовать его для входа в службу. Кроме того, в будущем использовать рассылки предупреждений в случае необходимости;
При заполнении всех полей нажмите кнопку “Add new user” (“Добавить нового пользователя”). Если все прошло успешно, появится следующее окно (меню Users):
В меню Users («Пользователи») доступны следующие варианты:
Опция “Open” (“Открыть”) открывает страницу учетной записи для выбранного пользователя. Страница аккаунта рассматривается в другом разделе.
5.3.1.2. Активация пользователя
Опция “Activate” (“Активировать”) активирует пользователя:
Заполните поле словом activate («Активировать»). (цифра 1 на рисунке выше);
Нажмите кнопку “Activate” («Активировать»), чтобы активировать пользователя. (цифра 2 на рисунке выше).
5.3.1.3. Деактивация пользователя
Опция “Suspend” («Деактивировать») отключает выбранного пользователя:
Заполните поле словом suspend («Деактивировать»). (цифра 1 на рисунке выше);
Нажмите кнопку “Suspend” («Деактивировать»), чтобы деактивировать пользователя. (цифра 2 на рисунке выше).
5.3.1.4. Удаление пользователя
Опция “Delete” («Удалить») удаляет выбранного пользователя. Вы можете удалить только деактивированного пользователя:
заполните поле словом delete («Удалить»). (цифра 1 на рисунке выше);
нажмите кнопку “Delete User” («Удалить»), чтобы удалить пользователя. (цифра 2 на рисунке выше).
5.3.1.5. Передача прав владельца
Параметр «Transfer Ownership» («Передача прав владельца») передает права владельца выбранному пользователю. Важно знать, что после передачи прав произойдет автоматический выход из системы:
Заполните поле словом transfer («Передать»). (цифра 1 на рисунке выше);
Нажмите кнопку «Передать», чтобы передать права владельца пользователю. (цифра 2 на рисунке выше).
5.3.1.6. Учетная запись пользователя
5.3.1.6.1. Изменение имени
Вы можете изменить имя пользователя:
Внесите новое имя. (обозначено цифрой 1 на изображении ниже);
Установите флажок, чтобы подтвердить имя. (обозначено цифрой 2 на изображении ниже).
5.3.1.6.2. Типы меню
Страница учетной записи в меню пользователя может быть двух типов:
Для администратора рабочего пространства/ пользователя-зрителя рабочего пространства:
Для владельца системы:
5.3.1.6.3. Сброс пароля
Опция “Reset password” (“Сбросить пароль”) бывает двух типов:
Автоматически, установите флажок (обозначенный цифрой 1 на изображении выше) и нажмите кнопку “Reset” (“Сброс”) (обозначено цифрой 2 на изображении выше).
Вручную, снимите флажок (обозначенный цифрой 1 на изображении выше), создайте пароль в соответствии с заданными требованиями, и нажмите кнопку “Reset” (“Сброс”) (обозначено цифрой 2 на изображении выше).
После этого появится окно, в котором вы можете просмотреть (цифра 1 вверху) или скопировать (цифра 2 вверху) пароль.
5.3.1.6.4. Предоставление разрешения на работу с рабочим пространством
Параметр «Grant WS Permission» («Предоставить разрешение на рабочее пространство») дает пользователю права на рабочее пространство:
Первым шагом здесь является выбор рабочего пространства. (обозначено цифрой 1 на изображении выше);
Вторым (обозначенный цифрой 2 на изображении выше) - выбрать, какие права предоставить; есть выбор: администратор рабочего пространства или пользователя-зрителя рабочего пространства;
Как только вы закончите, нажмите кнопку «GRANT ROLE» («Предоставить разрешение»).
5.3.1.6.5. Отозвание разрешения на работу с рабочим пространством
Кнопка («Отозвать роль») позволяет лишить пользователя прав на работу с рабочим пространством.
Для этого заполните данное поле (обозначенное цифрой 1 на изображении выше) словом revoke и нажмите кнопку «Revoke role»:
Для этого заполните данное поле (обозначенное цифрой 1 на изображении выше) словом revoke (отозвать) и нажмите кнопку «Revoke role» («Отозвать разрешение»).
5.3.2. Интеграция со службами сообщений (Integrations)
5.3.2.1. Telegram
Служба интеграции была создана для уведомления пользователей о любых обнаруженных проблемах.
На странице Telegram будет список каналов для отправки сообщений, а также функционал для создания (номер 1 на рисунке выше) и управления (номер 2 на рисунке выше) каналами. Давайте рассмотрим функции в соответствии с нумерацией на рисунке.
5.3.2.1.1. Добавить новый канал
Кнопка “Add new channel” (“Добавить новый канал”) открывает окно для добавления нового канала. Как получить идентификатор группы Telegram и создать токен бота, вы можете найти здесь???. Чтобы добавить новый канал, выполните следующие действия:
Введите идентификатор группы Telegram в данное поле (обозначено цифрой 1 на рисунке выше);
Введите токен бота Telegram в данное поле (обозначено цифрой 2 на рисунке выше). Бот должен уже быть в группе Telegram с разрешением на запись;
Нажмите кнопку “Add new channel” («Добавить новый канал»), чтобы добавить канал (обозначен цифрой 3 на рисунке выше).
5.3.2.1.2. Деактивация канала
Опция “Suspend” (“Деактивировать”) приостанавливает использование выбранного канала для передачи сообщений:
Заполните поле словом suspend (приостановить). (обозначено цифрой 1 на рисунке выше);
Нажмите кнопку “Suspend” (“Деактивировать”), чтобы отключить передачу сообщений через канал. (обозначено цифрой 2 на рисунке выше).
5.3.2.1.3. Активация канала
Опция “Activate” (“Активировать”) возобновляет использование выбранного канала для передачи сообщений:
Заполните поле словом activate (активировать). (обозначено цифрой 1 на рисунке выше);
Нажмите кнопку “Activate” («Активировать»), чтобы возобновить передачу сообщений через канал. (обозначено цифрой 2 на рисунке выше).
5.3.2.1.4. Удаление канала
Опция “Delete” («Удалить») удаляет выбранный канал:
Заполните поле словом delete (удалить). (цифра 1 на рисунке выше);
Нажмите кнопку “Delete channel” («Удалить канал») , чтобы удалить канал. (цифра 2 на рисунке выше).
5.3.2.1.5. Управление каналом Telegram
Персональная страница канала Telegram предоставляет некоторые функции для управления каналом. Давайте рассмотрим эти варианты в соответствии с нумерацией, представленной на рисунке ниже:
Поле, обозначенное цифрой 1 на рисунке выше, позволяет изменить идентификатор группы;
Меню, обозначенное цифрой 2 на рисунке выше, предоставляет вам следующие опции:
5.3.2.1.5.1. Установить токен
Опция “Set Token” («Установить токен») позволяет вам изменить токен Telegram:
Заполните поле новым токеном, обозначенным цифрой 1 на рисунке выше;
Нажмите кнопку “Set Token” («Установить токен») , обозначенную цифрой 2 на рисунке выше, чтобы завершить изменения.
5.3.2.1.5.2. Тестовое соединение
Опция «Test Connection» («Проверить соединение») отправляет тестовое сообщение в канал Telegram. Появляется окно сообщения со статусом отправления:
5.3.2.1.5.3. Добавление правила
Опция “Add Rule” («Добавить правило») добавляет новое правило / критерий для отправки сообщений:
Выберите рабочее пространство (обозначено цифрой 1 на рисунке выше);
Выберите уровень важности тревожного предупреждения - ПРОБЛЕМА или ПРЕДУПРЕЖДЕНИЕ (обозначено цифрой 2 на рисунке выше);
Нажмите кнопку “Add Rule” («Добавить правило») (обозначено цифрой 3 на рисунке выше). После добавления правила вы будете получать соответствующие уведомления в выбранном канале Telegram.
5.3.2.1.5.4. Удаление правила
Кнопка “Remove rule” («Удалить правило») позволяет удалить правило / критерии для передачи сообщений через канал (обозначено цифрой 1 на рисунке ниже):
Заполните поле словом remove (удалить) (обозначено цифрой 1 на рисунке выше);
Нажмите кнопку “Remove rule” («Удалить правило»), чтобы удалить правило (обозначено цифрой 2 на рисунке выше).
5.3.2.1.5.5. Деактивировать / Активировать канал
Опции “Suspend» / «Activate» («Деактивировать» / «Активировать») дублируют функциональность меню страницы списка каналов.
5.3.2.2. Электронная почта
На странице «Mail» («Электронная почта») будет список каналов электронной почты для отправки сообщений, а также функциональные возможности для создания каналов и управления ими. Давайте рассмотрим функциональные возможности в соответствии с нумерацией на рисунке ниже:
Кнопка «Add new channel» («Добавить новый канал») (цифра 1 на рисунке выше) открывает окно для добавления нового канала;
Кнопка “Menu” («Меню») (цифра 1 на рисунке выше) позволяет управлять выбранным каналом. В этом меню доступны три опции:
Опция “Open” («Открыть») открывает страницу выбранного канала;
Опция “Suspend” («Деактивировать») приостанавливает использование выбранного канала для передачи сообщений;
Опция “Delete” («Удалить») удаляет выбранный канал.
5.3.2.2.1. Добавить новый канал
Чтобы добавить новый канал, следуйте инструкциям ниже:
Введите адрес электронной почты в данное поле. (цифра 1 на рисунке выше);
Нажмите кнопку «Add new channel» («Добавить новый канал»). (цифра 2 на рисунке выше).
5.3.2.2.2. Деактивация канала
Опция «Деактивировать» приостанавливает использование выбранного канала для передачи сообщений:
Заполните поле словом (приостановить). (обозначено цифрой 1 на рисунке выше);
Нажмите кнопку «Деактивировать», чтобы отключить передачу сообщений через канал. (обозначено цифрой 2 на рисунке выше).
5.3.2.2.3. Активация канала
Опция “Activate” (“Активировать”) возобновляет использование выбранного канала для передачи сообщений:
Заполните поле словом activate (активировать). (обозначено цифрой 1 на рисунке выше);
Нажмите кнопку “Activate” («Активировать»), чтобы возобновить передачу сообщений через канал. (обозначено цифрой 2 на рисунке выше).
5.3.2.2.4. Удаление канала
Опция “Delete” («Удалить») удаляет выбранный канал:
Заполните поле словом delete (удалить). (цифра 1 на рисунке выше);
Нажмите кнопку “Delete channel” («Удалить канал») , чтобы удалить канал. (цифра 2 на рисунке выше).
5.3.2.2.5. Управление каналом электронной почты
Персональная страница канала электронной почты предоставляет некоторые функции для управления каналом. Давайте рассмотрим эти варианты в соответствии с нумерацией, представленной на рисунке ниже:
Поле, обозначенное цифрой 1 на рисунке выше, позволяет изменить адрес электронной почты. Меню, обозначенное цифрой 2 на рисунке выше, предоставляет вам следующие опции:
5.3.2.2.5.1. Отправить тестовое письмо
Опция «Send Test Mail» («Отправить тестовое письмо»)отправляет тестовое сообщение на канал электронной почты. Появляется окно сообщения со статусом отправления:
5.3.2.2.5.2. Добавление правила
Опция “Add Rule” («Добавить правило») добавляет новое правило / критерий для отправки сообщений:
Выберите рабочее пространство (обозначено цифрой 1 на рисунке выше);
Выберите уровень важности тревожного предупреждения - ПРОБЛЕМА или ПРЕДУПРЕЖДЕНИЕ (обозначено цифрой 2 на рисунке выше);
Нажмите кнопку “Add Rule” («Добавить правило») (обозначено цифрой 3 на рисунке выше). После добавления правила вы будете получать соответствующие уведомления в выбранном канале электронной почты.
5.3.2.2.5.3. Удаление правила
Кнопка “Remove rule” («Удалить правило») позволяет удалить правило / критерии для передачи сообщений через канал (обозначено цифрой 1 на рисунке ниже):
Заполните поле словом remove (удалить) (обозначено цифрой 1 на рисунке выше);
Нажмите кнопку “Remove rule” («Удалить правило»), чтобы удалить правило (обозначено цифрой 2 на рисунке выше).
5.3.2.2.5.4. Деактивировать / Активировать канал
Опции “Suspend» / «Activate» («Деактивировать» / «Активировать») дублируют функциональность меню страницы списка каналов.