Сервер приложения
Содержание
Сервер приложения 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.
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.
