1.1. If you never used Linux before, it is best to practice working with this system beforehand.

1.2. The r_keeper company does not maintain any OS.

1.3. Linux does not support physical keys, so this OS can have only servers with virtual keys or cash clients.

1.4. To launch r_keeper applications on Linux, use Wine (

1.5. We have used the Xubuntu distribution package ( and a Glaive touchscreen terminal with the Intel Atom processor. With other distribution packages and equipment, the touchscreen panel configuration and Wine installation might be performed differently.

1.6. To some extent, Linux can be viewed as a DOS replacement as this OS does not cause difficulties with new equipment or require any license fees.

1.7. To facilitate installation, there is an image containing the OS deployed for a Glaive with the Intel Atom processor where only the right server names should be specified.

2. Xubuntu Installation and Setup

2.1. Install Xubuntu 12.04 LTS. The computer must have the Internet connection

2.2. During installation, check the Automatic Sign-In to the System box in the login and password field.

2.3. Open the console and run the command:

sudo inputattach -elo /dev/ttyS2

Check if the touchscreen works. If yes, move on. If no, change 2 (in this case it is COM 3) to the COM port number to which the touchscreen is connected; numbering starts from 0 (ttyS0 is COM1, ttyS1 is COM2, etc.)

2.4. Run the command:

sudo leafpad /etc/rc.local

Add the string inputattach -elo /dev/ttyS2 before exit 0 to launch the touchscreen driver upon startup. Perform a restart.

2.5. Run the command

sudo apt-get install xinput-calibrator

the touchscreen calibrator will be installed. Run it using the command:

/bin/sh -c "xinput_calibrator; cat"

Calibrate the screen. Copy the following strings from the terminal window:

Section "InputClass"

Identifier "Calibration"

MatchProduct "Elo Serial TouchScreen"

Option "Calibration" "454 3689 3570 454"


2.6. Run the command:

sudo leafpad /usr/share/X11/xorg.conf.d/10-evdev.conf

Paste the copied calibration data to the end of the opened file, save the file, perform a restart, check if the touchscreen works and calibrated parameters are still as set before.
2.7. To work with COM ports, run the command

sudo usermod -Ga dialout {the username indicated during xubuntu installation}

This command means that the user will belong not only to the dialout group.

2.8. Install Wine using the command:

sudo apt-get install wine

Once installation is complete, run the winecfg command, and delete the Z disk on the disk tab in the window that appears. Click ОК.

3. R_keeper 7 Installation

Go to Apps Menu -> Wine -> Disk С: Summary and copy the folder containing the r_keeper 7 client to it.
3.1. Configure wincash.bat according to the following format:

REM WinCash update and start
CD C:\\RK7\\bin\\win
if /%1 == / goto defini
goto now_run
SET CASHINIPATH=.\\wincash.ini
preload.exe %CASHINIPATH%
for %%c in (%PRELOADPATH%\\*.dll) do del /F %%~nc.bak
for %%c in (%PRELOADPATH%\\*.dll) do ren %%~nc.dll *.bak
xcopy %PRELOADPATH% .\\ /S /C /R /Y
start /M doscash.exe %CASHINIPATH%
parameter /M for running without displaying the console.

3.2. Add wincash.bat to the startup menu the following way:
App Menu -> Settings -> Settings Manager -> Sessions and Startup; on the startup tab, press Add and fill in the fields:

  • NameRK7
  • Description: optional
  • Commandwine start /M C:\\RK7\\bin\\win\\wincash.bat clicks OK.
    The /M parameter is for running without displaying the console.

3.3. Perform a restart, check installation accuracy.

Finishing Installation

Disable Internet access at the cash register.

Additional Settings

To disable the taskbar, pop-up messages, and desktop:
transfer files *xfce4-panel, *xfce4-popup-notes, *xfdesktop from the folder /usr/bin/ to any other location but don't delete them. To make working with files more convenient, you can install Midnight Commander from the console using the sudo apt-get install mc command.

Disabling power saving mode:
xset dpms 0 0 0

5.1. Network Setup in the Command Line

To display the connected network devices, run the command 
sudo lshw -C network
and see something like this:
description: Ethernet interface
product: 79c970 [PCnet32 LANCE]
producer: Hynix Semiconductor (Hyundai Electronics)
physical ID: 3
bus info: pci@0000:00:03.0
logical name: eth0 
version: 40
serial number: 08:00:27:13:be:c2
size: 100Mbit/s
capacity: 100Mbit/s
bitness: 32 bits
frequency: 33MHz
capabilities: bus_master ethernet physical tp mii 10bt 10bt-fd 100bt 100bt-fd autonegotiation
configuration: autonegotiation=on broadcast=yes driver=pcnet32 driverversion=1.35 duplex=full ip= latency=64 link=yes maxlatency=255 mingnt=6 multicast=yes port=MII speed=100Mbit/s
resources: IRQ:10 ioport:d020(size=32) memory:f0000000-f0000fff memory:f0080000-f00fffff
From the information provided by this command we need the network device logical name eth0 for subsequent configuration. Run the command: 
sudo leafpad /etc/network/interfaces
and insert the following:

For a static IP address

For a dynamic IP address

iface eth0 inet static
auto eth0

iface eth0 inet dhcp
auto eth0

Restart the network interface:
sudo /etc/init.d/networking restart
Check the settings using the ifconfig command. You will see roughly the following:

ucs@STVRN2:~$ ifconfig
eth0 Link encap:Ethernet HWaddr 08:00:27:13:be:c2 
inet addr: Bcast:198. 168.0.255 Mask: 
inet6 addr: fe80::a00:27ff:fe13:bec2/64 Scope:Link
RX packets:31623 errors:1 dropped:0 overruns:0 frame:0
TX packets:1149 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:1000
RX bytes:4317568 (4.3 MB) TX bytes:132584 (132.5 KB)
Interrupt:10 Base address:0xd020

lo Link encap:Local loop (Loopback)
inet addr: Mask:
inet6 addr: ::1/128 Scope:Host
RX packets:28 errors:0 dropped:0 overruns:0 frame:0
TX packets:28 errors:0 dropped:0 overruns:0 carrier:0
collisions:0 txqueuelen:0
RX bytes:2236 (2.2 KB) TX bytes:2236 (2.2 KB)
These are network interface settings, in this case eth0 is the external interface, the local network.

5.2. PC Setup for RK7 POS Station from Acronis Image

After extracting the image and starting a PC: login: r_keeper password: 1234
Changing computer name:
sudo leafpad /etc/hostname 
Change to a required one, then run the command
sudo leafpad /etc/hosts
Change the previous name to a new one in the second string after
Change the configuration of the r_keeper 7 client placed in the folder \home\ucs\.wine\drive_c\RK7\bin\win. To open the folder and change the settings is better with the help of Midnight Commander by running the mc command.

If you connect a standard keyboard, the following commands are available:

Console: Win+T

Launching other programs: Win+R

6. Print Setup for Star Printers (RS232)

According to the dealer information, for successful printing using a Star printer, you need to install its native driver (in the PDD format). 

You can download the driver at