Просмотр исходного текста страницы Руководство администратора:сервер:ff


== Сервер приложения FireFly ==
 
Сервер приложений FireFly обеспечивает взаимодействие программы  Интегра Планета Земля и СУБД Postgres с целью повышения отказоустойчивости и балансировки нагрузки.\\
//Примечание: После установки (в [[руководство_администратора:сервер:windows|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 осуществляется переписыванием файлов программы поверх имеющихся, либо созданием отдельной папки с программой. Далее необходимо обновить схемы в базе данных, для чего запустить соответствующие командные файлы, идущие в комплекте поставки с программой.\\
**//_createAcuarioSchemeDB.bat//** – создание и обновление схем, относящихся к базе интеграции (оборудования).\\ __**Внимание! При запуске файла будут затерты все ранее настроенные пользователи, останутся только пользователи по умолчанию.**__\\
**//_createIntegraPlanetSchemeDB.bat//** – создание и обновление схем, относящихся к базе Земли (база integraplanetearth).\\
**//_updateAcuarioSchemeDB.bat//** – обновление имеющихся схем, относящихся к базе интеграции (оборудования). Ранее настроенные пользователи затронуты __**не будут**__.\\
//Примечание: Указанные командные файлы должны быть настроены в соответствии с ниже приведенным изображением.//
{{ :сервер:ffupdate.png?nolink |}}

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

Чтобы зайти на интерфейс настройки FireFly,  нужно в браузере ввести ip адрес компьютера, где запущена консоль   FireFly и порт  http , в формате: ''xxx.yyy.zzz.www:qqq''
Откроется окно, где нужно ввести параметры для подключения к FireFly:
{{ :сервер:ff01.png?nolink |}}
  * ip  aдрес и порт  wamp, с которыми запущена консоль FF
  * по умолчанию логин: admin. пароль: Integra2015\\
Нажатие на "Вход" откроет окно, в котором будут показаны все пользователи в программе  FireFly.\\ 
//Примечание: если в интерфейсе 5 вкладок, а не 4, то это FF старой версии и там работают только вкладки  **Редактор пользователей**, **Редактор ролей** и  **Настройка Синхронизации**. Другие вкладки трогать __не рекомендуется__.//

===== Интерфейс =====
сразу же после авторизации загрузится веб интерфейс:
{{ :сервер:ff02.png?nolink |}}
по умолчанию открыта вкладка с редактором пользователей.

==== Редактор пользователей. ====
{{ :сервер:ff03.png?nolink |}}
  - Вкладки, переключающие доступ к функциям.
  - Список пользователей.
  - Переключение страниц.
  - Кнопка добавления пользователя.
  - Кнопка удаления пользователя.
  - Выход из интерфейса.
  - Поиск пользователя.

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

Для добавления пользователя необходимо нажать на кнопку добавления пользователя [[Файл:ff04.png]].

После чего появится окно с четырьмя вкладками:

[[Файл:ff05.png|центр|]]

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

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

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

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


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

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

=== Редактирование пользователей. ===
Для начала редактирования необходимо сделать двойной клик ЛКМ по нужному пользователю, после чего откроется такое же окно, как и при [[руководство_администратора:сервер:ff#добавление_пользователя|добавлении пользователя]]. После чего можно вносить изменения.

=== Удаление пользователей. ===
Для того, чтобы удалить пользователя, кликните по нему ЛКМ. После чего нажмите кнопку удаления пользователя {{:сервер:ff04x.png?nolink|}}. После чего появится уведомление:
{{ :сервер:ff06.png?nolink |}}
**Отмена** - прерывает удаление пользователя.\\
**Применить** - подтверждение удаления пользователя. //Это действие не обратимо.// \\

==== Редактор ролей. ====
При открытии вкладки, окно примет следующий вид:
{{ :сервер:ff07.png?nolink |}}
  - Список ролей.
  - Добавить роль.
  - Удалить роль.
  - Поиск роли.

=== Добавление роли. ===
Для добавления новой роли необходимо нажать на кнопку добавления пользователя {{:сервер:ff04.png?nolink|}}. После чего появится следующее окно:
{{ :сервер:ff08.png?nolink |}}
  - Имя роли и доступ к конфигурации правил роли.
  - Подключение пользователей к данной роли.
После ввода необходимой информации, необходимо сохранить изменения, после чего новая роль появится в списке.\\
//Примечание: Нажатие на кнопку "отменить" прервёт создание роли. окно закроется, а новой записи в списке не появится.//

== Добавление правила. ==
Есть три вида действий над правилами, за которые отвечают соответствующие кнопки:
{{ :сервер:ff09.png?nolink |}}
для добавления правила необходима кнопка "Добавить правило" после чего откроется окно, к котором необходимо настроить необходимую конфигурацию.
//Примечание: правила подробнее будут описаны далее.//\\
После ввода необходимой информации, необходимо сохранить изменения, после чего новое правило появится в списке.\\

=== Редактирование роли. ===
Для начала редактирования необходимо сделать двойной клик ЛКМ по нужной роли, после чего откроется такое же окно, как и при [[руководство_администратора:сервер:ff#добавление_роли|добавлении роли]]. После чего можно вносить изменения.

=== Удаление роли. ===
Для того, чтобы удалить роль, кликните по нему ЛКМ. После чего нажмите кнопку удаления роли {{:сервер:ff04x.png?nolink|}}. После чего появится уведомление:
{{ :сервер:ff10.png?nolink |}}
**Отмена** - прерывает удаление роли.\\
**Применить** - подтверждение удаления роли. //Это действие не обратимо.// \\

==== Настройки синхронизации. ====
Данные настройки служит для подключения кеширования с других серверов приложения. данная вкладка выглядит следующим образом:
{{ :сервер:ff11.png?nolink |}}
**Наименование объекта.** - Имя назначенное для плана.
**Адрес подключения.** - Адрес для синхронизации данных.
**Статус.** - Индикатор наличия подключения в текущий момент.

=== Добавление сервера. ===
Для добавления сервера в синхронизацию необходимо нажать на кнопку добавления сервера {{:сервер:ff04.png?nolink|}}. После чего появится следующее окно:
{{ :сервер:ff12.png?nolink |}}
  - Строка подключаемого сервера приложения (формат - ip_адрес:порт).
  - Логин для подключения к подключаемому серверу приложения.
  - Пароль от логина.
  - Запуск попытки подключения.
  - Отмена настройки синхронизации.
//В случае успешного подключения появится уведомление://
{{ :сервер:ff13.png?nolink |}}
//Если же сервер не доступен или введённые настройки не верны, то появится следующее сообщение://
{{ :сервер:ff14.png?nolink |}}
После подключения выберите нужный план (или планы) для синхронизации.
{{ :сервер:ff15.png?nolink |}}
После всех манипуляций, необходимо сохранить изменения, после чего новое подключение появится в списке.\\

=== Редактирование параметров подключения сервера. ===
Дважды кликнув ЛКМ по необходимому объекту синхронизации, откроется окно:
{{ :сервер:ff16.png?nolink |}}
В котором можно сменить параметры подключения и авторизации, а так же принудительно проверить наличие подключения.

=== Удаление синхронизации. ===
Для того, чтобы удалить синхронизация объекта, кликните по строке подключения к нему ЛКМ. После чего нажмите кнопку "Удалить сервер" {{:сервер:ff04x.png?nolink|}}. После чего появится уведомление:
{{ :сервер:ff17.png?nolink |}}
**Отмена** - прерывает удаление.\\
**Применить** - подтверждение удаления. //Это действие не обратимо.// \\