.. _g3_spec_server_modes:

Режимы работы
===============

Запуска
----------
В режиме запуска сервер находится от момента запуска Java-процесса до завершения инициализации встроенного http-сервера.
При возникновении критических ошибок, сервер прерывает запуск и завершает свою работу.

В этом состоянии сервер не обрабатывает входящие http-запросы.

Работы
----------
Сервер функционален и способен обрабатывать входящие http-запросы.

Http-запросы к сервисным адресам завершаются ответами с указанными http-кодами.

- ``http://server/login/login.html`` - HTTP 200
- ``http://server/app/sys/monitor/public/isAlive`` - HTTP 200

.. seealso::
     :ref:`SSH-команда 'alter server mode normal' <ssh_commands>`

Обслуживания
-------------
Сервисный режим предназначен для обновления бизнес логики и схемы базы данных. При переключении в сервисный режим
все рабочие сеансы пользователей (кроме SSH-сеансов) закрываются с отменой всех не сохранённых данных.

Подключение возможно только с использованием учётных данных системного пользователя, обладающего ролью ``system``,
указанного в конфигурации сервера :xsd:class:`\<security\>\<users/\>\</security\> <Configuration.Security>`.

Http-запросы к сервисным адресам завершаются ответами с указанными http-кодами.

- ``http://server/login/login.html`` - HTTP 200
- ``http://server/app/sys/monitor/public/isAlive`` - HTTP 503

.. seealso::
     :ref:`SSH-команда 'alter server mode service' <ssh_commands>`

Остановки
----------
Сервер переходит в режим остановки перед завершением java-процесса.

Http-запросы к сервисным адресам завершаются ответами с указанными http-кодами.

- ``http://server/login/login.html`` - HTTP 404
- ``http://server/app/sys/monitor/public/isAlive`` - HTTP 404

Остановка может быть:

- ``немедленной`` - производится максимально быстрое завершение всех пользовательских сеансов, освобождение ресурсов и
  завершение java-процесса сервера.
- ``мягкой (отложенной)`` - пользователи уведомляются о необходимости выхода из системы в течении указанного в команде остановки
  времени. По истечению указанного интервала, производится завершение всех пользовательских сеансов, сервер переходит в
  режим завершения java-процесса.

.. seealso::
     :ref:`SSH-команды: 'shutdown server {delay}' и 'shutdown server immediate' <ssh_commands>`

Завершения
-------------
В этом состоянии сервер не обрабатывает входящие http-запросы и ближайшее время java-процесс будет завершён.