Сервер приложения — различия между версиями

Текущая версия на 10:31, 30 июля 2021

Сервер приложения FireFly

Сервер приложений FireFly обеспечивает взаимодействие программы Интегра Планета Земля и СУБД Postgres с целью повышения отказоустойчивости и балансировки нагрузки.

Примечание: После установки в Windows или Ubuntu серверной части Интегра Планета Земля и перезапуска компьютера, FireFly запустится автоматически с теми параметрами, которые были заданы при установке сервера. Если же какой-нибудь из портов по умолчанию 8080 или 443 будет занят, то в консоли появится ошибка.

Подготовка к работе.

В данном разделе будет описан минимум необходимых манипуляций для старта и использования FireFly (далее FF).

Установка.

Для ручной установки достаточно скопировать FF в любое удобное место на компьютере. А затем добавить его в автозагрузку. В случае ручного запуска, можно создать ярлык. Файл: firefly.bat

Общая настройка

Примечание: файл config.json в корне FF Для изменения порта или других параметров нужно перейти в папку C:\Program Files (x86)\Integra-S\FireFly, в ней выбрать папку с названием вашего сервера интеграции (оборудования. Далее открываем файл настройки config. В нем находим строки:

"acuario2": {
"dsn": "dbname=office host=localhost port=5432 user=postgres password=acuario",
"poolSize": 3
},

dbname - название базы сервера интеграции(оборудования).

host - ip адрес сервера postgres(если локальный, то можно оставить localhost, хоть и не рекомендуется).

port - порт базы postgres.

user - логин администратора базы postgres.

password - пароль администратора базы postgres.

"integraplanetearth": {
"dsn": "dbname=integraplanetearth host=localhost port=5432 user=postgres password=acuario",
"poolSize": 3
},

dbname - название базы сервера земли.

host - ip адрес сервера postgres(если локальный, то можно оставить localhost, хоть и не рекомендуется).

port - порт базы postgres. Если указать 0 порт, то подключение к данной базе осуществляться не буде.

user - логин администратора базы postgres.

password - пароль администратора базы postgres.

"use_ssl": false,
"wamp": {
"port": 8080
},
"http": {
"root_staticfiles_directory": "./wamp",
"port": 443

wamp порт - это порт для подключения мсс и событий в Интегра Планета Земля.

http порт — это порт для открытия страницы сайта настройки FireFly.

Обновление FireFly.

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

create_DB_and_Schemas .bat – создание и обновление схем, относящихся к базе интеграции (оборудования).Внимание! При запуске файла будут затерты все ранее настроенные пользователи, останутся только пользователи по умолчанию.

update_Schemas.bat – обновление имеющихся схем, относящихся к базе интеграции (оборудования). Ранее настроенные пользователи затронуты не будут.

Примечание: Указанные командные файлы должны быть настроены в соответствии с ниже приведенным изображением.

Подключение к веб интерфейсу

Чтобы зайти на интерфейс настройки FireFly, нужно в браузере ввести ip адрес компьютера, где запущена консоль FireFly и порт http , в формате: xxx.yyy.zzz.www:qqq

Откроется окно, где нужно ввести параметры для подключения к FireFly:

• ip aдрес и порт wamp, с которыми запущена консоль FF

• по умолчанию логин: admin. пароль: Integra2015

Нажатие на "Вход" откроет окно, в котором будут показаны все пользователи в программе FireFly.

Примечание: если в интерфейсе 5 вкладок, а не 4, то это FF старой версии и там работают только вкладки Редактор пользователей, Редактор ролей и Настройка Синхронизации. Другие вкладки трогать не рекомендуется.

Интерфейс

Сразу же после авторизации загрузится веб интерфейс:

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

Редактор пользователей.

- Вкладки, переключающие доступ к функциям.

- Список пользователей.

- Переключение страниц.

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

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

- Выход из интерфейса.

- Поиск пользователя.

Добавление пользователя.

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

- Настройки логина и пароля.

- Разрешения управления другими пользователями.

- Учётная и контактная информация о пользователе

- Назначение ролей пользователю.

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

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

Редактирование пользователей.

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

Удаление пользователей.

Для того, чтобы удалить пользователя, кликните по нему ЛКМ. После чего нажмите кнопку удаления пользователя . После чего появится уведомление:

Отмена - прерывает удаление пользователя.

Применить - подтверждение удаления пользователя. Это действие не обратимо.

Редактор ролей.

При открытии вкладки, окно примет следующий вид:

- Список ролей.

- Добавить роль.

- Удалить роль.

- Поиск роли.

Добавление роли.

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

- Имя роли и доступ к конфигурации правил роли.

- Подключение пользователей к данной роли.

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

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

Добавление правила.

Есть три вида действий над правилами, за которые отвечают соответствующие кнопки:

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

Примечание: правила подробнее будут описаны далее.

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

Редактирование роли.

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

Удаление роли.

Для того, чтобы удалить роль, кликните по нему ЛКМ. После чего нажмите кнопку удаления роли после чего появится уведомление:

Отмена - прерывает удаление роли.

Применить - подтверждение удаления роли. Это действие не обратимо.

Настройки синхронизации.

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

Наименование объекта. - Имя назначенное для плана.

Адрес подключения. - Адрес для синхронизации данных.

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

Добавление сервера.

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

- Строка подключаемого сервера приложения (формат - ip_адрес:порт).

- Логин для подключения к подключаемому серверу приложения.

- Пароль от логина.

- Запуск попытки подключения.

- Отмена настройки синхронизации.

В случае успешного подключения появится уведомление:

Если же сервер не доступен или введённые настройки не верны, то появится следующее сообщение:

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

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

Редактирование параметров подключения сервера.

Дважды кликнув ЛКМ по необходимому объекту синхронизации, откроется окно:

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

Удаление синхронизации.

Для того, чтобы удалить синхронизация объекта, кликните по строке подключения к нему ЛКМ. После чего нажмите кнопку "Удалить сервер" . После чего появится уведомление:

Отмена - прерывает удаление.

Применить - подтверждение удаления. Это действие не обратимо.

Отключение проверки на DDoS

Данный функционал доступен с версии v3.78 сервера приложений
Для отключения проверки на DDOS атаки от неисправного оборудования необходимо добавить в конфигурационный файл config.json в раздел backends строку:
"control_ddos": false

Использование firefly в качестве виртуального сервера

Для этого необходимо в файле config.json firefly изменить строчку с "virtual_server": false на "virtual_server": true.