Как перезапустить сервер Gizmo

Gizmo Server — главный компонент Gizmo: к нему подключаются все клиентские пк и Gizmo Manager. Перезапускать его приходится нечасто, но бывает нужно: например, после добавления, удаления, включения или отключения интеграций, после установки нового SSL-сертификата или по просьбе службы поддержки. Изменения в этих настройках не заработают, пока сервер не перезапущен.

Пока сервер перезапускается, клиентские пк теряют с ним связь. Если в клубе в этот момент играют гости, важно заранее настроить, что произойдёт с их сеансами, — иначе перезапуск может разлогинить весь зал. Разберём, как подготовиться и как перезапустить сервер в каждом режиме работы.

Шаг 1. Определите, как работает ваш сервер

От этого зависит, как его перезапускать.

  • Служба — фоновый процесс Windows, который запускается вместе с системой. Этот режим рекомендуется для постоянной работы.

  • Консольное приложение — сервер запускается вручную, через ярлык на рабочем столе или из папки C:\Program Files\NETProjects\Gizmo Server. Этот режим используют для сбора ошибок, единоразового запуска или по просьбе поддержки.

Чем отличаются режимы и как установить службу — в статье «Режимы работы сервера».

Оба режима относятся к серверу, установленному на Windows. Кроме того, Gizmo Server устанавливается на Linux и в Docker — для этих вариантов см. шаг 4. Облачная версия сервера находится в разработке.

Шаг 2. Заранее настройте поведение сеансов при потере связи

Что случится с сеансами гостей, пока сервер недоступен, определяют настройки оболочки. Откройте Настройки → Клиент → Оболочка, блок Сеанс пользователя:

  • Выход из системы отключенных клиентов — если включено, при потере связи с сервером сеанс гостя завершится в самом Gizmo Client.

  • Завершение ожидающих сеансов — если включено, при потере связи сеанс гостя завершится в Gizmo Server и Gizmo Manager.

  • Время ожидания [Секунды] — сколько секунд Gizmo ждёт восстановления связи, прежде чем завершить сеанс по одной из опций выше. По умолчанию — 180 секунд.

Если обе опции выключены, сеансы гостей не завершатся автоматически из-за потери связи. Если включена хотя бы одна, сеанс завершится, когда связь пропадёт дольше, чем задано в Времени ожидания.

Изменения опций Время ожидания, Выход из системы отключенных клиентов и Завершение ожидающих сеансов применяются только после перезагрузки Gizmo Client. Поменять их «на лету» прямо перед перезапуском сервера не получится — настройте их заранее. Чтобы применить настройки, не перезагружая сами пк, на Карте выберите игровые места и нажмите Перезапустить оболочку — Gizmo Client перезапустится без перезагрузки компьютера.

Подробнее — в статье «Оболочка».

Шаг 3. Оцените, сколько у вас времени

  • Если опции завершения сеансов включены, сервер должен снова заработать до того, как истечёт Время ожидания. Со значением по умолчанию у вас есть 180 секунд.

  • Если опции выключены, сеансы гостей не прервутся из-за потери связи, но на время перезапуска клиентские пк всё равно останутся без связи с сервером.

Если перезапуск не срочный, выберите время, когда в клубе меньше всего гостей.

Шаг 4. Перезапустите сервер

Если сервер работает как служба

  1. На серверном пк запустите конфигуратор ConfigurationTool. Он находится в папке C:\Program Files\NETProjects\Gizmo Server\tools\configuration.

  2. Перейдите в раздел «Управление Сервисом Gizmo».

  3. Остановите службу и снова запустите её.

Если Windows требует учётные данные для управления службой, включите Расширенный режим и укажите логин и пароль, с которыми входите в аккаунт Windows при запуске пк. Если пароля для входа в систему нет, создайте его.

Если сервер работает как консольное приложение

  1. Закройте окно консоли сервера.

  2. Запустите сервер снова — через ярлык на рабочем столе или из папки C:\Program Files\NETProjects\Gizmo Server.

Если сервер установлен на Linux или в Docker

Данный раздел находится в разработке.

Шаг 5. Проверьте, что всё работает

  1. Откройте Gizmo Manager и перейдите на Карту.

  2. Убедитесь, что игровые места снова на связи, а сеансы гостей на месте.

  3. Если перезапуск был нужен для новой интеграции или сертификата, проверьте, что они заработали.

Если после перезапуска клиентский пк не подключается к серверу, пройдите чек-лист из инструкции «Проблемы подключения клиентских пк».

Результат

  • Сервер перезапущен, и изменения, которые требовали перезапуска, вступили в силу.

  • Сеансы гостей пережили перезапуск: либо опции завершения сеансов выключены, либо сервер вернулся раньше, чем истекло Время ожидания.

  • В следующий раз перезапуск займёт пару минут: настройки сеанса уже подготовлены.

Связанные статьи — «Режимы работы сервера», «Оболочка» и «Добавление интеграции».