Общие требования к серверу 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!!! Как это делается смотреть описание выше.
Как работать в приложении Редактор: заполнять справочники, заводить игровые контролеры, устанавливать цены, управлять бонусами и т.д. детально рассматривается в документации «Руководство Пользователя».
Кубы 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, то нажав на ссылку, можно в браузере на телефоне или планшете в любой точке мира увидеть наш отчет. В нашем примере адрес ссылки локальный.
Настройка бэкапов и клинера через Планировщик задач Виндовс и 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” в ини-файлах системы Game-Keeper указываются в зашифрованном виде. Стоит понимать, что сейчас речь идет только об “инишниках”!!! В остальных других случаях пароль от учетной записи системного администратора SQL Server “sa” указываются в явном виде!
Для создания и смены пароля в зашифрованном виде для ини-файлов GK пользуются утилиты gkPW.exe и gkPWn.exe. По умолчанию они находятся в дистрибутиве версии GK в папке Other:
Утилита gkPWn.exe – для создания нового пароля
Утилита gkPW.exe – для смены старого пароля
Принцип работы у обоих утилит одинаковый по смыслу.
На примере создания нового пароля:
Запускаем утилиту gkPWn:
Указываем путь к файлу конфигурации, в котором хотим установить зашифрованный пароль. В нашем примере это путь к gkPosServer.ini. Вводим пароль (по умолчанию в системе GK это 1q2w3e777!), подтверждаем пароль и нажимаем ок. Проверяем файл конфигурации:
Теперь этот пароль в зашифрованном виде можно скопировать и расставить во все файлы конфигурации в системе GK через Configurator.exe на вкладке “INI файлы GK”. Также вы это можете сделать руками, вставив эту последовательность в каждый ини-файл в параметр Password.
Лицензирование модуля сервер GK
Для продления или изменения лицензии необходимо воспользоваться утилитой Licence.exe (находится в директории Редактора - gkEditor и Кассы - gkPos). При инсталляции объекта сотрудниками Game-Keeper, ярлык, ссылающийся на данную утилиту, выносится на рабочий стол.
Запустить утилиту. На первой вкладке “View” cкопировать код из поля “Session code” или сделать вычитку ключа, нажав кнопку 
, и отправить его с запросом на продление/изменение лицензии на e-mail: support@game-keeper.com. Обработка запросов и генерация новых лицензий производится по мере поступления в течение рабочего дня, или на следующий рабочий день.
После получения нового кода Game-Keeper™ необходимо перейти на вкладку “Set”, ввести полученный код в специальное поле и нажать кнопку “Set”.
При успешной операции лицензия будет продлена. Проверить это можно, вернувшись на первую вкладку “View” в поле expired at:
