Общие требования к серверу GK
Сервер для ПО “Game-Keeper” основной и обязательный компьютер в системе. Предназначен для обработки запросов от модулей системы GK к базе данных, для организации и хранения БД. По сути, это самый главный компьютер на объекте. Поэтому к нему должны предъявляться повышенные требования по быстродействию, отказоустойчивости и безопасности хранения данных.
Минимальные требования к выделенному серверу для работы серверного ПО:
Процессор Intel Core i3, RAM 8 Гб, HDD RAID1 500 Гб, 2 х Ethernet card 100 Mbps, CD-ROM, Video, 300 Вт. Операционная система: Windows 10 Pro (минимально), Windows Server 2012, Windows Server 2016.
Эти минимальные требования обусловлены спецификой работы MS SQL Server 2017 Express. Именно на этой платформе работает база данных Game-Keeper. В идеале это должен быть компьютер на базе Intel Core i5 и выше, RAM 16 Гб и выше.
Сервер для установки ПО Game-Keeper должен иметь две сетевые карты. Один сетевой интерфейс используется для связи сервера с игровым оборудованием в зале: игровые контролеры, турникеты, контролер с принтером, уничтожители тикетов. Второй сетевой интерфейс для связи сервера с офисными компьютерами: директора, менеджера GK, бухгалтера-калькулятора и т.д. На втором сетевом интерфейсе также необходимо наличие интернета для обновления системы и возможности удаленной поддержки сотрудниками Game-Keeper.
Для организации дискового пространства и повышения скорости обработки данных рекомендовано использовать SSD жесткие диски (для операционной системы, для базы данных). Также необходимо предусмотреть отдельный жесткий диск (возможно обычный HDD) для резервного копирования БД.
Также для безопасности рекомендовано использовать на сервере источник бесперебойного питания (лучше всего управляемый по сети).
Состав дистрибутива и предварительные настройки
Актуальный дистрибутив для установки ПО “Game-Keeper” можно скачать с официального сайта компании www.game-keeper.com в разделе “Поддержка” либо по запросу в отделе технической поддержки Game-Keeper на трекере support@game-keeper.com
Дистрибутив представляет собой архив stable_412_17.02.2020.7z, распаковав который вы получите практически все необходимое для разворачивания комплекса Game-Keeper на объекте. Состав дистрибутива:
Папка BACKUPDB – копируется на диск, предназначенный для резервного копирования базы данных GK, содержит в себе файлы и описания для создания бэкапа в автоматическом режиме через планировщик задач Windows.
Папка DISTRIB – содержит вспомогательные утилиты для создания и обновления базы данных, драйвера лицензионного ключа защиты Guardant, установщик клиента удаленной поддержки TeamViewer 9, системные библиотеки папка lib для корректной работы утилиты лицензирования и конфигуратора GK.
Папка DOCS – содержит в себе некоторую общую и техническую информацию по релизу версии.
Папка MSSQLDB – копируется в корень диска, предназначенного для хранения базы данных GK. Именно в эту папку, утилита gkUpgrader автоматически создает БД gkArcade.
Папка GK – папка с исполняемыми модулями программного комплекса "Game-Keeper".
Папка gkAPI – дистрибутивы для разворачивания web-технологий GK, таких как gkWebAPI, переносной терминал оператора, планировщик мероприятий…
Папка gkConfigurator – конфигуратор службы web-отчетов GK.
Папка gkEditor – исполняемые модули ПО “Редактор GK”
Папка gkInfo – исполняемы модули ПО “Инфотерминал GK”
Папка gkInterface – файлы для настройки связки с R-Keeper 7, импорта товаров/продаж в складской учет SH4
Папка gkOther – утилиты для работы (конфигурирование, заливка прошивок, мониторинг…) с проводными и беспроводными контролерами/точками доступа
Папка gkPos – исполняемые модули ПО “Касса GK”
Папка gkReports – исполняемые модули ПО “Управление пользователями” и “Кубы GK”
Папка gkRpl8 – дистрибутивы и исполняемые модули ПО “Корпоративная версия GK” для разворачивания системы репликации
Папка gkServices – исполняемые модули основных служб GK (gkAgent, gkHost, gkPosSever)
Папка gkSSRS – файлы с настройками и шаблонами web-отчетов
Configurator.exe – основная утилита для настройки параметров системы GK
Предварительные настройки на сервере
При инсталляции и настройке ПО “Game-Keeper” сервер должен быть залогинен под учетной записью с правами Администратора. Также стоит понизить политику контроля учетных записей до минимума:
Изменить системное имя компьютера (по желанию и на усмотрение заказчика):
Установить из папки \Files\DISTRIB\guardant дистрибутива GK драйвер лицензионного ключа защиты.
Вставить лицензионный ключ защиты Guardant в usb-порт на сервере. Убедиться, что на ключе загорелась световая индикация и что ключ отобразился в системе:
Содержимое папки \Files\DISTRIB\lib дистрибутива GK скопировать в системную директорию Windows C:\Windows\SysWOW64
Настроить брандмауэр Windows, либо другого софта (антивирусника) со встроенным файрволлом на предмет разрешения обмена через определенные порты, используемые в системе GK. Следует создать правила как для входящих, так и исходящих соединений. Базовые порты, которые необходимо “открыть”:
211 – порт Borland Socket Server
1433 – порт MS SQL Server
5556, 18251, 18252 – порты службы gkHost
50300 – порт службы gkPosServer
50220 – порт gkRptServer
50010, 60010 – порт службы gkConfigurator (web-отчеты)
50100, 60100 – порт SSRS
Также, если на объекте будут использоваться другие технологии GK, например из семейства WEB или планируется разворачивание корпоративной версии GK, то необходимо также добавить к этому списку порты из инструкций по установке соответствующих модулей.
Из дистрибутива GK папки GK, MSSQLDB, BACKUPDB скопировать в корни дисков, которые планируется использовать под создание БД – MSSQLDB, резервное копирование (бэкап) – BACKUPDB, исполняемые модули – GK.
Например, на сервере имеется 3 жестких диска: 1 диск SSD - операционная система Windows, 2 диск SSD – база данных и исполняемые модули софта, сюда копируем папки GK и MSSQLDB, 3 диск обычный HDD – для резервного копирования (создание бэкапов БД), сюда копируем папку BACKUPDB.
Для корректной работы утилит по конфигурации контролеров и точек доступа необходимо установить клиент Telnet. Делается это через компоненты Windows.
Как сказано в документе об общих требованиях к оборудованию GK, на сервере должно быть 2 сетевые карты. Одним сетевым интерфейсом сервер смотрит на игровое оборудование (контролеры, турникеты, точки доступа и т.д.), другим сетевым интерфейсом сервер смотрит на офисную сеть и интернет. Стоит понимать, что речь идет о двух физических разделенных локальных сетях. То есть в заведении имеется 2 свитча: один для игрового оборудования, и он соединен с соответствующим сетевым интерфейсом сервера, второй для офисной сети и интернета, в который приходит провод от второго сетевого интерфейса сервера. Соединять эти свитчи между собой НЕДОПУСТИМО! Если на объекте используется активное сетевое оборудование и управляемые свитчи, то в таком случае необходимо сконфигурировать 2 раздельных и непересекающихся VLAN, один из которых по аналогии с физическим свитчем будет использоваться под игровое оборудование, другой под офисную сеть и интернет. На момент настройки сервера оба сетевых интерфейса должны быть активными. На сетевом интерфейсе для игрового оборудования необходимо выставить настройки:
Именно этот ip-адрес в дальнейшем будет использоваться для конфигурирования служб gkAgent и gkHost!
Последним этапом подготовки сервера к установке ПО “Game-Keeper” является установка MS SQL Server 2017 Express. C инструкцией по установке и настройке SQL Server можно ознакомиться в соответствующем разделе.
Создание БД через gkUpgrader
Для удобства и простоты создания (и обновления) базы данных Game-Keeper разработана утилита gkUpgrader. Она входит в состав дистрибутива GK ..\Files\DISTRIB\gkUpgrader\
Запускаем gkUpgrader.exe:
Далее необходимо настроить подключение к SQL Server. Для этого нажимаем кнопку настройки подключения:
Попадаем в меню настройки.
На вкладке “Поставщик данных” выбираем “Microsoft OLE DB Provider for SQL Server”
На вкладке “Соединение” вводим имя сервера, пользователь sa, пароль пользователя sa (задавался при установке SQL Server), ставим галочку “Разрешить сохранение пароля”. Если ввели правильные учетные данные, то из ниспадающего списка доступен выбор баз данных для подключения. При создании новой БД мы выбираем базу master.
Проверяем соединение:
Далее нажимаем кнопку “Подключиться”:
Если предварительно в корень диска мы копировали папку MSSQLDB, то программа сама найдет ее и пропишет к ней путь. В обратном случае следует нажать “Обзор” и указать путь к папке для создания БД. Имя создаваемой базы данных gkArcade – рабочее название БД Game-Keeper. Также отобразится текущая версия БД, в нашем случаем это 0, так как базу мы только создаем. В ниспадающем окне” Новая версия” выбираем версию БД, которую планируем создать. Галочку “Выполнить бэкап перед обновлением” в нашем случае можно убрать. Нажимаем кнопку “Создать БД”:
Начнется процесс создания базы данных. Если операция прошла успешно, утилита выведет соответствующее сообщение:
Проверим создание нашей базы данных через Microsoft SQL Server Management Studio:
Также файлы базы данных должны создаться по пути указанному нами пути:
Установка и конфигурирование рабочих модуле: Пользователи и права
Для удобства настройки системы Game-Keeper на сервере, на компьютере менеджера (на всех компьютерах, где установлены модули Game-Keeper) разработано и применяется приложение Configurator.exe, которое находится в корне каталога GK из дистрибутива.
Важно!!! Configurator.exe должен находиться именно там, где находится по умолчанию – на одном уровне с папками модулей GK. Перемещать данное приложение недопустимо! Также немаловажно, что данное приложение необходимо запускать от имени Администратора.
1.Вкладка “Базовые настройки”
На этой вкладке осуществляются базовые настройки системы, такие как: тип станции, режим работы, подключение к базе данных GK.
Тип станции зависит от того, какие модули будут использоваться на данном компьютере. Если это просто сервер и на нем не планируется использовать приложения “Редактор GK”, то следует выбрать тип станции – Сервер. Если же наоборот это компьютер менеджера и на нем будет организована работа в приложении “Редактор GK”, а сервером является другой компьютер, то стоит тип станции выбрать – Рабочая станция. Если же компьютер, где производится установка и настройка является и сервером, и одновременно компьютером менеджера, то тогда тип станции смешанный – Рабочая станция и сервер.
“Режим работы” предлагает к выбору 3 позиции: Автономный объект, Сетевой объект- центр, Сетевой объект- филиал в зависимости будет ли использоваться корпоративная версия с репликацией данных или нет.
В блоке “Настройка базы данных” указываем подключение к базе данных SQL gkArcade, где вводим имя пользователя sa и его пароль.
!!!После ввода всех настроек, а также при переключении между вкладками необходимо нажимать кнопку “Сохранить”
2. Вкладка “Управление пользователями и Отчеты”
На этой вкладке вводятся настройки для модулей “Пользователи” и “Кубы GK”. Настройки делаются в двух блоках: Подключение к MSSQL и Клиент/Сервер. В первом блоке “Подключение к MSSQL” необходимо сконфигурировать строку подключения, для этого нажимаем в конце строки на 3 точки и попадаем в стандартное окно настроек подключения к БД. Здесь на первой вкладке “Поставщик данных” проверяем, что выбран Microsoft OLE DB Provider for SQL Server, на второй вкладке “Соединение” указываем имя сервера, пользователя sa и его пароль, ставим галочку запомнить пароль, выбираем базу данных gkArcade и делаем проверку соединения. Если учетные данные введены верно, то проверка соединения должна пройти успешно, база gkArcade должна быть доступна к выбору.
В блоке “Клиент/сервер” указываем лишь ip-адрес сервера. В нашем случае все находится на одном компьютере (сервере), поэтому указываем локальный ip 127.0.0.1. Если сервер находится на другом физическом компьютере, то следует указывать явный ip-адрес сервера.
3. Вкладка “INI файлы GK”
На этой вкладке производится настройка подключения основных модулей GK к базе данных gkArcade. Вносимые здесь изменения напрямую сразу попадают в ини-файлы соответствующих модулей. По умолчанию все поля в этом разделе заполнены дефолтными значениями. Нужно лишь только проверить и при необходимости внести измененя.
Кассовый сервер (gkPosServer) – в блоке “Настройки подключения к БД” имя сервера – 127.0.0.1, имя базы данных – gkArcade, пользователь – sa, пароль от sa в зишифрованном виде - 4F74999A405D97450D61241085055AC4 (соответствует паролю на пользователя sa - 1q2w3e777!). Как зашифровать пароль смотрите в соответствующей статье в текущем разделе докуентации. Порт gkPosServer по умолчанию – 50330. Уровень логирования по умолчанию – 10. Также на этой вкладке настраивается подключение к CRM и параметры работы сервера в корпоративной конфигурации с репликацией.
По аналогии с настройками кассового сервера заполняется раздел “Редактор”. Единственное, что здесь добавлены 2 блока настроек: “Подключение к серверу” и “Подключение к кассовому серверу”.
Блок настроек “Подключение к серверу” – указывается подключение к собственному серверу приложений ПО “Редактор GK”. Таковым является компонент gkMServer. Находится в папке gkEditor. На текущий момент это единственный сервер приложений GK, который работает не как служба Windows, а как приложение DCOM. В блоке “Настройка подключения к БД” указываются настройки подключения к базе данных именно этого сервера, изменения вносятся в его ини-файл gkMServer.ini
Подключение Редактора к gkMserver осуществляется посредством Borland Socket Server, поэтому в настройках подключения к серверу указывается адрес и порт, где запущена служба Borland Socket Server. Порт Borland Socket Server по умолчанию равен 211. Настройки из этого раздела автоматически вносятся при сохранении в gkEditor.ini
Блок настроек “Подключение к кассовому серверу” – указывается подключение ПО “Редактор GK” к gkPosServer через библиотеку gkMgrExt.dll. Через данную библиотеку в редакторе производится регистрация карт, групповая активация карт. Настройки, указанные в этом блоке при сохранении, попадают в gkMgrExt.ini
Также на этой вкладке настраивается подключение к CRM и параметры работы редактора в корпоративной конфигурации с репликацией.
Раздел “Сервер отчетов” – указываются настройки подключения службы отчетов и авторизации к базе данных gkArcade, а также собственный порт gkRptServer, который по умолчанию равен 50220. Настройки, указанные в этом блоке при сохранении, попадают в gkRptServer.ini
В разделе “Агент и Хост” указываются параметры настроек соответствующих служб gkAgent и gkHost.
В блоке “Настройки Хоста” мы видим как раз ip-адрес нашего сетевого интерфейса, который смотрит на игровую сеть с контролерами – 172.31.0.100!!! Стоит отметить, что, если этот ip-адрес отличается от реального назначенного адреса на сетевом интерфейсе, либо сетевой интерфейс на сервере с таким адресом не активен, то служба gkAgent не запустится!!!
В блоке “Настройки Агента” указывается ip-адрес и порт службы gkPosSever. Также в дополнительных настройках агента настраивается выводимое на экран игрового контролера сообщение. По умолчанию это “GAME-KEEPER”, при желании можно заменить на название игрового центра/площадки с соблюдением количества символов в строке.
Настройки, указанные в этих двух блоках при сохранении, попадают в gkAgent.ini и gkHost.ini соответственно.
В разделе “Репликация” представлены настройки корпоративной версии GK как для центральной, так и для локальной точки. Технология на данном этапе развития внедряется на объекты исключительно сотрудниками Game-Keeper.
Разделы “Касса” и “Инфо-киоск” предназначены для настройки соответствующих модулей непосредственно на терминале (компьютере) с установленным ПО “Касса GK” либо “Инфо-киоск GK”. Стоит отметить, что в таком случае Configurator.exe, также копируется на кассу либо инфо-терминал в корень каталога рядом с папкой gkPos и gkInfo.
4. Вкладка “Управление”
На этой вкладке происходит управление службами, зависимостями и ярлыками GK. Нажатием кнопки Install происходит инсталляция службы, Uninstall – деинсталляция службы, Start – запуск службы, Stop – остановка службы.
В блоке “Зависимости” устанавливаются зависимости между службами. Это сделано для того, чтобы было проще администрировать техническую часть сервера GK. Так при запуске службы gkAgent, если все настроено верно и выставлены соответствующие зависимости, служба поднимет gkHost, gkPosServer и запустится сама. Если в этой цепочке где-то “логический обрыв”, допустим не запущена служба SQL Server, то служба gkAgent не запустится. Если, настройки на предыдущих вкладках верные и сервер настроен в соответствии с документацией, то все службы должны быть успешно проинсталлированы и в последствии запущены.
В блоке “Управления ярлыками” можно вынести ярлыки от соответствующих модулей в папку GK на рабочий стол.
Пользователи и права
Основные технические настройки модуля “Пользователи и права” делаются через утилиту Configurator.exe. В рамках данной инструкции стоит проверить статус служб, отвечающих за работу модуля и сделать некоторые настройки в самом модуле.
Исполняемые файлы модуля “Пользователи и права” располагаются ..\GK\gkReports
Службы, отвечающие за функционирование данного модуля:
Ярлык для запуска в папке GK на рабочем столе:
По умолчанию в чистой базе данных программного комплекса “Game-Keeper” имеется один пользователь с именем “Администратор” и паролем “1” с правами только лишь для входа именно в модуль “Пользователи и права”. Нужно зайти в этот модуль и добавить прав учетной записи “Администратор” для дальнейшей полноценной установки софта.
Также по умолчанию в системе предустановлена одна роль “Администратор” с правами только на вход в модуль “Пользователи и Права”. Необходимо в этой роли выставить полный набор прав и уже эту роль назначитьучетной записи “Администратор”.
Чтобы перейти в роли нажать соответствующую кнопку на панели:
Откроется окно, в котором слева наименование роли “Администратор”, справа папки с наборами прав. Нужно перемещаясь по этим папкам, выставить галочки на правах, которые необходимы для данного сотрудника. Так как у нас пользователь “Администратор”, то изначально на время пусконаладочных работ можно выставить у этой роли полный набор прав. Далее в процессе работы игрового центра/парка этот набор можно скорректировать согласно описанию “Руководство пользователя” либо в процессе обучения с сотрудниками отдела обучения Game-Keeper. Ниже, для примера, показаны проставленные права в группе Касса:
Далее после проставления в роли всех необходимых прав, нужно присвоить данную роль нашей учетной записи “Администратор”. Переходим на вкладку на панели задач “Пользователи”, наступаем мышкой на пользователя “Администратор” справа в окне свойства этого пользователя открываем вкладку “Права” и выбираем роль “Администратор”. Нажимаем сохранить (изображение дискеты на верхней панели задач). Далее переходим здесь же на вкладку “Общие” и в поле код карты вводим номер карты, которой пользователь будет логиниться на кассе GK. Не путать с картой сотрудника в игровом зале! Это номер карты исключительно для пользования на кассе. Нажимаем сохранить (изображение дискеты на верхней панели задач). Теперь наш пользователь Администратор обладает всеми правами для настройки и тестирования системы “Game-Keeper”.
Аналогичным образом заводятся другие роли для сотрудников в игровом центре/парке со своим требуемым набором прав, заводятся сами сотрудники с именами и номерами карт для работы на кассе, им присваиваются созданные ранее роли. Например, старший кассир, менеджер зала и т.д.
На этом настройка модуля “Права и пользователи” завершена.
Редактор
Основные технические настройки модуля “Редактор” делаются через утилиту Configurator.exe. В рамках данной инструкции стоит проверить статус службы Borland Socket Server», вспомогательной в работе модуля, зарегистрировать сервер приложений для модуля «Редактор GK и сделать некоторые настройки в самом модуле.
Исполняемые файлы модуля “ Редактор” располагаются ..\GK\Editor
Проверяем статус службы Borland Socket Server на вкладке «Управление» в утилите Configurator.exe:
Как отмечалось выше, сервером приложений для Редактора является gkMServer.exe. На текущий момент единственный сервер в системе, который реализован не как служба Windows, а как приложение DCOM. Располагается в том же каталоге ..\GK\Editor, что и исполняемый модуль gkEditor.exe (Редактор). Приложение требует первичной регистрации.
Для регистрации данного сервера приложений можно воспользоваться одним из способов:
- В этой же папке gkEditor имеется service_registration.bat. Запустить от имени Администратора
- Создать ярлык запускаемого файла gkMServer.exe, в его свойствах указать ключ -regserver и запустить этот ярлык от имени Администратора. (Этот способ рекомендуемый!)
В обоих случаях после проделанных действий запустить и выгрузить сам gkMServer.exe, щелкнув по файлу 2 раза левой кнопкой мыши, или навести курсор и нажать Enter на клавиатуре.
При запуске в трее появится иконка этого сервера приложений 
. Нажать правой кнопкой мыши на иконке и выбрать Exit.
Далее необходимо произвести некоторые настройки в самом приложении «Редактор».
Ярлык для запуска в папке GK на рабочем столе:
Напоминаем, что запуск приложения «Редактор» возможна лишь, при наличии лицензионного ключа защиты Guardant, с прописанным в него модулем «Редактор GK». В нашем случае и сервер с БД, и Редактор размещены на одном физическом компьютере, поэтому в нашем лицензионном ключе прописаны и серверный модуль, и модуль для запуска Редактора.
Учетная запись для входа Администратор с паролем 1. У этой учетной записи должны быть проставлены права на вход в модуль «Редактор» и возможность редактировать справочники (Права проставляются в модуле, описанном ранее «Пользователи и права»).
Заходим в справочник Словари – Игровой зал, где вводим название объекта и заполняем поле Код корпорации:
Код корпорации присваивается объекту при первичном добавлении в базу данных системы GK на сервере лицензирования Game-Keeper в офисе компании. Код может содержать от 1 до 6 цифр и является самым важным идентификатором объекта в системе. На основе этого кода корпорации генерируются электронно-цифровые подписи для игровых карт, которые заносятся в базу данных и делают карты легитимными для использования в системе Game-Keeper.
Важно!!! После внесения кода корпорации и сохранения, данное поле перестает быть активным для правки. В нем ничего больше нельзя исправить. Нужно внимательным образом вносить код корпорации, сверив его с данными, полученными от специалистов Game-Keeper. Если же все-таки допущена ошибка при вводе кода корпорации, то следует обратиться в службу технической поддержки support@game-keeper.com для его правки непосредственно в БД.
Также немаловажно после сохранения кода корпорации перегрузить службу gkPosServer через Configurator. Для этого на вкладке «Управление» остановить службы gkAgent и gkPosServer, нажав кнопку - Stop
затем запустить лишь службу gkAgent, нажав кнопку - Start. Если установлены зависимости служб, о которых описывалось при рассмотрении работы утилиты Configurator, то служба gkAgent запустит gkPosServer и запустится сама:
Заключительным этапом технической настройки приложения Редактор является регистрация кодов игровых карт в базу данных gkArcade.
После заказа кодов карт на сайте www.game-keeper.com и оплаты этих кодов (стоимость уточнять в коммерческом отделе Game-Keeper), на почту, указанную при подаче заявки, придет 2 файла: один ХХХ(1-1000).xls – файл для намагничивания карт при изготовлении на производстве, другой ХХХ(1-1000).txt – файл с электронно-цифровыми подписями для регистрации в БД Game-Keeper на объекте. Здесь ХХХ – код корпорации, (1-1000) – диапазон кодов.
В приложении Редактор на верхней панеле выбираем справочник Карты и далее Регистрация карт. Нажимаем на … и указываем путь к файлу с кодами/подписями, нажимаем «Выполнить»:
Стоит отметить, что при нажатии на … для указания пути к файлу с кодами/подписями, система по умолчанию открывает папку, где расположен gkEditor. Отсюда рекомендация: при получении файла с кодами/подписями, копировать его именно в эту папку, чтобы всегда знать и отслеживать какие диапазоны карт вносились, какие файлы вам присылали сотрудники Game-Keeper.
Если регистрация карт прошла успешно, система выдаст сообщение:
После операции регистрации карт требуется еще перегрузить службу gkPosServer!!! Как это делается смотреть описание выше.
Как работать в приложении Редактор: заполнять справочники, заводить игровые контролеры, устанавливать цены, управлять бонусами и т.д. детально рассматривается в документации «Руководство Пользователя».