Различия

Показаны различия между двумя версиями страницы.

--- служба [2020/06/03 14:58] – создано timofeev
+++ служба [2025/12/23 07:16] (текущий) – timofeev
@@ Строка 1: / Строка 1: @@
 ===Установка службы===
-Начиная с версии 512 программа может быть установлена в режиме службы.\\
+Программа может быть установлена в режиме службы для взаимодействия с АТС, сайтом, мобильными приложениями.\\
 Для этого следует\\
-) запустить на сервере программу под именем любого из администраторов и выбрать в меню
+) запустить на сервере программу __**от имени администратора Windows**__ (надо нажать на ярлыке программы правую кнопку мыши и выбрать из меню соответствующий пункт),
-"обработки - управление службой - установить службу"\\
-Помимо прочих настроек, будет создан пользователь программы "Служба".\\
+{{:ustsl2.png|}}
-) проверить в списке служб появление службы Водяной (vodasoft) , зависящей от Firebird\\
-) в справочнике облачных АТС проверить, установлен ли созданный
+войти в базу как администратор Водяного и выбрать в меню "обработки - управление службой - установить службу"\\
+{{:ustsl.png|}}
+Помимо прочих настроек, будет создан серверный пользователь программы "Служба" (в подсчете лицензий не учитывается).\\
+) проверить в списке служб появление служб Водяной-ККМ, Водяной- водительское приложение, Водяной-АТС(а) и Водяной-API(б), зависящих от Firebird\\
+) в справочнике облачных АТС проверить, указан ли в поле "запускать от имени пользователя" значение "Служба".\\
+(а) Если используется Asterisk, после установки службы отредактируйте %ProgramData%\vodjanoj\srv.ini, поменяв в строке Asterisk значение на 1, а затем перезапустите службу Водяной-АТС.\\
+(б) От службы Водяной-API зависит, кроме обмена с сайтами и приложениями, ряд других функций (загрузки из битрикс, яндекс-диска, получение статуса платежей из юкассы.\\
+Важно!!! Начиная с [[версия_589|версии 589]] вместо одной службы Водяной устанавливается 4 службы: Водяной-ККМ, Водяной-API, Водяной- АТС, Водяной - водительское приложение. Это необходимо для интеграции с [[тс_пиот|ТС ПИоТ]] и,  кроме того повысит стабильность работы служб.\\
+После обновления запустите на сервере Водяной **от имени администратора** windows, затем выберите обработки - управление службой - удалить службу, после чего, в том же меню - установить службу. При установке выберите нужные варианты запуска (рекомендуется установить все, при отсутствии данных для запуска больших затрат ресурсов не будет).\\
 ===Текущая работа со службой===
-Логи службы создаются в %ProgramData%\vodjanoj\log.\\
+Логи службы создаются в %ProgramData%\vodjanoj\log\0 (фиксируются при завершении работы службы, ее перезапуске).\\
 Параметры подключения к базе данных хранятся в %ProgramData%\vodjanoj\srv.ini.\\
 Окно серверного пользователя запускать не нужно, все серверные операции выполняются службой.\\
 ===Удаление службы===
-При необходимости выполняется через "обработки - управление службой - удалить службу"\\
+При необходимости выполняется через "обработки - управление службой - удалить службу". Программа должна быть запущена с правами администратора Windows.\\
+[[служба_при_обн|Порядок обновления программы при установленной службе]]
+===Сетевые настройки===
+Для работы с мобильным приложением, АТС, API потребуется статический ip-адрес (надо подключить эту услугу у своего интернет-провайдера).\\
+Кроме того, необходимо "пробросить" и открыть сетевые порты 10380, 10385, 10400.\\
+Для работы с [[мп_настройка_водяного|мобильным приложением водителя]] откройте порт 10380.\\
+Для работы с [[телефония|облачной АТС]] откройте порт 10385.\\
+Для работы по [[api|API]] откройте порт 10400.\\
+Проверить доступность службы можно с помощью сервисов проверки порта (2ip и подобные) либо с любого внешнего ip-адреса (не из офиса компании) в любом браузере, например (для водительского приложения) запрос
+<code>
+http://ваш-внешний-ip:10380/ping
+</code>
+должен вернуть ОК.\\
+Если порт закрыт, сначала проверьте, откликается ли служба на компьютере, где она установлена, при помощи запроса
+<code>
+http://127.0.0.1:10380/ping
+</code>
+Если ответ ОК получен - проблема в сетевом оборудовании или доступности сети, если нет - [[перезапуск_адм|перезапустите службу]], убедившись предварительно в том, что настройки сделаны верно и в полном объеме.\\
+===Подключение к службе дополнительных баз данных===
+Если необходимо обеспечить параллельную работу с несколькими базами Водяного (например, базы филиалов в разных городах расположены на одном сервере), то необходимо создать по образцу в %ProgramData%\vodjanoj\ srv.ini файлы конфигурации для дополнительных баз - srv1.ini (srv2.ini и т.д.).\\
+В этих файлах изменяем строки NazvIBKS и PutKIBKS, указав в них, соответственно, название и путь к дополнительным базам.\\
+В дополнительных базах необходимо внести в администрирование - пользователи запись "служба", по образцу имеющегося в основной базе, с правами администратора и флажком записи сервера и признаком доступа к API\\
+Для работы с водительским мобильным приложением в администрирование - параметры интеграции надо (в дополнительных базах) создать строку SERVERMP с указанием порта для этой базы (например, 10381 вместо 10380, при этом необходимо пробросить порт 10381 аналогично 10380). Этот же порт указать в настройках приложения водителя, работающего в соответствующем подразделении.\\
+Аналогичным образом, для доступа к серверу API в доп. базе заведите в администрирование - параметры интеграции строку с наименованием "APIVOD" и указанием порта API для базы, например 10491 вместо 10490.\\
+После настройки доп. базы необходимо перезапустить службу Водяного, чтобы был запущен дополнительный поток службы, связанной с базой, указанной в srv1.ini.\\
+Логи дополнительных потоков хранятся в папке %ProgramData%\vodjanoj\log\1 (2,3 и т.д.)
+[[установка|описание установки программы]]
+[[не_приходят_заказы|если не приходят заказы водителям]]
+[[адм_фб|вопросы администрирования баз]]