This article describes the algorithm for updating r_keeper 7 to the current version.
When updating to the later branch, you must sequentially update the system to the latest version in each intermediate branch, including the current one.
Example: to update from version 7.6.2.058 to version 7.7.0.185, you need to successively update to versions 7.6.2.295 (the last one in the current branch) > 7.6.4.544 (the last one in the next branch 7.6.4) > 7.6.5.515 (the last one in the next branch 7.6.5) > 7.7.0.185 (the last one in the next branch 7.7.0).
There are several scenarios for the system update. They depend on how r_keeper 7 was installed and what will be used to update it.
Preliminary Actions
Be sure to back up the application databases and configuration files before starting the update.
It is recommended to perform a backup before each update.
- Make backup copies of the following .INI files:
- common.ini
- repsserver.ini
- rk7man.ini
- rk7srv.ini
- RKEEPER.ini
- ShelterConnect.ini — if available
- wincash.ini
- winprint.ini
- Copy the following files from the base folder:
- rk7.udb
- check.udb
- rk7.bls
- Copy the contents of the Midbase folder
These files are required for updating and restoring the system to its original state.
Read more about how to restore the system in the Backup article.
r_keeper Installed from Archive
This section describes the update algorithm for the system installed from the archive.
Update using the archive
To update an archived version:
- Back up
Open ftp://ftp.ucs.ru/rk7/versions/ in the File Explorer or a browser. Log in with your Dealer ID
Modern browsers like Google Chrome or Firefox do not allow opening FTP links. Therefore, to open a link, use the File Explorer or an FTP client.
Select the latest version of r_keeper 7 in the current branch. If the original version is already the latest in the current branch, select the latest version in the next branch
Copy and unpack the archive
- Copy and replace all the files from the folder with the current r_keeper 7 version to the folder with the new one
- After the update, we get a version with new features but with the previously existing base.
All settings and directory data should be the same.
Update using the installer
Open ftp://ftp.ucs.ru/rk7/versions/ in the File Explorer or a browser. Log in with your Dealer ID
Modern browsers like Google Chrome or Firefox do not allow opening FTP links. Therefore, to open a link, use the File Explorer or an FTP client.
Copy the latest version of r_keeper 7 in the current branch. If the original version is already the latest in the current branch, select the latest version in the next branch
Run the installer and follow its instructions
Disable the creation of SQL database for the reference server in the list of components
When filling in the fields from the installer, use the data from the .INI files.
For example, at the stage of configuring the report server:
Use the port and network name from the copied .INI fileIn the field for the database name, specify the name of the database that is linked to the already installed r_keeper 7
Copy the rk7.udb, check.udb, rk7.bls files from the archive version folder to the installer version folder
Copy the contents of the Midbase folder from the archive version folder to the installer version folder
Connect to a previously used database
After copying the databases, change the value of the UseSQL = 1 parameter in the rk7srv.ini file to UseSQL = 0
Start ther reference server
Open the manager station
Change the settings of connection to an external database — set up a connection to the old database
Upload data to an external database
Change the value of the UseSQL = 0 parameter to UseSQL = 1.
If any mechanisms have been changed in a new version, for example, settings of UOMs, check the settings in the relevant references and make the necessary changes after the update
Install the cash station application in the same way
r_keeper Installed via Installer
This section describes the upgrade process if the original system was installed via the installer.
Update Using the Installer
Open ftp://ftp.ucs.ru/rk7/versions/ in the File Explorer or a browser. Log in with your Dealer ID
Modern browsers like Google Chrome or Firefox do not allow opening FTP links. Therefore, to open a link, use the File Explorer or an FTP client.
Copy the latest version of r_keeper 7 in the current branch. If the original version is already the latest in the current branch, select the latest version in the next branch
Run the installer
Select One of the previously installed instances upgrade
Select the system you want to update from the drop-down list and click Update
Follow the installer's instructionsPerform the cash station application update in the same way.