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

Материал из Integra-S Wiki
Перейти к: навигация, поиск
(Редактор пользователей.)
(Общая настройка)
 
(не показано 14 промежуточных версий 2 участников)
Строка 47: Строка 47:
 
'''host''' - ip адрес сервера postgres(если локальный, то можно оставить localhost, ''хоть и не рекомендуется'').
 
'''host''' - ip адрес сервера postgres(если локальный, то можно оставить localhost, ''хоть и не рекомендуется'').
  
'''port''' -    порт базы postgres.
+
'''port''' -    порт базы postgres. Если указать 0 порт, то подключение к данной базе осуществляться не буде.
  
 
'''user''' -    логин администратора базы postgres.
 
'''user''' -    логин администратора базы postgres.
Строка 73: Строка 73:
 
Для обновления FireFly осуществляется переписыванием файлов программы поверх имеющихся, либо созданием отдельной папки с программой. Далее необходимо обновить схемы в базе данных, для чего запустить соответствующие командные файлы, идущие в комплекте поставки с программой.
 
Для обновления FireFly осуществляется переписыванием файлов программы поверх имеющихся, либо созданием отдельной папки с программой. Далее необходимо обновить схемы в базе данных, для чего запустить соответствующие командные файлы, идущие в комплекте поставки с программой.
  
'''_createAcuarioSchemeDB.bat''' – создание и обновление схем, относящихся к базе интеграции (оборудования).'''''Внимание! При запуске файла будут затерты все ранее настроенные пользователи, останутся только пользователи по умолчанию.'''''
+
'''create_DB_and_Schemas .bat''' – создание и обновление схем, относящихся к базе интеграции (оборудования).'''''Внимание! При запуске файла будут затерты все ранее настроенные пользователи, останутся только пользователи по умолчанию.'''''
  
'''_createIntegraPlanetSchemeDB.bat''' – создание и обновление схем, относящихся к базе Земли (база integraplanetearth).
+
'''update_Schemas.bat''' – обновление имеющихся схем, относящихся к базе интеграции (оборудования). Ранее настроенные пользователи затронуты '''''не будут'''''.
 
 
'''_updateAcuarioSchemeDB.bat''' – обновление имеющихся схем, относящихся к базе интеграции (оборудования). Ранее настроенные пользователи затронуты '''''не будут'''''.
 
  
 
''Примечание: Указанные командные файлы должны быть настроены в соответствии с ниже приведенным изображением.''
 
''Примечание: Указанные командные файлы должны быть настроены в соответствии с ниже приведенным изображением.''
  
[[Файл:ffupdate.png|центр|]]
+
[[Файл:ffupdate.png|центр|1000px]]
  
 
== Подключение к веб интерфейсу ==
 
== Подключение к веб интерфейсу ==
Строка 89: Строка 87:
 
Откроется окно, где нужно ввести параметры для подключения к FireFly:
 
Откроется окно, где нужно ввести параметры для подключения к FireFly:
  
[[Файл:сервер:ff01.png|центр]]
+
[[Файл:ff01.png|центр]]
  
 
* ip  aдрес и порт  wamp, с которыми запущена консоль FF
 
* ip  aдрес и порт  wamp, с которыми запущена консоль FF
Строка 103: Строка 101:
 
Сразу же после авторизации загрузится веб интерфейс:
 
Сразу же после авторизации загрузится веб интерфейс:
  
[[Файл:ff02.png|центр|]]
+
[[Файл:ff02.png|центр|1000px]]
  
 
по умолчанию открыта вкладка с редактором пользователей.
 
по умолчанию открыта вкладка с редактором пользователей.
Строка 109: Строка 107:
 
== Редактор пользователей. ==
 
== Редактор пользователей. ==
  
[[Файл:ff03.png|центр|]]
+
[[Файл:ff03.png|центр|1000px]]
 +
 
 +
 
 +
- Вкладки, переключающие доступ к функциям.
 +
 
 +
- Список пользователей.
 +
 
 +
- Переключение страниц.
 +
 
 +
- Кнопка добавления пользователя.
 +
 
 +
- Кнопка удаления пользователя.
  
  - Вкладки, переключающие доступ к функциям.
+
- Выход из интерфейса.
  - Список пользователей.
+
 
  - Переключение страниц.
+
- Поиск пользователя.
  - Кнопка добавления пользователя.
 
  - Кнопка удаления пользователя.
 
  - Выход из интерфейса.
 
  - Поиск пользователя.
 
  
 
=== Добавление пользователя. ===
 
=== Добавление пользователя. ===
Для добавления пользователя необходимо нажать на кнопку добавления пользователя {{:сервер:ff04.png?nolink|}}.
+
 
 +
Для добавления пользователя необходимо нажать на кнопку добавления пользователя [[Файл:ff04.png]].
 
После чего появится окно с четырьмя вкладками:
 
После чего появится окно с четырьмя вкладками:
  
Строка 180: Строка 186:
 
== Добавление правила. ==
 
== Добавление правила. ==
 
Есть три вида действий над правилами, за которые отвечают соответствующие кнопки:
 
Есть три вида действий над правилами, за которые отвечают соответствующие кнопки:
{{ :сервер:ff09.png?nolink |}}
+
 
для добавления правила необходима кнопка "Добавить правило" после чего откроется окно, к котором необходимо настроить необходимую конфигурацию.
+
[[Файл:ff09.png|центр|]]
//Примечание: правила подробнее будут описаны далее.//\\
+
 
После ввода необходимой информации, необходимо сохранить изменения, после чего новое правило появится в списке.\\
+
Для добавления правила необходима кнопка "Добавить правило" после чего откроется окно, к котором необходимо настроить необходимую конфигурацию.
 +
 
 +
''Примечание: правила подробнее будут описаны далее.''
 +
 
 +
После ввода необходимой информации, необходимо сохранить изменения, после чего новое правило появится в списке.
  
 
=== Редактирование роли. ===
 
=== Редактирование роли. ===
Строка 189: Строка 199:
  
 
=== Удаление роли. ===
 
=== Удаление роли. ===
Для того, чтобы удалить роль, кликните по нему ЛКМ. После чего нажмите кнопку удаления роли {{:сервер:ff04x.png?nolink|}}. После чего появится уведомление:
+
 
{{ :сервер:ff10.png?nolink |}}
+
Для того, чтобы удалить роль, кликните по нему ЛКМ. После чего нажмите кнопку удаления роли [[Файл:ff04x.png]] после чего появится уведомление:
**Отмена** - прерывает удаление роли.\\
+
 
**Применить** - подтверждение удаления роли. //Это действие не обратимо.// \\
+
[[Файл:ff10.png|центр|]]
 +
 
 +
'''Отмена''' - прерывает удаление роли.
 +
 
 +
'''Применить''' - подтверждение удаления роли. ''Это действие не обратимо.''
  
 
==== Настройки синхронизации. ====
 
==== Настройки синхронизации. ====
 +
 
Данные настройки служит для подключения кеширования с других серверов приложения. данная вкладка выглядит следующим образом:
 
Данные настройки служит для подключения кеширования с других серверов приложения. данная вкладка выглядит следующим образом:
{{ :сервер:ff11.png?nolink |}}
+
 
**Наименование объекта.** - Имя назначенное для плана.
+
[[Файл:ff11.png|центр|]]
**Адрес подключения.** - Адрес для синхронизации данных.
+
 
**Статус.** - Индикатор наличия подключения в текущий момент.
+
'''Наименование объекта.''' - Имя назначенное для плана.
 +
 
 +
'''Адрес подключения'''. - Адрес для синхронизации данных.
 +
 
 +
'''Статус.''' - Индикатор наличия подключения в текущий момент.
  
 
== Добавление сервера. ==
 
== Добавление сервера. ==
Для добавления сервера в синхронизацию необходимо нажать на кнопку добавления сервера {{:сервер:ff04.png?nolink|}}. После чего появится следующее окно:
+
Для добавления сервера в синхронизацию необходимо нажать на кнопку добавления сервера [[Файл:ff04.png]]. После чего появится следующее окно:
{{ :сервер:ff12.png?nolink |}}
+
 
  - Строка подключаемого сервера приложения (формат - ip_адрес:порт).
+
[[Файл:ff12.png|центр|]]
  - Логин для подключения к подключаемому серверу приложения.
+
 
  - Пароль от логина.
+
 
  - Запуск попытки подключения.
+
- Строка подключаемого сервера приложения (формат - ip_адрес:порт).
  - Отмена настройки синхронизации.
+
 
//В случае успешного подключения появится уведомление://
+
- Логин для подключения к подключаемому серверу приложения.
{{ :сервер:ff13.png?nolink |}}
+
 
//Если же сервер не доступен или введённые настройки не верны, то появится следующее сообщение://
+
- Пароль от логина.
{{ :сервер:ff14.png?nolink |}}
+
 
 +
- Запуск попытки подключения.
 +
 
 +
- Отмена настройки синхронизации.
 +
 
 +
 
 +
''В случае успешного подключения появится уведомление:''
 +
 
 +
[[Файл:ff13.png|центр|]]
 +
 
 +
''Если же сервер не доступен или введённые настройки не верны, то появится следующее сообщение:''
 +
 
 +
[[Файл:ff14.png|центр|]]
 +
 
 
После подключения выберите нужный план (или планы) для синхронизации.
 
После подключения выберите нужный план (или планы) для синхронизации.
{{ :сервер:ff15.png?nolink |}}
+
 
После всех манипуляций, необходимо сохранить изменения, после чего новое подключение появится в списке.\\
+
[[Файл:ff15.png|центр|]]
 +
 
 +
После всех манипуляций, необходимо сохранить изменения, после чего новое подключение появится в списке.
  
 
=== Редактирование параметров подключения сервера. ===
 
=== Редактирование параметров подключения сервера. ===
 +
 
Дважды кликнув ЛКМ по необходимому объекту синхронизации, откроется окно:
 
Дважды кликнув ЛКМ по необходимому объекту синхронизации, откроется окно:
{{ :сервер:ff16.png?nolink |}}
+
 
 +
[[Файл:ff16.png|центр|]]
 +
 
 
В котором можно сменить параметры подключения и авторизации, а так же принудительно проверить наличие подключения.
 
В котором можно сменить параметры подключения и авторизации, а так же принудительно проверить наличие подключения.
  
 
=== Удаление синхронизации. ===
 
=== Удаление синхронизации. ===
Для того, чтобы удалить синхронизация объекта, кликните по строке подключения к нему ЛКМ. После чего нажмите кнопку "Удалить сервер" {{:сервер:ff04x.png?nolink|}}. После чего появится уведомление:
+
 
{{ :сервер:ff17.png?nolink |}}
+
Для того, чтобы удалить синхронизация объекта, кликните по строке подключения к нему ЛКМ. После чего нажмите кнопку "Удалить сервер" [[Файл:ff04x.png]]. После чего появится уведомление:
**Отмена** - прерывает удаление.\\
+
 
**Применить** - подтверждение удаления. //Это действие не обратимо.// \\
+
[[Файл:ff17.png|центр|]]
 +
 
 +
'''Отмена''' - прерывает удаление.
 +
 
 +
'''Применить''' - подтверждение удаления. ''Это действие не обратимо.''
 +
 
 +
== Отключение проверки на DDoS ==
 +
Данный функционал доступен с версии v3.78 сервера приложений<br />
 +
Для отключения проверки на DDOS атаки от неисправного оборудования необходимо добавить в конфигурационный файл config.json в раздел backends строку:<br />
 +
"control_ddos": false<br />
 +
[[File:ddos.jpg|центр|500px]]
 +
 
 +
== Использование firefly в качестве виртуального сервера ==
 +
Для этого необходимо в файле config.json firefly изменить строчку с "virtual_server": false на "virtual_server": true.

Текущая версия на 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 – обновление имеющихся схем, относящихся к базе интеграции (оборудования). Ранее настроенные пользователи затронуты не будут.

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

Ffupdate.png

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

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

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

Ff01.png
  • ip aдрес и порт wamp, с которыми запущена консоль FF
  • по умолчанию логин: admin. пароль: Integra2015

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

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

Интерфейс

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

Ff02.png

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

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

Ff03.png


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

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

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

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

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

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

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

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

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

Ff05.png


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

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

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

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

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

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

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

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

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

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

Ff06.png

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

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

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

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

Ff07.png

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

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

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

- Поиск роли.

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

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

Ff08.png

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

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

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

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

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

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

Ff09.png

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

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

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

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

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

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

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

Ff10.png

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

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

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

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

Ff11.png

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

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

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

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

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

Ff12.png


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

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

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

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

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


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

Ff13.png

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

Ff14.png

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

Ff15.png

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

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

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

Ff16.png

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

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

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

Ff17.png

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

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

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

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

Ddos.jpg

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

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