Оглавление |
---|
Общие требования к серверу GK
Сервер для ПО "Game-Keeper" это основной и обязательный компьютер в системе. Предназначен для хранения базы данных и обработки запросов от модулей системы GK. К компьютеру, использующемуся в качестве сервера, должны предъявляться повышенные требования по быстродействию, отказоустойчивости и безопасности хранения данных.
Минимальные требования к выделенному серверу для работы серверного ПО приведены в Общих требованиях к объектам перед инсталляцией. Эти минимальные требования обусловлены спецификой работы 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™, модули и ключи.