ВведениеLink to Введение

Главный сервер системы r_keeper_7 или сервер верхнего уровня —  это Сервер Cправочников (References Server). Он запускается первым при настройке системы. 

Исполняемый файл сервера справочников — refsrv.exe.

Имя конфигурационного файла по умолчанию — rk7srv.ini.

При установке RK7 из дистрибутива, архива на фтп в папке ftp.ucs.ru/versions, файл rk7srv.ini нужно скопировать из папки \bin\win\ini\ в рабочую папку \bin\win\, где лежит refsrv.exe.

При установке ПО из инсталлятора сервер с конфигурационным файлом лежит в папке [путь установки\имя экземпляра\Rk7Reference].

Примечание

Названия сервера, файла настроек и базы данных могут быть любыми, но по умолчанию сервер будет искать файл настроек rk7srv.ini. При использование других конфигурационных файлов читайте ниже в разделе Запуск.

ЛицензированиеLink to Лицензирование

Если вы хотите смотреть отчеты, то необходимо пролицензировать сервер справочников. Лицензия привязывается к полному коду объекта, коду ключа и аппаратным компонентам компьютера, на который устанавливают сервер.

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

Для лицензирования сервера справочников:

  1. Укажите код корпорации в параметрах

    1. Укажите Код корпорации , который был получен в системе лицензирования в параметр Код предприятия. Для этого перейдите в Настройки > Параметры > Установочные и укажите число в поле Код

    2. Код объекта из системы лицензирования необходимо указать в свойствах ресторана.
      Для этого перейдите в Сервис > Станции и устройства и выберите требуемый ресторан.
    3. Укажите в поле Код свой код объекта
    4. Согласитесь с подтверждениями и сохраните изменения.

  2. Перейдите в меню Настройки > OLAP отчеты > Серверы отчетов
  3. Выберите сервер справочников, разверните группу свойств Информация о лицензии
  4. Выберите ключ защиты. Ключ может быть как виртуальный, так и физический. Для подключения физического ключа требуется драйвер Guardant.
    Начиная с версии RK7 7.06.05.399 по умолчанию используется виртуальный ключ защиты. Если вы хотите использовать виртуальный ключ, его следует сгенерировать:

    1. Выделите требуемый сервер справочников и в разделе Основное заполните поле Обслуживает ресторан
    2. Сохраните изменения
    3. В разделе Информация о лицензии нажмите левой кнопкой мыши в поле Ключ защиты - Физический номер
    4. Нажмите на кнопку  для генерации кода ключа и согласитесь с предупреждением
    5. В поле Ключ защиты - физический номер появится код ключа
  5. Сгенерируйте запрос лицензии. Нажмите правой кнопкой мыши на Сервер справочников и Действия > Сгенерировать запрос лицензии
  6. Сгенерируется запрос лицензии в системе лицензирования. Обратите внимание, что у объекта должна быть мастер-лицензия с типом ПО RKeeper 7 Report Server
  7. Впишите ее в поле Лицензионный ключ
  8. Сохранить изменения.

Лицензирование сервера справочников при использовании виртуального ключаLink to Лицензирование сервера справочников при использовании виртуального ключа

Обязательно заполните поле Обслуживает ресторан. Это должен быть ресторан, отличный от Центрального офиса.

Если ваша версия r_keeper ниже 7.06.05.399, то перед генерацией виртуального ключа пропишите в rk7srv.ini параметр:

[RefServer]
UseNetChecking=1
CODE

И перезагрузите сервер справочников.

Запуск сервера справочниковLink to Запуск сервера справочников

Для запуска сервера необходимо внести изменения в файл rk7srv.ini: в секции [Refserver] добавьте имя сервера — параметр Server и параметр UseSql:

Server = RK7SRV_3001    ; сетевой ID сервера справочников
UseSql = 0              ; т.к. связи с внешней БД ещё нет
CODE

Сохраните изменения.

Теперь запустите сервер. Запустить сервер можно двумя способами

  1. В виде приложения
  2. В виде отдельной службы.

Первый запуск необходимо выполнить как приложение.

Для запуска сервера в виде приложения перейдите в папку ...RK7\bin\win и найдите файл refsrv.exe. Создайте ярлык файла и откройте его свойства. Во вкладке Ярлык в поле Объект добавьте после адреса пробел и допишите /desktop:

Убедитесь, что запуск будет производиться от имени администратора.

По умолчанию конфигурационный файл приложения — rk7srv.ini. Если необходимо запустить Сервер справочников с другим ini-файлом, то используйте команду: refsrv.exe /ininame: newname.ini /desktop.

После запуска сервера как приложения в области уведомлений Windows должен появиться значок .

В зависимости от выполняемых задач значок сервера может быть трех цветов:

  • Зеленыйобычная работа сервера
  • Желтый — обработка данных, например загрузка, редактирование, пересчет кубов и т.д. Сервер загружается
  • Красный — сервер остановлен.

Двойное нажатие по значку открывает информационное окно сервера:

Для запуска сервера как службы дважды нажмите на файл refsrv.exe и следуйте инструкциям диалога. Либо запустите сервер с параметром /install.

После установки службы запустите ее. 

Службы r_keeper_7 необходимо запускать от учетной записи с правами администратора.

Использование политики паролейLink to Использование политики паролей

Начиная с версии 7.7.0 и 7.6.5.483 добавлен параметр Использовать политики для паролей.

Этот параметр можно задать в двух местах:

  • В ini-файле сервера справочников refsrv.ini
  • В менеджерской станции. При этом значение, заданное в менеджерской станции, перекрывается настройкой в ini-файле.

Для включения параметра в ini-файл, добавьте в файл секцию [CONFIG] и пропишите в ней параметр UsePasswordPolicy=1:

[CONFIG]
UsePasswordPolicy=1
CODE

Сохраните изменения и перезапустите сервер справочников.

После включения параметра к пользователям начнет применятся политика паролей.

Настройка связи с внешней БДLink to Настройка связи с внешней БД

Для просмотра кубовых отчетов из менеджерской станции необходимо настроить связь с внешней базой данных SQL. Подробнее об этом читайте в статье Настройка связи с MS SQL

О настройке интерактивных отчетов читайте в статье Настройка плагина интерактивных отчетов.

Отчеты формируются по данным, поступающим из кассового сервера после закрытия общей смены на кассовой станции.

Примечание

Часто служба refsrv загружается раньше MS SQL сервера. Из-за этого refsrv на этапе запуска прекращает работу с ошибкой доступа к БД SQL. Для решения проблемы необходимо настроить зависимости служб в Windows.

Описание настроек сервера справочниковLink to Описание настроек сервера справочников

Параметр

Значение по умолчанию

Описание

[REFSERVER] 
Основная секция
Server TEST_RK7SRV Cетевое имя сервера справочников
UDBFILE..\..\base\rk7.udb Путь к файлу базы данных справочников. rk7.udb – это имя по умолчанию, его можно поменять на любое
ERRORLOG refsrv.stk Имя файла журнал ошибок
MainLang .\RefSrv.Rus полный путь к файлу перевода данных основного языка
AltLang () полный путь к файлу перевода данных альтернативного языка
WorkModules..\..\base\workmods Путь к базам рабочих модулей кассы
WORKUDB "" полный путь к файлу данных чеков.
BLDCUBELOG 0При значении не 0 ведётся журнал построения кубов BLDCUBE.TXT
ShortTimeout 20000Максимальное время выполнения сетевой операции над одним элементом в мс
LongTimeout 100000Максимальное время выполнения сетевой операции над коллекцией в мс
NoTempMemStream 0Если установлено 1 – при построении кубов не используется промежуточное хранение данных в памяти. 1 – медленнее, но на очень больших данных может понадобиться. Устаревший параметр. Сейчас лучше использовать свойство куба «Тип источника»
UpgradeAnyTime 0Если установлено 1, не проверяется версия базы и всегда происходит попытка выполнить upgrade, если обнаружен файл upgrade.udb
UpgradeTranslateRussian 0Если установлено 1, установленные значения на основном языке переводятся при создании новой базы не с английского, а с русского. После создания новой базы языки поменять будет уже нельзя.
UpgradeAltTranslateRussian 1Если установлено 1, предустановленные значения на альтернативном языке переводятся при создании новой базы не с английского, а с русского
CubesRecalc 0Отключение пересчета кубов, 1 – включение пересчета кубов, 2 – пересчет кубов только в ручном режиме для версий 7.6.1.2 и выше.
NoReports 0Отключение меню с отчетами в менеджерской станции – для версий 7.6.1.2 и выше
UnknownIdFormat(“Id=%d”)
Формат вывода информации о ненайденном элементе (в отчетах/кубах). Вместо %d будет указан идентификатор элемента.
UseSQL 1Подключение к SQL-серверу. 0 – выключено, 1 – включено.
MaxCubeCalcs 2Максимальное число параллельно считаемых кубов. Для SQL имеет смысл увеличить, если сервер многопроцессорный.
DisableSMARTVerify1Не отправлять запросы SMART к IDE устройствам или их эмуляторам при генерировании лицензии. Только для версий 7.4.17.31 и выше. Этот параметр используют при генерации лицензии для кассового сервера в многопроцессорных системах, на которых установлен сервер справочников.
EventCachePathC:\path\ Укажите путь, если хотите чтобы сервер справочников хранил последние изменения в файле RefEvents.dat. Это позволит высылать не всю коллекцию, а только ограниченный список изменений. Параметр будет работать, только если на кассовом сервере или сервере отчётов включено PollEvents
[REFEDIT]  Для прямых отчетов параметры ConnectionString можно перенести в INI-файл
Server "IMxREPS1x0"Имя сервера
Client "IMxMNGRx%RANDOM%"
SQLServerLink "ProviderСтрока подключения к MS SQL
[NETKERN] 
Секция сетевого протокола. Возможные варианты nbhdup.dll,spxsoc.dll
Protocolstcpsoc.DLL   Полный путь к файлу tcpsoc.DLL
[TCPSOC]
Секция TCP/IP
PORT3639порт сервера для входящих соединений
[CubeDLL]
Секция настроек CubeDLL.dll. Данная секция поддерживается начиная с версии 7.0.21.2
CommandTimeout 30Время в секундах на выполнение SQL запроса для куба
[Config]  
В случае, если сервер справочников выполняет функции сервера отчетов необходимо добавить данную секцию в rk7srv.ini
UseShift2SQL1Подробнее об этом параметре – в статье о загрузке смен через Shifts2sql
LoadThreadsCount "4"Загружать данные закрытых смен в накопительную БД параллельно, "4" – число обрабатываемых параллельно файлов (рекомендуется при большом количестве одновременно поступающих файлов смен). Версия должна быть не ниже 7.5.2.328
ErrorLogSize 1048576Размер файла журнала ошибок в байтах
ReceivedPath ".\Received\"Сохранение смены в папке по указанному маршруту, с разделением по ресторанам и кассовым серверам

Для перевода данных справочников необходимо:

  1. В секции [REFSERVER] впишите имя файла основного и дополнительного языка для перевода:

    [REFSERVER]
    MainLang=.\RefSrv.DEU ; основной язык
    AltLang=.\ RefSrv.PLK ; альтернативный язык
    CODE
  2. Для перевода основного языка:

    UpgradeTranslateRussian=0 ; 0 – перевод с английского, 1 – перевод с русского
    CODE
  3. Для перевода альтернативного языка:

    UpgradeAltTranslateRussian=0 ;  0 – перевод с английского, 1 – перевод с русского
    CODE

    Файлы ниже — автоматически создаются после выполнения первого пункта и обновления программы:

  • UPGRADE.DEU2 — при помощи программы Langer.exe, которую можно взять на нашем FTP, необходимо перевести файлы из папки /base
  • UPGRADEDEV.DEU.

Восстановление настроекLink to Восстановление настроек

Внимание! Для восстановления настроек по умолчанию для различных драйверов:

  1. Перейдите в base\drvlocalize и выполните Defparam.exe. 
  2. Выберите в списке defparams.rus
    В версиях до 7.5.2.269 найдите файл readme.txt в той же папке.

При этом пропишутся настройки драйверов по умолчанию. Это особенно важно для универсальных драйверов ФР.

Следующий шаг:
Настройка кассового сервера.