Introduction
| Warning |
|---|
| Important! Starting from r_keeper version 7.5.X, the cash server support for DOS is terminated. |
...
| Info |
|---|
| The names of the server and the configuration file can be random, but you should keep in mind that the server will by default search for the RKeeper.ini configuration file, if you do not specify which INI file should be used. Find the information on the use of other configuration files below, in the «Launch» paragraph. |
Licensing
| Note |
|---|
The cash server should be licensed. The license is linked to the full object code (9 digits) and the key code. Before licensing a server, create it at the manager station in the «Service – Stations and devices» reference. |
| Info |
|---|
Note: As an example, find a description of the cash server licensing procedure for the object (restaurant) with a full code 199990039. It is implied that an object with the code 199990039 has already been created at l.ucs.ru, and it has an active master license for the «r_keeper 7 Stations» software. |
...
- Specify the corporate code (Options – Parameters – Installation – Enterprise Code – Integer).
- Specify the restaurant code (restaurant property «CODE») in accordance with the object credentials from l.ucs.ru.
- Select a protection key (Licensing - Common –> Protection key –> Actual number).
- Generate a licensing request (right-click the cash server icon –> Actions).
- Generate a license at l.ucs.ru and insert it in the «Licensing - Cash Stations –> License key» field.
- Save the changes.
Launch
...
| Note |
|---|
| Before you launch the cash server, create it |
...
| in the |
...
| «Service – Stations and |
...
| devices» reference at the manager station and perform the licensing. |
Before To launch the server is launched, perform do the following:
- Create the server at the manager station under in the "Service «Service – Stations and devices" directorydevices» reference, assign a unique network ID to it, ef.gex. MIDSRV3001, set the change its status to "Active" «Active» and save the changes.
- License the server.
- In RKeeper.ini, specify the following parameters under in the [Config] section:
- RefServer = RK7SRV ;; the name of the
...
- references server, where the
...
- specific cash server connects to (
...
- equal to the Server parameter in RK7SRV.INI).
- Client = MIDSRV3001 ;; the cash server network ID according to item 1.
- Launch the server.
...
| Note |
|---|
| The first launch should always be performed as an application (with the /desktop parameter). Also, make sure to |
...
| run it as administrator. |
Both the cash server and the directories references server can be launched as a service. For this purpose, use the /install parameter.
After the server is launched as an application (midserv.exe /desktop), the systray following icon will display appear in the following icontray: . 
Launching multiple servers
| Note |
|---|
...
Each cash server created at the manager station has its own |
...
directory with |
...
the work.udb operational database (the |
...
directory path should be specified in the BasePath parameter), and its own |
...
INI file with a unique server name. |
If you are planning to launch multiple cash servers, the following variants are possible:
Variant A — — launching multiple servers with different ini-INI files from the same \bin\win folder.
A.1. Launching as an application:
...
midserv.exe /ininame:rkeeper2.ini /srvname:midserver2 /install — — service installation for the 2nd server server. Do not forget to set a new name for the service!
In each ini-INI file , you should specify a unique log file name for each server (ERRORLOG = midsrv.stk)
Variant B — laucnhing — launching each server from a separate folder (copy of \bin\win).
B.1. Launching as an application:
...
c:\rk7\bin\win2\midserv.exe /srvname:midserver2 /install — — service installation for the 2nd server server. Do not forget to set a new name for the service!
Cash server INI
...
file description
[Config] — main section
In the case of a cash desk register server, this section should contain the cash desk register parameters (see [Config] for a cash station).
CashServer = MIDSERVER — — a cash server network name
Client = MIDSERVER — — same as above (for compatibility purposes); a cash server network name
RefServer = RK7SRV — directories — references server network name
BasePath = ..\..\MIDBASE — working — a operational database pathImportant: if
| Note |
|---|
| If multiple cash servers are used, each of them should have a unique folder, the name of which has to be specified in the corresponding INI file. |
RECREATEBASE = 0 — — if " 1 " is set, the working operational database is re-created at every launch; if " -1 " is set, it will is not be re-created even if the version changes.
ArchivePath = (BasePath + ‘Archive\’) — — a path to the bill receipt archive
InterfacePath — — a path to the interface DLLs
TwoFilesMode = 0 — — if " 1 " is set, 2 files per collection are created, and then switched. It enhances the reliability , but also increases the file saving time. If you have a permanent access to the directories references server, " 1 " does not make sense.
ShortTimeout = 20000 — — the maximum time (ms) , during which of a network operation can be performed for a single item
LongTimeout = 100000 — — the maximum time (ms) , during which of a network operation can be performed for a collection
StartLang = .\midserv.rus — — the cash server initial language, used to display the errors that occur before the directories references are loaded ("Unable «Unable to connect to the server"server», etc.); after the loading, the language will be taken from the "Language preferences" «Language preferences» parameter group.
KeepModules = 0 — — keep the module list loaded in the memory. Relevant for cash desk register + server only. By default, it is " 0 " for the cash desk register + server combination, and " 1 " for a simple cash server. If you are planning to connect cash stations via network to the cash desk register + server combination, set " 1".
FileSyncPath= (BasePath + 'Incoming\') — the path to the folder, from which synchronization files should be taken
ERRORLOG = midsrv.stk — error log
ErrorLogSize = 1048576 — error log size
AlwaysZOnCommonClose = 0 — — whether the Z - report should be printed when the general common shift is closed, even if there were no sales
DebugMessages = () — — a comma-separated list of debug message codes
WarningDiskFree=209715200 — 209715200 — the maximum free disk space threshold, at which the message about an insufficient free disk space should be outputdisplayed
PollEvents=0 — — whether the list of occurred directory references changes should be periodically requested from the top-level server instead of synchronizing by events. For the directories server to Enable the EventCachePath parameter to make the references server store those changes in its .ini INI file, enable the parameter EventCachePath
PollRepeatTime=60 — — the periodicity (s) of requesting the list of changes at when Pollevents=1
For the purpose of solving the issue with paybindings.uni duplication, the following settings are provided:
NoUdbPacketMode — — disable the batch mode when writing data into work.udb. Implemented in 7.5.5.095, 7.5.6.037, 7.5.7.011
NoReuseUNI — — disable the reuse of UNI, which have been released during the order calculation. Implemented in 7.5.5.095, 7.5.6.037, 7.5.7.011
ExceptOnCheckUNI — disable the software interruptions and write the events in a log (error 2220)
[NewBaseGenerators] — — a section containing initial values of sequences (generators) for the a new databaseImportant: this
| Note |
|---|
| This section is only used |
...
| when a new database |
...
| is created. |
You can specify the initial values for the following sequences (generators):
OpLogGen = 0 — the internal number of an entry in the operations log (OperationLog table)
SendFile = 0 — — the initial file number during the archivation of a the file sent to the directories references server (if the number is already used, the parameter value will be incrementedincrease)
VisitGen = 1000 — 2 least significant bytes of the internal visit number (2 most significant bytes are taken from the date)
CheckGen = 100000 — — the number of the bill receipt (CheckNum field)
CashInOutGen = 0 — — the internal number (the UNI field) of the deposit/withdrawal documents, the internal invoice number
...
OrderSessGen = 1 — the global package identifier (UniqueID field)
PrintNumberGen = 0 — — the printed bill receipt number, if no fiscal printer or fiscal memory is used, and the "CommonPrintNumber" parameter is set to "True"«CommonPrintNumber» parameter has the «True» value.
CommonShiftNumber = N — the number, from which the shift numbering should begin. This parameter is relevant, when you need to re-create a cash server, but the shift numbering should be continued. Tested for 7.5.4.174.
...
;;An optional parameter; however, the connection will be faster, if it is set; the same is true for the cash deskregister.
;;Sometimes necessary, if broadcast messages fail to pass, or the communication with the top-level server is performed via the Internet
TEST_RK7SRV=127.0.0.1:3639
...
NoUpdate = "1";; Do not update this module and its dependent objects (dll, etc.).
Data synchronization
In the properties of a cash server at a manager stationAt a manager station in the cash server properties, there are parameters controlling data synchronization (top-down and bottom-up).
- Automatic updateupdates — update this application automatically.
- Monitor connection — display the message about connection loss between the cash server and the top-level server. This parameter is added starting from version 7.4.21.27, is disabled by default.
2. Online sales data — — transmit the online sales data on one level upper.3.- Closed shifts data — — transmit the closed shift sales data one level upper.4. Directories
- References — update the directories references data at this server.
- 5. Module DBs — Module databases — update application databases (required for updating clients one level lower).
Now, the options "«Automatic update" and "Module DBs"update» and «Module databases» options, as well as "Closed «Closed shifts data" data» and "Online «Online sales data" data» are made dependent (i.e., if one parameter is missing, the other is missing as well, and vice versa). In future versions, they will probably work separately. The old "Online" ("Synchronization") flag has been kept, but it disables all kinds of synchronization at a time, even if new flags are set.
If you need to disable the online online receipts transmission of bills, but keep the data upload after the general common shift is closed, there are three ways:
- Global: disable the "Online «Online data collection" collection» parameter.
- For the cash server: set the interval of sending online data at 00:00.
- For the reports server: set the interval of downloading online data at 00:00.
Important: starting from version 7.4.21.27, the "Test connection" property has been added to the cash server properties; it controls the output of the message informing of communication interruption between the cash server and the high-level server. By default, this check is disabled.
...
Сonfiguring the server at a cash
...
register
- Find the information on
...
- In DOS, launch the doscs.exe program.
- The rkeeper.ini settings see here: Config — main sectionin the «Config — main section» article.
- In the PROTOCOLS parameter under of the [NETKERN] section, specify the the localnet.dll (except for the protocol to be used for the directories references server communication)
- When configuring stations and devices at the manager station, you should specify identical (!) network names for the stations group and the separate station.For the purpose of using Preload at the stations connecting to doscs, set KeepModules=1