| Оглавление |
|---|
Общие требования к серверу GK
Сервер для ПО “Game-Keeper” "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!!! Как это делается смотреть описание выше.
Как работать в приложении Редактор: заполнять справочники, заводить игровые контролеры, устанавливать цены, управлять бонусами и т.д. детально рассматривается в документации «Руководство Пользователя».
Кубы GK
Стоит сразу дать пояснения про модуль «Кубы GK». До версии Game-Keeper 4.12 отчеты в системе были представлены приложением Reports_Manager, в состав которого входили как сами отчеты так и Кубы, представляющие собой отчеты по технологии OLAP, где пользователь сам мог выбирать разрезы и факты выдаваемой информации. Начиная с версии 4.12, программный комплекс Game-Keeper отказался от развития и поддержки обычных отчетов, был осуществлен переход на отчеты с использованием SSRS и web-технологий (web-отчеты). Но технологию OLAP и кубы решено было пока оставить в модуле Reports_Manager. Поэтому модуль «Кубы GK» есть ничто иное, как модуль Reports_Manager (Отчеты) с наличием в нем только отчетов по технологии OLAP.
Основные технические настройки модуля “Кубы GK” делаются через утилиту Configurator.exe. В рамках данной инструкции стоит проверить статус служб, отвечающих за работу модуля и сделать настройки в самом модуле.
Исполняемые файлы модуля “Кубы GK” располагаются ..\GK\gkReports
Службы, отвечающие за функционирование данного модуля:
Ярлык для запуска в папке GK на рабочем столе. Причем изначально при выносе ярлыка через Configurator, он называется «Отчеты». Переименовываем в «Кубы GK»:
Учетная запись для входа Администратор с паролем 1. У этой учетной записи должны быть проставлены права на вход в модуль «Отчеты» и возможность осуществлять настройки (Права проставляются в модуле, описанном ранее «Пользователи и права»).
Общий вид рабочего окна приложения:
Первично для избегания путаницы переименовываем папку «Отчеты» в «Кубы GK»
Далее настраиваем подключение к базе данных gkArcade. Для этого на главной панели входим в Настройки – База данных, нажимаем иконку 
«Добавить». В появившемся окне вводим Название – GKDB, Тип соединения выбираем – Datasnap, IP Adress – 127.0.0.1 (адрес службы сервера Отчетов), порт – 50220 (по умолчанию порт сервера отчетов), ClassName – Tcinema_Reports_DM.
Нажимаем кнопку «Тест соединения».
После вывода сообщения об успешном соединении, нажимаем ОК и сохранить 
(иконка дискетки).
Далее необходимо добавить фильтр для отчетов. Выбираем на главной панели Настройки – Фильтры, нажимаем иконку 
«Добавить». В появившемся окне вводим Название – GKFILTER, Имя DLL-файла в ниспадающем окне выбираем GKRPTFILTER.DLL, сохранить 
(иконка дискетки), Закрыть.
Теперь осуществляем импорт кубов. Выбираем на главной панели Отчеты – Импорт группы отчетов. В появившемся окне указываем База данных – GKDB (созданная ранее), Путь к отчетам – путь к папке Reports, ставим галочку Фильтр и выбираем наш фильтр, созданный ранее, ставим галочку «Перезаписать источники данных».
Нажимаем кнопку «Импортировать». Происходит импорт шаблонов кубов в базу данных.
Нажимаем кнопку «Закрыть». Наши Кубы отобразятся в главном окне.
Далее необходимо «пробежаться» по всем кубам и настроить поля для отображения в отчетах. Для этого наступаем на название куба, в правом окне выбираем вкладку «Дополнительно», нажимаем кнопку «Стандартные настройки», автоматически проставятся галочки, не забываем нажимать сохранить 
(иконка дискетки):
В заключении хочется пояснить настройки при создании подключения к базе данных:
В поле IP Adress всегда стоит вбивать реальный IP-адрес сервера!!! Например, адрес типа 192.168.1.100. Как в нашем примере адрес 127.0.0.1 применяется исключительно, когда в системе один компьютер является и сервером, и компьютером менеджера. Если на объекте присутствуют другие компьютеры, на которых устанавливается модуль «Кубы GK» и будут смотреть отчеты, то обязательно явный IP-адрес. Вносимые в эту форму настройки хранятся в базе данных gkArcade и является абсолютным для всех устройств в системе Game-Keeper. Так как служба сервера отчетов запущена на сервере, то доступ к ней по адресу 127.0.0.1 с компьютера менеджера будет уже неверный и подключиться не удастся. А адрес, например 192.168.1.100, будет верный как для подключения с сервера, так и для подключения с остальных компьютеров, на которых планируется пользоваться модулем «Кубы GK».
Установка и настройка вэб. Отчетов (SSRS)
Технология SSRS, а также разворачивание и настройка web-отчетов подробно описаны в документе
Отложенные отчеты GK
Для возможности использования отложенных отчетов, а точнее для отправки отчетов по расписанию на электронную почту выбранным пользователям (например, директору отчет по выручке за предыдущий день), на объекте должен быть установлен SQL Server 2017 с полноценной лицензией. Версия ПО Game-Keeper должна быть, начиная с 4.12. Также должны быть установлены и настроены отчеты SSRS (web-отчеты).
1.Настройки Microsoft SQL Server Reporting Services
Заходим в Диспетчер SSRS, конектимся к серверу, выбираем вкладку «Настройки электронной почты» и заполняем поля:
Для отправки отчетов на e-mail целесообразно создать специальный почтовый ящик.
Также для настройки отправки отчетов по расписанию необходимо, чтобы была запущена служба SQL Agent. Проверить это можно в Диспетчере конфигурации SQL Server. При необходимости запустить.
2. Настройки расписаний отложенных отчетов
Запускаем ярлык web-отчетов из папки GK на рабочем столе:
Находим отчет, который хотим по расписанию отправлять на e-mail, нажимаем в правом верхнем углу плитки отчета на … и выбираем «Подписаться»:
Далее нужно заполнить параметры нашей подписки. Заполнить «Описание» – целесообразно называть по названию отчета и периодичности отправки, заполнить «Место назначения» - можно на почту, можно в общую папку на сетевом ресурсе:
Для отправки по расписанию, нужно создать это самое расписание, нажав кнопку Изменить расписание:
При таком расписании, как указано в примере, отчет будет приходить ежедневно в 8 утра.
Далее нужно заполнить варианты доставки, указать адреса электронной почты, тему письма, в каком формате доставлять и включить ссылку на этот отчет или нет. Тема — это своего рода шаблон, по которому будет называться письмо, приходящее на e-mail. Формат отображения по умолчанию стоит MHTVL (веб-архив). При таком формате отчет корректно отобразится в теле самого почтового отправления. Можно также выбрать другие форматы по желанию: Word, Exel, PDF… Галочка «Включить ссылку» дает возможность к письму прикрепить ссылку на этот отчет, пройдя по которой мы уже в браузере увидим отчет, с указанными фильтрами.
Последним этапом выставляем параметры (фильтры) отчета, допустим диапазон дат или какой-то тип группировки данных и нажимаем «Создать подписку»
Управлять подписками можно выбрав наш отчет, на плитке отчета в верхнем правом углу нажать …, далее Управление:
Далее слева выбрать вкладку «Подписки»:
На указанную в подписке почту в заданное время придет отчет. На скриншоте ниже показано, как отработал шаблон Темы в рассылке @ReportName был выполнен в @ExecutionTime - @ReportName – название отчета, в нашем случае Выручка, @ExecutionTime – время выполнения:
Также на рисунке ниже видно, как отрабатывает галочка «Включить ссылку». Внизу отчета прикрепляется ссылка на этот отчет.
Если на объекте имеется белый IP-адрес и настроен проброс портов на SSRS, то нажав на ссылку, можно в браузере на телефоне или планшете в любой точке мира увидеть наш отчет. В нашем примере адрес ссылки локальный.
приведены в Общих требованиях к объектам перед инсталляцией. Эти минимальные требования обусловлены спецификой работы MS SQL Server 2017 Express. Именно на этой платформе работает база данных Game-Keeper.
Сервер для установки ПО Game-Keeper должен иметь две сетевые карты. Один сетевой интерфейс используется для связи сервера с игровым оборудованием в зале: игровые контролеры, турникеты, контролер с принтером, уничтожители тикетов. Второй сетевой интерфейс для связи сервера с кассовыми терминалами, платёжными терминалами, инфо-терминалами и офисными компьютерами. На втором сетевом интерфейсе также необходимо наличие интернета для обновления системы и возможности удаленной поддержки сотрудниками Game-Keeper.
Для организации дискового пространства и повышения скорости обработки данных рекомендовано использовать SSD жесткие диски (для операционной системы и базы данных). Также необходимо предусмотреть отдельный жесткий диск (возможно обычный HDD) для резервного копирования БД.
Также для безопасности рекомендовано использовать на сервере источник бесперебойного питания (лучше всего управляемый по сети).
Состав дистрибутива и предварительные настройки
Актуальный дистрибутив для установки ПО "Game-Keeper" можно скачать с официального сайта компании www.game-keeper.com в разделе "Поддержка", либо по запросу в отделе технической поддержки Game-Keeper: support@game-keeper.com.
Дистрибутив представляет собой файл архива, например, stable_428_26.06.2024.7z. Состав дистрибутива приведен ниже.
Папка 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, импорта товаров/продаж в программу складского учёта StoreHouse 4.
Папка gkOther – утилиты для работы (конфигурирование, загрузка прошивок, мониторинг) с проводными и беспроводными контролерами/точками доступа.
Папка gkPos – исполняемые модули ПО "Касса GK".
Папка gkReports – исполняемые модули ПО "Управление пользователями" и "Кубы GK".
Папка gkRpl8 – дистрибутивы и исполняемые модули служб репликации данных для корпоративной версии.
Папка 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. Следует создать правила как для входящих, так и исходящих соединений. Базовые порты, которые необходимо "открыть":
TCP-порты:
211 – порт Borland Socket Server;
1433 – порт MS SQL Server;
5200 - порт сервиса интерактивных отчетов;
5556 – порт службы gkHost;
50300, 50301 – порты службы gkPosServer;
50220 – порт gkRptServer;
50010, 60010 – порт службы gkConfigurator (web-отчеты);
50100, 60100 – порт SSRS.
UDP-порты:
18251 - порт службы gkHost;
18252 - порт утилиты gkTools
Добавить в исключения антивирусного программного обеспечения все папки с исполняемыми модулями и дистрибутивами GK.
Если на объекте будут использоваться другие технологии GK, например, из семейства WEB или планируется инсталляция корпоративной версии GK, необходимо добавить к этому списку порты из инструкций по установке соответствующих модулей.
Из дистрибутива GK папки GK, MSSQLDB, BACKUPDB скопировать в корни дисков, которые планируется использовать под создание БД – MSSQLDB, резервное копирование (бэкап) – BACKUPDB, исполняемые модули – GK.
Например, на сервере имеется 3 жестких диска: 1-й диск SSD - операционная система Windows, 2-й диск SSD – база данных и исполняемые модули ПО, сюда необходимо скопировать папки GK и MSSQLDB, 3-й диск HDD – для резервного копирования (создание бэкапов БД), сюда необходимо скопировать папку BACKUPDB.
Для корректной работы утилит по конфигурации контролеров и точек доступа необходимо установить клиент Telnet через компоненты Windows.
Согласно Общим требованиям к объектам перед инсталляцией на сервере должно быть две сетевые карты. Один сетевой интерфейс предназначен для игрового оборудования (контролеры, турникеты, точки доступа и т.д.), другой для офисной сети и интернета. Для каждого интерфейса должен быть организован отдельный физический сегмент локальной сети. То есть необходимо иметь минимум два раздельных основных коммутатора, подсоединенных каждый к своему сетевому интерфейсу. Соединять свитчи между собой НЕДОПУСТИМО! Если на объекте используется активное сетевое оборудование и управляемые свитчи, то в таком случае необходимо сконфигурировать две раздельных и непересекающихся VLAN, одна из которых по аналогии с физическим свитчем будет использоваться под игровое оборудование, другая под офисную сеть и интернет. На момент настройки сервера оба сетевых интерфейса должны быть активными. На сетевом интерфейсе для игрового оборудования необходимо выставить следующие настройки.
Этот ip-адрес в дальнейшем будет использоваться для конфигурирования служб gkAgent и gkHost!
Последним этапом подготовки сервера к установке ПО "Game-Keeper" является Установка и настройка SQL Server 2017 Express.
Создание БД через Microsoft SQL Server Management Studio (рекомендуемый быстрый способ)
В дистрибутиве версии GK в папке ..\BACKUPDB находится файл чистой (дефолтной) базы данных gkArcade_429_Clear.bak
Стоит средствами Microsoft SQL Server выполнить процедуру Восстановления базы данных, указав при этом на данный файл бэкапа.
Размещение базы данных при восстановлении стоит указать папку MSSQLDB, которая копируется из дистрибутива версии в корень диска, предназначенного для хранения базы данных GK.
Проверим создание базы данных через Microsoft SQL Server Management Studio.
Также файлы базы данных должны создаться по пути указанному нами пути.
Создание БД через 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.
Тип станции зависит от того, какие модули будут использоваться на данном компьютере. Если это просто сервер и на нем не планируется использовать приложение "Редактор", следует выбрать тип станции – Сервер. Если же наоборот это компьютер менеджера и на нем будет установлено приложение "Редактор", а сервером является другой компьютер, то тип станции необходимо выбрать – Рабочая станция. Если же компьютер, где производится установка и настройка является одновременно сервером и компьютером менеджера, то тогда необходимо указать тип станции смешанный – Рабочая станция и сервер.
"Режим работы" предлагает к выбору 3 позиции: Автономный объект, Сетевой объект- центр, Сетевой объект- филиал в зависимости будет ли использоваться корпоративная версия с репликацией данных или нет.
В блоке "Настройка базы данных" указываем подключение к базе данных SQL gkArcade, где вводим имя пользователя sa и пароль.
!!!После ввода всех настроек, а также при переключении между вкладками необходимо нажимать кнопку "Сохранить".
2. Вкладка "Управление пользователями и Отчеты".
На вкладке вводятся настройки для модулей "Пользователи" и "Кубы GK". Настройки делаются в двух блоках: Подключение к MSSQL и Клиент/Сервер. В первом блоке "Подключение к MSSQL" необходимо сконфигурировать строку подключения, для этого нажимаем в конце строки на три точки и попадаем в стандартное окно настроек подключения к БД. Здесь на первой вкладке "Поставщик данных" проверяем, что выбран Microsoft OLE DB Provider for SQL Server, на второй вкладке "Соединение" указываем имя сервера, пользователя sa и пароль, ставим галочку запомнить пароль, выбираем базу данных gkArcade и делаем проверку соединения. Если учетные данные введены верно, то проверка соединения должна пройти успешно, база gkArcade должна быть доступна к выбору.
В блоке "Клиент/сервер" указываем только ip-адрес сервера. В нашем случае все находится на одном компьютере (сервере), поэтому указываем локальный ip 127.0.0.1. Если сервер находится на другом физическом компьютере, то следует указывать явный ip-адрес сервера.
3. Вкладка "INI файлы GK".
На вкладке производится настройка подключения основных модулей GK к базе данных gkArcade. Вносимые здесь изменения напрямую сразу попадают в .ini-файлы соответствующих модулей. По умолчанию все поля в этом разделе заполнены дефолтными значениями.
Кассовый сервер (gkPosServer) – в блоке "Настройки подключения к БД" имя сервера – 127.0.0.1, имя базы данных – gkArcade, пользователь – sa, пароль от sa в зашифрованном виде - 4F74999A405D97450D61241085055AC4 (соответствует паролю на пользователя sa - 1q2w3e777!). Как зашифровать пароль смотрите в конце этой статьи в разделе Работа с утилитой для шифрования паролей.
Порт gkPosServer по умолчанию – 50330. Уровень логирования по умолчанию – 10. Также на этой вкладке настраивается подключение к R-Keeper CRM и параметры работы сервера в конфигурации для корпоративной версии с репликацией данных.
По аналогии с настройками кассового сервера заполняется раздел "Редактор". На вкладке добавлены два блока настроек: "Подключение к серверу" и "Подключение к кассовому серверу".
В блоке "Подключение к серверу" указываются настройки подключения к собственному серверу приложений ПО "Редактор". Таковым является компонент gkMServer. Находится в папке gkEditor. Сервер приложений GK работает не как служба Windows, а как приложение DCOM. В блоке "Настройка подключения к БД" указываются настройки подключения к базе данных именно этого сервера, изменения вносятся в его .ini-файл gkMServer.ini.
Подключение Редактора к gkMServer осуществляется посредством Borland Socket Server, поэтому в настройках подключения к серверу указывается адрес и порт, где запущена служба Borland Socket Server. Порт Borland Socket Server по умолчанию - 211. Настройки из этого раздела автоматически вносятся при сохранении в gkEditor.ini.
В блок "Подключение к кассовому серверу" указываются настройки подключения ПО "Редактор" к gkPosServer через библиотеку gkMgrExt.dll. Через данную библиотеку в приложении "Редактор" производится регистрация карт, групповая активация карт. Настройки, указанные в этом блоке при сохранении, попадают в gkMgrExt.ini.
Также на этой вкладке настраивается подключение к R-Keeper 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\Editor.
Проверяем статус службы Borland Socket Server на вкладке "Управление" в утилите Configurator.exe.
Как отмечалось выше, сервером приложений для "Редактора" является gkMServer.exe. На текущий момент единственный сервер в системе, который реализован не как служба Windows, а как приложение DCOM. Располагается в том же каталоге ..\GK\Editor, что и исполняемый модуль gkEditor.exe (Редактор). Приложение требует первичной регистрации.
Для регистрации данного сервера приложений можно воспользоваться одним из способов:
- В этой же папке gkEditor имеется service_registration.bat, который необходимо, запустить от имени Администратора.
- Создать ярлык запускаемого файла gkMServer.exe, в его свойствах указать ключ -regserver и запустить этот ярлык от имени Администратора (Рекомендуемый способ!).
В обоих случаях после проделанных действий необходимо запустить и выгрузить gkMServer.exe, щелкнув по файлу два раза левой кнопкой мыши, или навести курсор и нажать Enter на клавиатуре. При запуске в трее появится иконка этого сервера приложений . Нажать правой кнопкой мыши на иконке и выбрать Exit. Далее необходимо произвести некоторые настройки в самом приложении «Редактор».
Ярлык для запуска в папке GK на рабочем столе:
Запуск приложения «Редактор» возможен при наличии лицензионного ключа защиты Guardant, с прописанным в него модулем «Редактор». В нашем случае и сервер с БД, и Редактор размещены на одном физическом компьютере, поэтому в лицензионном ключе прописаны серверный модуль и модуль для запуска приложения "Редактор".
Если на объект лицензируется при помощи онлайн лицензирования (виртуальные ключи), то убедиться что в конфигурационном файле gkEditor.ini расскоментированы параметры:
[Settings]
CloudV = 1
В таком случае приложение Редактор будет брать лицензию через gkPosServer, который в свою очередь запускается с параметром -licT1, что означает метод лицензирования Онлайн!
Учетная запись для входа Администратор с паролем 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 и оплаты кодов (актуальная стоимость указана на странице заказа), на почту, указанную при подаче заявки, придет два файла: ХХХХХ(1-1000).xls – файл с данными для производства игровых карт; другой ХХХХХ(1-1000).txt – файл кодами и электронно-цифровыми подписями карт для регистрации в БД Game-Keeper на объекте. Здесь ХХХ – код корпорации, (1-1000) – диапазон кодов.
В приложении "Редактор" на верхней панеле выбираем справочник Карты, далее Регистрация карт. Нажимаем на … и указываем путь к файлу с кодами/подписями, нажимаем "Выполнить".
Стоит отметить, что при нажатии на … для указания пути к файлу с кодами/подписями, система по умолчанию открывает папку, где расположен gkEditor, поэтому рекомендуется при получении файла с кодами/подписями, копировать его именно в эту папку, чтобы всегда знать и отслеживать коды для каких диапазоны карт присылались и загружались.
При успешной регистрации карт система выдаст сообщение.
После операции регистрации карт требуется также перегрузить службу gkPosServer (см. выше)!!!
Как работать в приложении "Редактор" рассматривается в соответствующем разделе «Руководства пользователя».
Кубы GK
До версии Game-Keeper 4.12 отчеты в системе были представлены приложением Reports_Manager, в состав которого входили как сами отчеты так и кубы (OLAP отчёты), где пользователь самостоятельно мог выбирать размерности и фильтры для запрашиваемых данных. Начиная с версии 4.12, программный комплекс Game-Keeper отказался от устаревшего модуля отчетов, был осуществлен переход на отчеты с использованием SSRS и WEB-технологий (web-отчеты). Но технологию OLAP и кубы решено было временно оставить в модуле Reports_Manager. Поэтому модуль "Кубы GK" есть ничто иное, как модуль Reports_Manager (Отчеты) с наличием в нем только отчетов по технологии OLAP.
Основные технические настройки модуля "Кубы GK" осуществляются через утилиту Configurator.exe. В рамках данной инструкции стоит проверить статус служб, отвечающих за работу модуля и сделать настройки в самом модуле.
Исполняемые файлы модуля "Кубы GK" располагаются ..\GK\gkReports.
Службы, отвечающие за функционирование данного модуля.
Ярлык для запуска в папке GK на рабочем столе. Изначально при выносе ярлыка через Configurator, он называется «Отчеты». Переименовываем в «Кубы GK».
Учетная запись для входа Администратор с паролем 1. У этой учетной записи должны быть проставлены права на вход в модуль "Отчеты" и возможность осуществлять настройки (Права проставляются в модуле, описанном ранее "Пользователи и права").
Общий вид рабочего окна приложения.
Чтобы избежать путаницы переименовываем папку "Отчеты" в "Кубы GK".
Далее настраиваем подключение к базе данных gkArcade. Для этого на главной панели входим в Настройки – База данных, нажимаем иконку "Добавить". В появившемся окне вводим Название – GKDB, Тип соединения выбираем – Datasnap, IP Adress – 127.0.0.1 (адрес службы сервера Отчетов), порт – 50220 (по умолчанию порт сервера отчетов), ClassName – Tcinema_Reports_DM.
Нажимаем кнопку "Тест соединения".
После вывода сообщения об успешном соединении, нажимаем ОК и сохранить .
Далее необходимо добавить фильтр для отчетов. Выбираем на главной панели Настройки – Фильтры, нажимаем иконку "Добавить". В появившемся окне вводим Название – GKFILTER, Имя DLL-файла в ниспадающем окне выбираем GKRPTFILTER.DLL, сохранить , Закрыть.
Теперь осуществляем импорт кубов. Выбираем на главной панели Отчеты – Импорт группы отчетов. В появившемся окне указываем База данных – GKDB (созданная ранее), Путь к отчетам – путь к папке Reports, ставим галочку Фильтр и выбираем наш фильтр, созданный ранее, ставим галочку "Перезаписать источники данных".
Нажимаем кнопку "Импортировать". Происходит импорт шаблонов кубов в базу данных.
Нажимаем кнопку "Закрыть". Кубы отобразятся в главном окне.
Далее для каждого отчёта необходимо настроить поля для отображения в отчетах. Для этого выбираем куб, в правом окне выбираем вкладку "Дополнительно", нажимаем кнопку "Стандартные настройки", автоматически проставятся галочки, нажимаем сохранить .
Настройка при создании подключения к базе данных.
В поле IP Adress всегда рекомендуется указывать реальный IP-адрес сервера!!! Например, адрес типа 192.168.1.100. Как в нашем примере адрес 127.0.0.1 применяется исключительно, когда в системе один компьютер является и сервером, и компьютером менеджера. Если на объекте присутствуют другие компьютеры, на которых устанавливается модуль «Кубы GK», обязательно указывать явный IP-адрес. Вносимые в эту форму настройки хранятся в базе данных gkArcade и являются едиными для всех устройств в системе Game-Keeper. Так как служба сервера отчетов запущена на сервере, то доступ к ней по адресу 127.0.0.1 с компьютера менеджера будет уже неверный и подключиться не удастся. А адрес, например 192.168.1.100, будет верный как для подключения с сервера, так и для подключения с остальных компьютеров, на которых планируется пользоваться модулем «Кубы GK».
Установка и настройка вэб. Отчетов (SSRS)
Технология SSRS, а также разворачивание и настройка web-отчетов подробно описаны в документе Настройка WEB-отчётов (SSRS).
Установка и настройка интерактивных отчетов (ReportSystem)
Технология Интерактивных отчетов, а также разворачивание и настройка этого механизма подробно описаны в документе Инсталляция интерактивных отчётов (ReportSystem)
Отложенные отчеты GK
Для возможности отправки отчетов по расписанию на электронную почту выбранным пользователям (например, директору отчет по выручке за предыдущий день), на объекте должен быть установлен SQL Server 2017 не ниже версии Standart. Версия ПО Game-Keeper должна быть 4.12 или более поздняя. Также должны быть установлены и настроены отчеты SSRS (WEB-отчеты).
1. Настройка Microsoft SQL Server Reporting Services.
Заходим в Диспетчер SSRS, подключаемся к серверу, выбираем вкладку "Настройки электронной почты" и заполняем поля.
Для настройки отправки отчетов по расписанию необходимо, чтобы служба SQL Agent была запущена. Проверить это можно в Диспетчере конфигурации SQL Server. При необходимости запустить.
2. Настройка расписаний отложенных отчетов.
Запускаем ярлык WEB-отчетов из папки GK на рабочем столе/
Выбираем отчет, который необходимо генерировать и отправлять по расписанию на e-mail, нажимаем в правом верхнем углу плитки отчета на … и выбираем "Подписаться".
Далее необходимо заполнить параметры подписки. Заполнить "Описание" – целесообразно называть по названию отчета и периодичности отправки, заполнить "Место назначения" - почта или папку на сетевом ресурсе.
Для отправки по расписанию, необходимо создать расписание, нажав кнопку "Изменить" расписание.
В указанном случае, отчет будет генерироваться и отправляться ежедневно в 8 утра.
Далее нужно заполнить варианты доставки, указать адреса электронной почты, тему письма, в каком формате доставлять и включать ссылку на этот отчет или нет. Тема - это шаблон, по которому будет называться письмо, приходящее на e-mail. Формат отображения по умолчанию стоит MHTVL (веб-архив). При таком формате отчет корректно отобразится в теле самого почтового отправления. Можно также выбрать другие форматы по желанию: Word, Exel, PDF… Галочка "Включить ссылку" дает возможность прикрепить к письму ссылку на этот отчет, пройдя по которой мы уже в браузере увидим отчет, с указанными фильтрами.
Последним этапом выставляем параметры (фильтры) отчета, например, диапазон дат или иной тип группировки данных, нажимаем "Создать подписку".
Управлять подписками можно выбрав отчет, на плитке отчета в верхнем правом углу нажать …, далее "Управление".
Далее слева выбрать вкладку "Подписки".
На указанную в подписке почту в заданное время будет отправлен отчет. На скриншоте ниже показано, как отработал шаблон Темы в рассылке @ReportName был выполнен в @ExecutionTime - @ReportName – название отчета, в нашем случае Выручка, @ExecutionTime – время выполнения.
Также на рисунке ниже видно, как отрабатывает галочка "Включить ссылку". Внизу отчета прикрепляется ссылка на этот отчет.
Если на объекте имеется белый IP-адрес и настроен проброс портов на SSRS, то отчёт можно увидеть в браузере на любом устройстве, нажав на ссылку. В нашем примере адрес ссылки локальный.
Настройка бэкапов и клинера через Планировщик задач Windows и Powershell
Для безопасности функционирования системы Game-Keeper, а также сохранности всех данных по игровому центру/парку, хранящихся в базе данных MS SQL Server gkArcade, необходимо осуществлять настройку автоматического резервного копирования БД (создания бэкапа БД).
Сотрудниками Game-Keeper был реализован механизм создания резервных копий основной БД gkArcade на основе встроенного ПО Windows PowerShell с применением Планировщика Windows.
Ранее указывалось, что для создания и хранения резервных копий БД желательно выделить отдельный жесткий диск. На него мы копировали папку BACKUPDB из дистрибутива версии GK. В каталоге BACKUPDB находится папка jobs с скриптами Windows PowerShell Backup.ps1 и Cleaner.ps1, которые будут применяться для создания резервных копий. Для начала отредактируем эти скрипты под текущий сервер GK. Они становятся доступны на редактирование при открытии через обычный блокнот. В теле скрипта Backup.ps1 указываем название сервера и путь к папке BACKUPDB:
# Configuration variables.
[string]$server ="GKSERVER\GAME_KEEPER"; # Server instance name.
[string]$dest ="D:\BACKUPDB\"; # Folder to backup to. If empty the default backup folder is used.
Здесь GKSERVER сетевое имя сервера, которое задавалось при предварительной настройке сервера.
Отредактируем скрипт Cleaner.ps1:
$path = “D:\BACKUPDB\”; #path for search – путь к папке с бэкапами
$days = 30; #keep files for the last two days – количество дней, сколько стоит хранить бэкапы
Get-ChildItem -path $path"\*" -include *.bak | ?{$_.creationtime -lt $(Get-Date).adddays($days*-1)} | Remove-Item –Force;
Скрипт Cleaner.ps1 очищает папку BACKUPDB с бэкапами базы, оставляя в ней только то количество АКТУАЛЬНЫХ бэкапов, которое указано в теле скрипта. В нашем примере это 30 дней. То есть на сервере будет постоянно храниться 30 последних бэкапов БД. При желании это количество можно уменьшить или увеличить. Это полезно для организации рационального использования дискового пространства. Раньше диски забивались бэкапами, так как не было ограничений на количество их создания.
Далее необходимо изменить политику безопасности Windows PowerShell. Для этого необходимо запустить Windows PowerShell от имени Администратора и выполнить команду set-executionpolicy remotesigned.
Система предложит выполнить действия с политикой, нужно набрать Y и нажать Enter. Затем открываем Планировщик заданий Windows.
В корне библиотеки планировщика создаем папку GK.
Выбираем созданную папку GK и нажимаем "Создать простую задачу", вводим имя нашей задачи и проходим "Далее".
На следующих шагах выбираем периодичность выполнения задачи.
Далее выбираем действие.
Следующим этапом определяем параметры запуска программы. Программа или сценарий: powershell.exe.
Аргумент (обязательно): -command D:\BACKUPDB\jobs\Backup.ps1
На завершающей стадии создания простой задачи следует поставить галочку "Открыть окно "Свойства" для этой задачи…" и нажать "Готово".
После создания задачи откроется ее свойства, где мы выставляем на вкладке "Общие" приоритет – Выполнить с наивысшими правами.
На вкладке "Параметры" определить продолжительность выполнения задачи, после которого система понимает, что задача зависла или что-то пошло не так. Это необходимо для рационализации мощностей сервера, так как выполнение задачи дает нагрузку на процессор и оперативную память.
Теперь мы можем проверить выполнение, созданной нами задачи, выбрав задачу и нажав "Выполнить".
Начнется выполнение скрипта Windows PowerShell.
В результате выполнения задачи должен создаться файл бэкапа в указанной папке D:\BACKUPDB. Файл должен иметь название типа gkArcade_full_2020-04-09.bak. Как мы видим в названии файла бэкапа присутствует название БД и дата создания.
По этой дате будет отслеживать наполняемость папки и актуальность данных скрипт Cleaner.ps1. По аналогии с предыдущим скриптом необходимо создать задачу Cleaner_GK. Разница будет только во времени начала выполнения задачи и в аргументе, который в этом случае стоит указать.
Аргумент (обязательно): -command D:\BACKUPDB\jobs\Cleaner.ps1
Время начала следует поставить не менее чем на час большим времени начала выполнения скрипта для создания бэкапа.
Конечным результатом действий должно стать появление двух задач, ежедневное выполнение которых обеспечит создание актуальной резервной копии рабочей БД gkArcade и поддержание этой актуальности на необходимой глубине.
Для большей избыточности и безопасности рекомендуется дополнительно организовать копирование файла бэкапа на альтернативный носитель или на удалённый сетевой ресурс!
Работа с утилитой для шифрования паролей
Все пароли для пользователя "sa" в .ini-файлах системы Game-Keeper указываются в зашифрованном виде. В остальных других случаях пароль от учетной записи системного администратора SQL Server “sa” указываются в явном виде! Для создания и смены пароля в зашифрованном виде для .ini-файлов GK пользуются утилиты gkPW.exe и gkPWn.exe. По умолчанию они находятся в дистрибутиве версии GK в папке Other.
Утилита gkPWn.exe – для создания нового пароля.
Утилита gkPW.exe – для смены старого пароля.
Принцип работы утилит одинаковый.
Пример создания нового пароля.
Запускаем утилиту gkPWn.
Указываем путь к файлу конфигурации, в котором необходимо установить зашифрованный пароль. В нашем примере это путь к gkPosServer.ini. Вводим пароль (по умолчанию в системе GK это 1q2w3e777!), подтверждаем пароль и нажимаем "ОК". Проверяем файл конфигурации.
Теперь этот пароль в зашифрованном виде можно скопировать во все файлы конфигурации в системе GK через Configurator.exe на вкладке "INI файлы GK". Также это можно сделать вручную, скопировав эту последовательность в каждый .ini-файл в параметр Password.
Лицензирование модуля сервер GK на виртуальном ключе
Более подробно про метод лицензирования на виртуальном ключе можно узнать из статьи Лицензирование на виртуальном ключе. Установка и настройка.
Лицензирование модуля сервер GK на физическом ключе
Для продления или изменения лицензии необходимо воспользоваться утилитой Licence.exe (находится в директории Редактора - gkEditor и Кассы - gkPos). При инсталляции объекта сотрудниками Game-Keeper, ярлык, ссылающийся на данную утилиту, выносится на рабочий стол.
Запустить утилиту. На первой вкладке "View" cкопировать код из поля "Session code" или сделать вычитку ключа, нажав кнопку 
, и отправить его с запросом на продление/изменение лицензии на e-mail: support@game-keeper.com. Обработка запросов и генерация новых лицензий производится по мере поступления в течение рабочего дня, или на следующий рабочий день.
После получения нового кода Game-Keeper™ необходимо перейти на вкладку "Set", ввести полученный код в специальное поле и нажать кнопку "Set".
При успешной операции лицензия будет продлена. Проверить это можно, вернувшись на первую вкладку "View" в значении поля "expired at:".
Более подробная информация о лицензировании на физических ключах в статье Лицензирование ПО Game-Keeper™, модули и ключи.