[+]
System Settings
[+]
Programs
[+]
[+]
Reports
 
[-]
Administration
  
  
  
  
  
  
 
 
 
Updated on 11/8/2018
Direct link to topic in this publication:
iikoCard
Technical Information

This section is intended for network engineers and discusses the location of event logs and configuration files of iikoCard components as well as database connection settings and ports.

Configuration and POS server log

You are able to analyze POS server operation issues by means of POS server event log. You can find the log file here:C:\Users\iikoCard5POS\AppData\Roaming\iiko\iikoCard5\Logs.

POS server errors and events are stored in two files:

  • iikoCard5-error.log
  • iikoCard5-full.log

The POS server configuration file (iikoCard5.Pos.Host.exe.config) is located in the C:\Program Files\iiko\iikoCard5 POS directory.

Configuration file settings are divided in two sections:

  • immutableAppSettings The settings with unchangeable values. Each time the POS server is updating, the parameters will default.
  • overridableAppSettings If you want to change the settings in this section, use the user configuration file. For how to do it, see Alternative configuration file.

Alternative configuration file

If the POS sever is reinstalled, the iikoCard5.Pos.Host.exe.config configuration file will be deleted and recreated. In case you used custom parameters, specify them in the alternative configuration file, so you won’t have to customize the parameters after each POS server update. The system does not delete this file in case of an update or reinstallation of the POS server, so your settings will remain intact.

You are able to include into this file only the overridableAppSettings section settings of the primary configuration file (iikoCard5.Pos.Host.exe.config).

  • Database connection settings. Specify the following parameters:
    • Database instance “mssqllocaldb” by default.
    • Database name “iikoCard5POS” by default.

in the line: <add key="db.connection_string" value="Server=(localdb)\mssqllocaldb;Initial Catalog=iikoCard5POS;Integrated Security=True;" />:

  • Master DB connection settings. Specify the following parameters:
    • Database instance “mssqllocaldb” by default.
    • Master DB name “Master” by default.

in the line <add key="db.connection_string.master"value="Server=(localdb)\mssqllocaldb;Initial Catalog=master;Integrated Security=True;Connection Timeout=5;" />:

  • RabbitMQ connection setup. If you use other than the iiko.biz host server, then you can change an address, username and password. For this, specify them in the

<add key="RabbitMqUri" value="amqp://guest:guest@localhost:5672" /> line

for this, specify them in the following format: amqp://login:password@host:port.

To set the parameters in the alternative file:

  1. In case of POS version 29 and older, create the file manually in the user directory and name it iikoCard5Pos.override.config, on behalf of which the service is launched, for instance, in C:\Users\iikoCard5\AppData\Roaming\iiko\iikoCard5\.
  2. This file will be created automatically for version 30 and later.
  3. Create the file structure:

<overridableAppSettings>

<add key=“KEY” value=“VALUE” />

</overridableAppSettings>

  1. Paste the lines with the required parameters and specify their values.
  2. Save the file and restart the POS server service.

In case you, for instance, have to specify other database and master DB connection settings. The configuration file may have the following look:

<overridableAppSettings>

<add key="db.connection_string" value="Data Source=localhost\RESTO;Initial Catalog=iikoCard5;Integrated Security=True;" />

<add key="db.connection_string.master" value="Data Source=localhost\RESTO;Initial Catalog=master;Integrated Security=True;Connection Timeout=5;" />

</overridableAppSettings>

Environment setup

For a proper iikoCard5 operation, a free access to the following ports is required:

  • 5672 - POS server connection to iiko.biz.
  • 7001 - POS server connection to iikoFront and iikoOffice.
  • 7002 - iikoOffice connection to iiko.biz for versions older than 5.0.
  • 9900 - iikoOffice connection to iiko.biz for version 5.0 and later.

Database location

POS server database is located in C:\Users\iikoCard5POS\AppData\Roaming\iiko\iikoCard5.