Versions Compared

Old Version 5

changes.mady.by.user Ekaterina Marchenko

Saved on

compared with

New Version Current

changes.mady.by.user Ekaterina Marchenko

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Introduction

Info

Since version 7.05.03, the installation process has been changed.
It is necessary to license the reference server.

Before installing r_keeper 7, make sure that you have the required certificate installed in your operating system.
For version 7.07.00.232, it is obligatory to install the certificate

Installation Procedure

Note

Important!

R_keeper 7 requires licensing. See details in the Licensing section. Starting from version 7.05.03.ХХ, the installation procedure is different.

The distribution kit is

...

presented by installation packages

...

— setup.exe

...

. Install the system only using such packages — this will allow you to easily and quickly update system components.

If you need to update a previously installed version, go to the STANDALONES directory. Please note that distributions from this directory do not install TimeKeeper, Interactive Reports, and others.

...

Missing modules will

...

need to be installed and

...

updated manually.

...

Since version 7.05.03, the cash server

...

works only

...

on Windows OS.

By default, the cash station is installed with the new user interface. If previous versions are upgraded, the interface remains as it was.

...

Scenario

To install r_keeper 7 from an archive:

  1. Get licenses for the cash server and report server
  2. Download an archive from the FTP and unzip it.
    If you plan to use a version

...

  1. earlier than 7.6.4, download

...

  1. a distribution kit from the FTP server and

...

  1. the RAL.dat file from the License system
  2. Edit configuration files
  3. Run the reference server

...

  2. Run the manager station

...

  2. Add the cash server

...

  1. and license it

...

  2. Add a cash station

...

  2. Run the cash server

...

  2. Run the cash station

...

...

  1. Install MS SQL Server

...

  1. 2012  and configure

...

  1. connection between

...

  1. r_keeper 7 and the database managed by MS SQL

...

  1. .

...

Installation Process

...

  1. Copy the installer package archive from the FTP server

...

  1. : ftp://ftp.ucs.ru/rk7/versions/

...

  1. .
    The archive name indicates its version. If you do not know which version to install, it is better to install the penultimate one or contact the

...

  1. r_keeper support service

...

...

  1. Unpack the archive and remove the read-only attribute

...

  1. for the whole package including the sub-folders and files

...

  2. Add the folder containing r_keeper software to your antivirus exclusions. Further on run all applications as administrator

...

...

  1. Copy the INI files from the /BIN/WIN/INI folder to the /BIN/WIN folder

...

  1. Info

    If you plan to use a physical key for licensing, install the Guardant driver. You can download it

Note

Note

See detailed information on the parameters of the reference server configuration file and its launch in the article on the reference server.

...

  1. from the official website.

...


  2. Edit the

...

  1. configuration file of the reference server

...

  1. :

    1. Open the rk7srv.INI

    2. In the Server parameter of the [REFSERVER] section, specify the unique name of the server, for example, RK7
    3. Add the UseSql parameter for using external database for cumulative data, where:
      • 0 — no to use
      • 1 — to use
        When launching the server for the first time, specify UseSql=0
    4. In the [TCPSOC] sectionm specify a free port for the reference server

    5. Save the changes.

      Code Block
      [REFSERVER]

Server=RK7SRV_REST01   
UDBFILE=..\..\base\rk7.udb
MainLang=.\RefSrv.Rus
AltLang=
WorkModules=..\..\base\workmods
UpgradeTranslateRussian=0
;; UpgradeAltTranslateRussian by default have value different with UpgradeTranslateRussian
UpgradeAltTranslateRussian=0
DisableSMARTVerify=1
USESQL=0

[NETKERN]
Protocols=tcpsoc.DLL

[TCPSOC]
PORT=3639

6. Edit the INI file (rk7man.ini) and launch the manager station (rk7man.exe).

Info

Note

See details on configuring and launching the manager station in the Manager Station Setup article.

...

    1. For more information about the configuration file and launch of the reference server, read the special article

  2. Create the reference server's desktop shortcut — Refsrv.exe and specify /desktop in its properties
    Image Added
  3. Edit the configuration file of the manager station:
    1. Open the rk7man.ini
    2. In the Server parameter of the [REFSERVER] section, specify the name that you wrote in rk7srv.ini. In the given example, it is RK7
    3. In the [TCPDNS] section, find the server name and change it to this of yours. In our example, it is RK7

    4. Save the changes

      Code Block
      [REFEDIT]
Server=RK7SRV_REST01   
Client=TESTMAN-%RANDOM%
LOCKONEDIT=0
LongTimeout = 200000

[NETKERN]
PROTOCOLS=tcpsoc.dll

[TCPSOC]
PORT=3637

...

    1. LISTEN=0

[TCPDNS]
;; for speeding up. Sometimes necessary (if Broadcast messages cannot pass)    
RK7SRV_REST01=127.0.0.1:3639

...

To sign in, you can use the «Administrator» username and the password «=». To sign in as dealer (to perform any editing of references), it is required that the /BASE/ folder contains a fresh ral.dat file (see par. 1.2.3).

If the file is placed there after the reference server is launched, it is required to restart the reference server. The name must have the following format: "RK7 XXXX", where XXXX is the dealer ID.

7. Indicate the corporation code (Settings - Parameters - Installation - Enterprise Code) and the restaurant code (the CODE restaurant property) according to the facility accounting data from l.ucs.ru.

8. Add the cash server of your restaurant to the Stations and Devices refernce. Assign a unique network ID, for example MIDSRV3001 .

9. License the cash server. See details in the article on the cash server setup.

10. Configure the INI file (Rkeeper.ini) and launch the cash server (MIDSERV.EXE) with the /desktop * parameter.

The cash server name in Rkeeper.ini (the Client parameter) must match the name indicated at the manager station. It is necessary to indicate the name of the reference or report server (the RefServer) to which the cash server will connect to upgrade references and send sales data (a common shift file).

    1. For more information about configuring and launching the manager station, read a separate article.
      The rk7srv.ini and rk7man.

...

    1. ini files must have different ports in the [TCPDNS] section

  2. Run the reference server and wait until its icon becomes green or yellow in the tray.
    Agree when the system offers you to create a new database
  3. Run the manager station
  4. Log in
    • You can use standard credentials:
      • Account — Administrator
      • Password — =
    • To log in with dealer's rights, use the following credentials:
      • Account — RK7 DealerID, for example, RK7 1234
      • Password — the password for the License system
        Image Added
  5. When logging in for the first time, an error will appear. It is a normal behavior. Click OK and log in once again
  6. Specify the corporation code. For this:
    1. Go to Options > Parameters
    2. Select Installation > Enterprise Code
    3. Go to Properties and expand the Basic section
    4. In the Integer field, specify the corporation code in accordance with your data from the License system
    5. Save the changes
      Image Added
  7. Specify the restaurant code. For this:
    1. Go to Service > Stations and devices
    2. Right-click on All and select New Restaurant
    3. In the Main section of Properties:
      • Specify the name
      • In the Code field, enter the restaurant code in accordance with your data from the License system
      • In the Status field, select Active
        Image Added

  8. Add the cash server and specify your network ID. For this:
    1. Right-click on the restaurant name and select New Cash Server
    2. In the Main:
      • Specify the server Name
      • In the Status field, select Active
      • In the Network ID field, enter the unique network ID. You can use latin letters, digits and special symbols, for example MID
  9. License the cash server. Get more information in the article about configuring the cash server
  10. Add the cash station to the cash server and add the network ID name, for example, CASH. For more information, read the article about configuring the cash station
  11. Edit the configuration file of the cash server:
    1. Open the rkeeper.ini file
    2. In the [Config] section, edit the parameters:
      • Change Client to the network ID of the cash server. In our case, it is MID
      • Change RefServer  to the reference server name. In our case, it is RK7
      • Add the UseNetChecking=1 parameter, if you plan to use a virtual key for the system licensing
    3. In the [TCPSOC] section, add the line PORT=XXXX, where XXXX is the number of the port for the cash server
    4. In the  [TCPDNS] section, find the server name and change it to yours. In our case, it is RK7

    5. Save the changes

    1. Code Block
      [Config]
Client =  MIDSRV3001   
RefServer =  RK7SRV_REST01   
BasePath = ..\..\MIDBASE
TwoFilesMode=1
KeepModules=0

[NewBaseGenerators]
;;When a new work.udb is created, the following will be used:
InvoiceGen=0
CheckGen=100000
PrintNumberGen=0

[NETKERN]
Protocols=TCPSOC.dll;localnet.dll
[TCPSOC]
[TCPDNS]
;; Optional but if indicated, the connection will be faster; the same goes for the cash station
;; Sometimes needed (if broadcast messages fail to pass)   
RK7SRV_REST01=127.0.0.1:3639

11. At the manager station, add a cash station with a network name, for example, CASH_ST01 to the cash server from par. 8. Select Windows as the OS type, add the video driver to the «Devices» tab (right-click in the popup menu «Video Driver -> Windows Video Driver (Window Mode)»).

Info
Note: see details on cash station setup in the Cash station setup article.

...


  2. Edit the configuration file of the cash station:
    1. Open the wincash.ini file
    2. In the [Config] section, edit the parameters:
      • Change the Station to the network ID of the cash station. In our case, it is CASH
      • Change the Server to the network ID of the cash server. In our case, it is MID
    3. In the [TCPDNS] section
      • Find the cash server name and change it to yours. In our case, it is MID
      • After the IP-address, put the colon and specify the cash server port

    4. Save the changes

      Code Block
      [Config]
STATION =

...

    1. CASH  
Server =

...

    1. MID 

[NETKERN]
;possible protocols are nbhdup.dll, SPXSOC.dll
Protocols=.\TCPSOC.dll

[TCPSOC]
LISTEN=0

[TCPDNS]

;;Optional but if indicated, connection will be faster. Sometimes necessary (if broadcast messages cannot pass)
;; MIDSERVER01=127.0.0.1

...

    1. :2350


  2. Create the shortcut of the reference server (MIDSERV.EXE), add /desktop to its properties and run the server.
    If the cashdesk icon appears in the tray, everything is correct
  3. Run the cash station using the wincash.bat file
  4. Install MS SQL Server 2012 or higher. You can use the Express version
  5. License the reference server. For more details, read the article on the reference server setup

  6. Set up connection with an external database. For more details, read the article on setting connection with MS SQL

    Info

    If you plan to view reports in the manager station, it is obligatory to set up connection between the reference server and the SQL database.

    That's it — you have installed and configured r_keeper. If necessary, you can configure additional modules, their config files and start them.

Upgrading Procedure

If you want to upgrade the system, remember how it was installed. If r_keeper modules were installed using the installer, upgrade the system using the installer as well.

Info

Downgrading is impossible.

To upgrade the system:

  1. Close the common shift at the cash station
  2. Close all the stations, including the manager station,

16. Install the SQL server, license the reference server and configure the external database connection.

Info

Note: configuring the reference server connection to the SQL Server database and its licensing is mandatory if you need to view reports at the manager station.

17. Configure additional modules (corresponding INI files) and run them (as needed).

Upgrading Procedure

Warning

Important!

Downgrading is impossible!

Note

Important!

If r_keeper 7 modules were installed via the installer individually (each module has its own instance) or one instance was installed for several modules, upgrades must also be performed via the installer and using a relevant instance.

...

  1. and stop all the servers. If servers function as services, stop them

...

  1. :
    • To stop a reference server run as service, you can use the Windows tools or enter

...

    • net stop RKeeperRefServer

...

    •  in the command line

...

    • To stop a reference server run as a standard app, it is enough to click Shutdown in the main window

...

    • or in the popup icon menu in the tray

...

2. It is recommended to perform an upgrade after closing a common shift.

...

  2. Make an archive copy of the entire

...

  1. \RK7

...

  1. \ folder or at least copies of databases from the \base\ and \midbase\ folders

...

...

  1. Copy the folders from the new base.bin distribution kit

...

  1. to the folder containing the

...

  1. r_keeper 7 version to be upgraded. Agree to files replacements.
    If you have made changes in the wincash.bat file, do not replace it

...

  1. . Or replace it after

...

  1. comparing the contents and

...

  1. making necessary cahnges
  2. Go to base\drvlocalize and run Defparam.exe by selecting defparams.rus or a file for another language from the list

...

  1. .
    For versions below 7.5.2.269, see readme.txt in the same folder

...

  1. .
    New default driver settings will be added. This is particularly important for adding new universal fiscal register drivers. All the existing defparams.ini contents will be saved.

...

  1. Please, pay special attention to translation files. If needed, it is possible to perform additional translation.

...

  1. Launch the reference server — refsrv.exe.
    When upgrading, it is recommended to launch all servers as services so that you can see errors if they appear

...

  1. .

...

  1. Wait for the server to upgrade

...

  1. — for the icon in the tray

...

  1. will turn green

...

  2. Run the report

...

  1. server (if any) and wait for

...

  1. it to upgrade

...

  1. Note

Important!

...

  1. After upgrade, make sure to restart the reference

...

  1. and report servers

...

  1. .

...


  2. Run the cash

...

  1. server and wait for

...

  1. its upgrade
  2. Run the cash station
    • If preload and movemod run on DOS and Wincash.bat runs on Windows, then the cash station will upgrade automatically
    • Both obligatory modules and the modules specified on the Drivers tab of the Stations and Devices 

...

    • reference at the manager station

...

    • If the station configuration is changed, dll files are downloaded when the station is launched next time. When a new version is found, the cash server will upgrade and restart

...

...

  1. To upgrade a manager station, it should be run via rk7man.bat.

Upgrades since Versions 7.4.21.Х

If your version of r_keeper is from 7.4.21 to 7.5.3, upgrade the system as follows:

  1. Stop the reference server;
  2. Upgrade from your 7.4.21.Х to the latest 7.4.21.Х;
  3. Launch the reference server;
  4. Stop the reference server;
  5. Upgrade from your 7.4.21.Х to the latest 7.5.2.Х;
  6. Launch the reference server.

...

  1. Upgrade your version to the latest in the range;
  2. Launch the reference server;
  3. Once the reference server icon turns green, stop (export) the reference server;
  4. Upgrade RK7 to the latest version of the subsequent range;
  5. If you need to upgrade to later versions, return to par. 2. If there is no need to upgrade any further, this is the end of instructions.

Upgrading via Automatic Installer

...

  1. .

...

In practice, the most common situation is when installation was performed via Standalone, but the upgrade should be performed from Setup.exe.

In this case, you can do the following: install a new r_keeper v.7 version via the installer and add the old databases (rk7.udb, check.udb) to the new installation. But remember that it is impossible to skip versions, so maybe you will first have to perform a standard r_keeper upgrade.

If it is impossible to use setup.exe because of an OS type incompatibility, you can unpack setup.exe using third-party software to get the required files (not recommended).
* Servers can be launched as apps or services.

Info

Attention

On the first launch, run servers as applications with the /desktop key. This way you will be able to monitor server operations by the icon color in the tray.

To run servers as applications, you can create desktop icons for refsrv.exe and midserv.exe programs and place them in the startup. In this case you should add the /Desktop key to the parameter string to launch servers. For example: «D:\UCS\RK7\refsrv.exe /desktop».

To install required services, run the executable service files with the /install key or just run the .exe file and click Yes to agree to install a service. By default, created services are of the autorun type. This does not require users to log in to the system to launch the servers. If a service needs to be started or stopped manually, you should use the Windows tools or the net console command with the start/stop key. For example:

...