Установка GlobalServer в качестве службы Windows
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

Установка и управление службой производится при помощи утилиты ``Apache Commons Daemon``

Установка
--------------

* Скачать архив утилиты ``commons-daemon-[version]-bin-windows.zip`` с https://www.apache.org/dist/commons/daemon/binaries/windows/
* Распаковать архив утилиты в корневую директорию ``GlobalServer``
    * Выбрать файлы утилиты соответствующие разрядности операционной системы и jvm
* Копировать файлы скриптов из текущей директории в корневую директорию ``GlobalServer``
* Произвести настройку :term:`конфигурации GlobalServer<Конфигурация сервера>`
* Выполнить скрипт ``install_global_service.bat``

Назначение скриптов
-------------------------

* ``install_global_service.bat`` - установить службу ``Global3Service``
* ``start_global_console.bat`` - запустить службу ``Global3Service`` в качестве консольного приложения:
   вместе с запуском службы откроется окно консоли, к котором будет отображаться стандартный вывод службы и сервера приложений
* ``start_global_service.bat`` - запустить службу ``Global3Service``
* ``start_global_service_monitor.bat`` - запустить приложение настроек запуска и остановки ``GlobalServer`` в качестве службы Windows
* ``stop_global_service.bat`` - остановить службу ``Global3Service``
* ``uninstall_global_service.bat`` - удалить службу ``Global3Service``

.. note::
    Так же службой, после установки, можно управлять при помощи стандартных компонентов Windows

Логирование
-----------------

По умолчанию запись логов производится в файлы ``{корневая директория GlobalServer}/logs/Global3Service.{YYYY-MM-dd}.log``

Возможные ошибки
----------------------

* ``Failed creating Java 'C:\Program Files\Java\jdk1.8.0_211\jre\bin\server\jvm.dll'. %1 не является приложением Win32.``
    * Ошибка вызвана несоответствием разрядности бинарного файла утилиты ``Apache Commons Daemon`` и jvm.
      Нужно заменить файл ``prunsrv.exe`` на 64-разрядный из архива утилиты ``Apache Commons Daemon``

Ссылки
--------------

* Официальный сайт ``Apache Commons Daemon`` https://commons.apache.org/proper/commons-daemon/
* Скачать дистрибутив ``Apache Commons Daemon`` http://www.apache.org/dist/commons/daemon/binaries/windows/
* Описание команд и настроек ``Apache Commons Daemon`` https://commons.apache.org/proper/commons-daemon/procrun.html