Установка rk6 windows 7

Общие сведения

Важно! RK6WIN не работает на 64-х битных версиях Windows!

Кассовая часть R-Keeper v6, работающая под операционной системой Windows (далее RK6WIN), является отдельной разработкой и не совместима по модулям, библиотекам и т.д. с кассовой версией, работающей в среде DOS.

RK6WIN не является полностью 32-х разрядным приложением (в отличии от R-Keeper V7) — в состав клиента входят также 16-разрядные модули, для работы которых требуется наличие в операционной системе виртуальной машины для 16-ти разрядных приложений (NTVDM). Эта особенность накладывает ограничение на используемые ОС — т.к. в 64-разрядных системах Windows NT отсутствует NTVDM, то и запуск RK6WIN становится невозможным на таких ОС.

При запуске RK6WIN (или любого другого 16-разрядного приложения ) на компьютере с Windows NT автоматически запускаются процессы ntvdm.exe и wowexec.exe. После завершения работы RK6WIN эти процессы не выгружаются из памяти — такое поведение является особенностью Windows NT и позволяет увеличить быстродействие (для RK6WIN, работающего в качестве основного приложения на POS-терминале, такая особенность не является актуальной)

Примечание: После принудительного закрытия RK6WIN процессы NTVDM могут не освобождать некоторые ресурсы, например COM-порт или NetBIOS-имя — для освобождения ресурсов надо принудительно выгрузить из памяти процессы ntvdm.exe и wowexec.exe.

Архитектура RK6WIN и ее отличия от DOS-версии

Несмотря на то, что RK6WIN является отдельной разработкой, кассовый сервер (rkserver.exe) используется стандартный. Для организации независимо работающего кассового места (аналог DOS-сервера) необходимо установить на Windows-компьютер стандартный кассовый сервер (rkserver.exe) и RK6WIN соответствующей версии

Важно! Клавиатурный вариант RK6WIN (отличие только в CALL16.DLL) имеет ограниченную поддержку и отсутствует по-умолчанию в дистрибутиве.

В качестве протокола связи между RK6WIN и кассовым сервером используется все тот же NetBIOS, как и в случае использования DOS-версии. При установке RK6WIN следует помнить об этом факте — поддержка NetBIOS в ОС Windows может быть организована либо с помощью протокола NetBEUI либо включением поддержки NetBIOS в свойствах протокола TCP/IP. В любом случае все также остается актуальным понятие «номер адаптера» (подробнее о номере адаптера см. ниже)!

Таким образом, RK6WIN состоит из специального клиента и стандартного кассового сервера. В составе клиентской части есть отличия в сравнении с DOS-клиентом — большинство файлов имеют такое же название и назначение, но есть некоторые файлы, которые отсутствуют в DOS-версии (например, vga32.dll, wsys.dll и т.д.)

Также есть отличие в механизме запуска RK6WIN — исполняемый файл RK6WIN.EXE используется только для инициализации основного исполняемого модуля CALL16.DLL — когда идет речь об обновлении версии RK6WIN, в первую очередь обновляется CALL16.DLL

В клиенте RK6WIN появилась поддержка нового каталога EXTENS32 для 32-х разрядных модулей расширения — если в описании модуля не указано, в какую директорию необходимо его поместить, копируем его, как и прежде, в директорию EXTENS (либо корневую директорию клиента — зависит от назначения модуля)

Для работы некоторых устройств RS232 требуется драйвер прямого доступа к портам (PORT32.EXE). Еще одной особенностью работы в среде Windows c устройствами RS232 является отсутствие поддержки линии IRQ (поэтому параметр _IRQ, присутствующий во многих DOS-драйверах, отсутствует в Windows-версиях).

Примечание: Драйвер прямого доступа к портам нужен только для приложений, использующих прямой доступ к портам. И необходимость его установки обязательно указана в описании таких приложений(драйверов). Со всеми остальными устройствами, подключаемыми к COM-портам, работа идёт стандартными средствами Windows и для них не требуется дополнительный драйвер.

Дистрибутив RK6WIN и драйвера устройств

Сборка клиента RK6WIN имеет некоторые особенности — полный дистрибутив каждой выпущенной версии не выкладывается разработчиками на ftp-сервер, вместо этого в стандартном дистрибутиве кассы R-Keeper v6 идут только обновленные файлы RK6WIN

Для обновления версии RK6WIN или сборки нового клиента определенной версии, можно использовать следующую схему:

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

Примечание: В стандартном дистрибутиве кассы обновленные файлы для RK6WIN находятся в каталоге \KACCA\STATIONS\WIN

Клавиатурная касса

Клавиатурный вариант кассы отличается от стандартной RK6WIN только файлом CALL16.DLL. Обновления для клавиатурной кассы не включаются в стандартный дистрибутив, а предоставляются по запросу (например, через трекер).

Важно: Клавиатурный вариант Windows-кассы будет корректно работать только с клавиатурой Mitec KB-99-128 со специальной прошивкой ftp://ftp.ucs.ru/r-keeper/Tools/MITEC/KB99B-128-WIN.LED

Универсальная касса

Универсальная касса отличается от стандартной RK6WIN только файлом CALL16.DLL. Обновления для универсальной кассы не включаются в стандартный дистрибутив, а предоставляются по запросу (например, через трекер)

Драйвера устройств

Все устройства, подключаемые к кассе RK6WIN и требующие для работы специальной поддержки, должны иметь драйвер для кассы, разработанный с учетом использования ОС Windows.

Драйвера для большинства устройств, поддерживаемых в RK6WIN, поставляются в стандартных дистрибутивах кассы R-Keeper v6. Если драйвер устройства поддерживает работу в RK6WIN, в каталоге, где размещается драйвер данного устройства, будет присутствовать подкаталог WIN.

Например, драйвера для фискальных регистраторов расположены в директории ftp://ftp.ucs.ru/r-keeper/versions/FISC_PRT — в директории каждой отдельной модели ФР могут располагаться подкаталоги DOS и WIN, где размещаются драйвера для DOS и Windows кассы соответственно.

Ниже приведен список каталогов на ftp-сервере, где хранятся драйвера устройств для кассовой части R-Keeper v6:

ftp://ftp.ucs.ru/r-keeper/versions/COM_READ — драйвера для различных считывающих устройств (магнитные, бесконтактные, браслеты и т.д. )
ftp://ftp.ucs.ru/r-keeper/versions/FISC_PRT — драйвера для всех поддерживаемых моделей ФР
ftp://ftp.ucs.ru/r-keeper/versions/SCALE — драйвера для различных моделей весов
ftp://ftp.ucs.ru/r-keeper/versions/SMPAUTH — драйвера для различных моделей банковских пинпадов

Если для устройства нет драйвера в стандартном дистрибутиве кассы, можно проверить каталог ftp://ftp.ucs.ru/r-keeper/versions/WINCAS/DEVICES. Если в данном каталоге драйвер также отсутствует, возможно устройство не поддерживается кассой RK6WIN — в случае необходимости можно оформить запрос на доработку драйвера через трекер.

Примечание: В каталоге ftp://ftp.ucs.ru/r-keeper/versions/WINCAS доступны полные сборки некоторых версий RK6WIN (включая клавиатурную и универсальные кассы), а также некоторые драйвера устройств. Данные сборки протестированы и собраны технической поддержкой — по всем вопросам, связанным с использованием данных сборок, необходимо обращаться на трекер.

Установка RK6WIN

Важно! Для возможности запуска RK6WIN требуется ключ USB Novex II, подготовленный специальным образом! Дилер не может самостоятельно подготовить или прописать такой ключ — его нужно заказывать через офис компании ЮСИЭС!

Как отмечалось выше, в качестве сервера используется стандартный rkserver.exe. Кассовый сервер может быть установлен либо на том же компьютере, где и клиент RK6WIN, либо на отдельном. При этом кассовый сервер может использоваться для подключения других кассовых клиентов, в том числе DOS-станций.

Установка RK6WIN выполняется простым копированием содержимого архива в любую директорию.

Важно! RK6WIN использует собственные шрифт RKEEPER.FON, который нужно установить стандартными средствами Windows. Сам шрифт находится в директории \FONTS.

Параметры RK6WIN хранятся в файле RKEEPER6.INI — поддерживаются практически все параметры обычной версии кассы (DOS), также есть параметры, специфичных только для Windows-кассы:

Примечание: В «чистой» установке Windows присутствует только один протокол — TCP/IP, который по-умолчанию имеет нулевой адаптер — для запуска WIN-кассы достаточно установить поддержку NetBIOS поверх TCP/IP в свойствах протокола.

Если в системе установлено несколько протоколов или несколько сетевых карт, для изменения номера адаптера можно использовать утилиту lanacfg.

Особенности конфигурационного файла RKEEPER6.INI

Если в конфигурационном файле присутствуют секции, то все параметры, который находятся ниже этой секции до следующей секции, будут считаны и интерпретированы как параметры, относящиеся к данной секции. Например, если в середине конфигурационного файла вставить секцию с параметрами, то все нижеследующие параметры будут отнесены к этой секции и перестанут работать:

В этом примере параметры CanManualCardInput и CanManualDiscInput перестанут работать.

Источник

Вводная информация

Перед установкой данного программного обеспечения рекоммендуется ознакомиться с обзорной статьей по Delivery RK6 — http://support.ucs.ru/ru/node/8619.

Системные требования

Для установки модулей Delivery RK6 требуется стандартный ПК офисной конфигурации (P4, ОЗУ- 2Гб, HDD — 10 Гб) под управлением ОС Windows XP PRO и выше.

Примечание: редакция используемой ОС должна быть 32-bit в силу взаимодействия с кассовым сервером RK6 у которого есть известные проблемы совместимости с ОС x64. Рассматривать как рекоммендацию.

Должен быть установлен, настроен, пролицензирован и запущен RK6 (как минимум, — Менеджерская RK6.92 и выше и кассовый сервер — 6.97.8 или выше).
При наличии ПДС — должна быть так же установлена, настроена, пролицензирована стандартным образом (как минимум, — Cardserv, PCards).
Установленый Firebird (обязательно 32-bit, даже если устанавливается на ОС x64).

Версии

ОС Windows XP PRO SP3 и выше (рекомендована разрядность 32-bit)
Менеджерская RK6.92 и выше.
Кассовый сервер 6.97.8 и выше
Если будет задействована касса, например с подключенным ФР — Кассовый клиент (6.97.8) и выше.
Firebird 2.5 (32-bit)
Delivery RK6 v.2.25.7.17 с обновлением до 2.25.7.26

Установка RK6

Установить \RK6 (версии 6.95 менеджер (и выше), 6.97.8 — NT-RKSERVER). Если необходимо печатать фискальные чеки — это возможно ТОЛЬКО через ПО R-KEEPER, то также устанавливается \RKCLIENT соответствующей версии (рекомендуется — 6.97.8).

Подготовительные работы

Подготовительные работы выполняются, как правило, на всех ПК где будут установлены те или иные програмные модули из состава Delivery RK6. К ним же относится и формирование актуального по версии рабочего каталога с необходимыми рабочими модулями Delivery RK6 из дистрибутивов скачанных с ФТП.

Скопировать с ftp://ftp.ucs.ru/dealers/Delivery/RK6/225.7.17/Full/2.25.7.17.zip архив с дистрибутивом к себе на ПК.

Сразу же, можно скопировать необходимое обновление ftp://ftpint.ucs.ru/dealers/Delivery/RK6/225.7.17/Update/2.25.7.17.zip и обновить основной дистрибутив файлами из данного обновления.

Распаковать всё содерживое архива в отдельную папку, например: D:\RK6\Delivery.
Скопировать на рабочий раздел ПК с ftp://ftp.ucs.ru/dealers/Delivery/RK7/DbExpressInstallation.7z установочный пакет DBExpress.
Запустить его установщик и установить следуя инструкциям стандартного установщика. Никаких дополнительных параметров при установке не указывается.
Скачать и установить СУБД Firebird. Рекомендуются к установке — FIREBIRD v2.5 (32-bit).

Важно! разрядность СУБД Firebird должна быть 32-bit даже при установке на OC x64, это связано с поддержкой библиотеки CinemaUF.dll.

СУБД устанавливается стандартным образом как и для большинства остального нашего ПО. Сервер Firebird можно запускать как приложение (создать ярлык и запускать с ключем — fbserver.exe -a) или как службу (тогда при установке указать соответсвующую опцию и запускать из списка служб).

После установки firebird проверить, что по пути \Windows\system32\ находится актуальный файл GDS32.DLL (т.е. версия этого файла должна соответствовать версии установленного Firebird).

Если данный файл отсутствует, то в c:\Program Files\Firebird\Firebird_2_5\bin\ есть файл с названием fbclient.dll, который можно переименовать в GDS32.DLL и скопировать по указанному выше пути (еще лучше скопировать в \Windows\system32\ оба файла и переименованный и оригинальный).

В распакованном архиве дистрибутива, из папки \CinemaUF.dll\:

Скопировать CinemaUF.dll в \Program Files\Firebird\Firebird_2_5\UDF\
Скопировать CinemaUF.dll в \Program Files\Firebird\Firebird_2_5\bin\
Скопировать CinemaUF.dll в \Windows\system32\
Скопировать ib_util.dll из \Program Files\Firebird\Firebird_2_5\bin\ в \Program Files\Firebird\Firebird_2_5\UDF\

Важно! Указанные выше скопированные библиотеки во всех локациях должны быть ИДЕНТИЧНЫ. Вообще желательно что бы на ПК не было других подобных файлов.

База данных — Delivery.fdb

Роль основной базы данных в доставке выполняет файл — Delivery.fdb поддерживаемый СУБД Firebird.
Как правило, СУБД и базу поднимают на том ПК на котором, будет находиться и кассовый сервер (rkserver.exe) с кассовой базой (Database) выполняющей в доставке вспомогательную роль.

В развернутом дистрибутиве уже имеется папка \DELIVERY\DB в которой, находится пустая (готовая) база — DELIVERY.FDB.
База создана и предназначена для работы с СУБД Firebird 2.5. Можно воспользоваться ей для работы.

Если идущая в комплекте БД не устраивает по каким то параметрам (например, — не совместима с версией используемой СУБД или не совместима с версией используемого ПО или др.) можно создать базу при помощи скрипта.

Создание новой базы данных (Firebird 2.5)

Если СУБД другая, базу необходимо создать при помощи скрипта \DELIVERY\DB\Create_DB_2.25.7.17.sql используя при этом например, приложение IBEXPERT. В нем зайти в редактор скриптов (CTRL+F12), открыть вышеуказанный скрипт, отредактировать в нем параметр:

— необходимо указать корректный путь папки где будет создана база и задать имя базы.

Далее, запустить выполнение этого скрипта. Выполнение должно пройти без ошибок. В результате, будет создана база полностью совместимая с установленной на ПК СУБД.

Обновление базы данных

Перевод БД с одной СУБД на другую

По необходимости может выполняться обновление рабочей БД на новые версии.
В основном, процесс обновления связан либо, с обновлением версии Delivery RK6 (и БД нужно так же обновить до нужной версии), либо с изменением версии СУБД или переходом на другую БД.
В любом случае, такие действия требуют определенных навыков и знаний по работе с теми СУБД, которые задействованы в этом процессе, т.к. могут возникать определенные нюансы, где как раз и потребуются эти навыки и знания.

Например, на текущем сервере (например, — FIREBIRD 2.1 или INTERBASE) делают бекап базы средствами самой СУБД с параметром — TRANSPORTABLE (позволяет разворачивать любой бекап на любом сервере). Далее, разворичивают бекап на нужном целевом сервере (например Firebird 2.5) и получают базу в нужном формате с обновлённой версией ODS.

Обновление БД при обновлении ПО

При необходимости обновления, выполняют прилагаемый с новой версией Delivery RK6 скрипт и создают новую чистую базу.
Затем эту чистую базу «сравнивают» с оргигинальной рабочей базой при помощи IB/FB утилиты IBDBComparer (IBDBComp.exe).
Этой же утилитой выполняют обновление струтуры целевой базы, согласно результатов «сравнения».

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

Установить на ПК драйверы ключа Guardant (www.guardant.ru).
Подключить ключ содержащий лицензию Delivery RK6.
Для продления/обновления лицезии в ключе используется утилита \DELIVERY\LicenseUpdater\LUpdate.exe.

Для каждого отдельного рабочего места (модулей «Диспетчера» или «Оператора») требуется отдельный ключ!
Если все модули запускаются локально на одном ПК, то достаточно одного единственного ключа.

Примечание: если RK6 и Delivery ставятся на общем ПК, то лицензии на ПО должны быть прописаны в общем (едином) ключе, иначе может возникать конфликт проверки лицензии при запуске приложений доставки.

Установка и настройка модулей Delivery RK6

Могут быть установлены как на одном (общем) ПК, так и разнесены на разные.

Установка модуля «Диспетчер»

В развернутой папке \Delivery\Manager находится приложение «Диспетчер»(SDispather.exe). Вывести его ярлык на \»Рабочий стол».
Настроить MSConfig.Ini. Основные редактируемые параметры:

Перед первым запуском сразу настроить дополнительные параметры:

Необходимо иметь в виду, что конфигурация и функциональные возможности самого приложения сильно зависят от используемых в MSConfig.Ini параметров.
Описание большинства параметров находится в том же самом MSConfig.Ini в конце файла в разделах: [INI_Section_Names] и [INI_Values_Name]

Настройки и дополнительные параметры ини-файла, настраиваются и из самого приложения (что несомненно — удобней): Вкладка «Файл»\»Настройки».

Запустить, проверить, что происходит его подключение к базам и нет проблем с лицензией.

Запустить приложение кроме всех вышеперечисленных настроек получится только при условии наличия связи с уже настроенным и запущенным кассовым сервером (rkserver.exe).
Для приложений доставки может быть использован отдельный кассовый сервер не пересекающийся с обычными кассами ресторана R-KEEPER, если таковые имеются.
Кассовый сервер доставке на равне с остальными кассовыми серверами (если таковые имеются) будет обновлять меню из общей менеджерской базы RK6, а закрытые смены отправлять, как и остальные кассовые сервера — в приемный каталог \ENDDAY.

Установка модуля «Оператор»

В приложении «Оператор» выполняется поиск/доваление клиентов прием заказов. Настраивается практически также как и «Диспетчер».

Из папки \Delivery\Operator\PD_Operator.exe — вывести ярлык на «Рабочий стол».
Настроить PD_Operator.ini. Основные (стартовые) параметры которые необходимо отредактировать приведены ниже:

Перед первым запуском сразу настроить дополнительные параметры:

Так же, как и в конфигурационном файле «Диспетчера» в PD_Operator.ini, описание большинства параметров находится, в конце файла в разделах: [INI_Section_Names] и [INI_Values_Name].

Настройки и дополнительные параметры ини-файла, настраиваются и из самого приложения (что несомненно — удобней). Кнопка — «Настройка».

UnitID в PDOperator.ini и UnitName в MSConfig.ini должны отличаться.
В Менеджерской RK6 необходимо создать отдельные (уникальные) для каждого модуля доставки — кассовые станции.

Установка модуля «Экспедитор»

Из папки \Delivery\Expeditor\Expedit.exe вывести ярлык на «Рабочий стол».
Настроить ExpConfig.Ini. Основные (стартовые) параметры которые необходимо отредактировать приведены ниже:

Установка модуля «Редактор зон»

Из папки \Delivery\ZoneEditor\ZoneEditor.exe вывести ярлык на «Рабочий стол».
Настроить основные (стартовые) параметры ZoneEditor.ini. Пример:

Связь с сервером дисконтных карт (CARDSERV)

При наличии системы ПДС (PERSCARD) можно связать с ней модули доставки.
Фактически, должно быть настроено три связи: выполнены настройки в модулях «Оператор», в модулях «Диспетчер» и в настройках

Связь модуля «Оператор» — происходит через промежуточную библиотеку связи Csclink.dll (используется и в других приложениях RK6) и подключенную через нее RTcp.dll (универсальная библиотека связи).

Указанные dll должны находиться в каталоге \Operator.
Параметры связи с сервером карт (CARDSERV) указываются в Csclink.ini, пример:

Также, необходимо, в настройках ПО «Оператор» выставить дополнительные настройки:

2. Связь модуля «Диспетчер» с CARDSERV настраивается так же, как и в случае с модулем «Оператор».

Т.е. через Csclink.dll, RTcp.dll и Csclink.ini:

В настройках самого модуля «Диспетчер» выставить ID и Psw пользователя для подключения к CARDSERV:

3. Настроить связь кассового сервера (NT-RKSERVER) с CARDSERV стандартным образом.

В RKEEPER6.INI кассового сервера прописать: