Virtual Machine Player

A virtual machine player software must be installed on the machine for running the Virtual Terminal anbd Kizis. You can use VMWare. The version must be greater than 7.1.0

VMWare can be downloaded from http://www.v3.co.uk/v3-uk/download-review/1957177/vmware-player-600

Linux Virtual Machine

Amadis can provide a Linux VM footprint with all the settings and PCSC devices allready set.

How to check the Linux version:

• Using this command: $ more /etc/*-release

How to identify the 32/64 bits Linux version

• Using this command: uname -m

How to verify that the network adapter is set to NAT (Network Address Translation)

• Using Player→Manage→Virtual Machine Settings→Hardware→Network Adapter

How to verify the IP address assigned to the virtual machine

• Using this command: ifconfig

This Linux IP address must be set in the ACE Client→Setup→Connectivity→Acceptance System address

How to connect the PCSC reader with the Amadis Kernel:

In order to perform basic tests on a reader, using Kizis Virtual Terminal, we can use a physical reader. This reader is physically USB connected to the machine. PCSC: PC to smart-card reader communication The drivers must be installed and the reader detected correctly by the machine. Some packages must be installed prior installing a PCSC reader (already done in Amadis VM footprint):

1. pcsclite

2. libusb

3. scmccid generic driver

• using this command: sudo pcsc_scan

1. if the result is : SCardEstablishContext: Service not available., PCSC daemon is not running. Start the daemon with sudo pcscd

2. if pcscd is not installed: sudo apt-get install pcscd

3. if pcsc_scan is not installed: sudo apt-get install pcsc-tools

4. Otherwise the scan results, identified by scanning present readers, as for example:

• These readers identification must be set in the Agnos.ini file in fields ReaderK and ReaderCL, as for example:

Windows

• Use TestResMan tool in order to identify which PCSC readers are available

How to set a contact transaction

Setup Kizis

1. In agnos.ini

   1. Change [Agnos] ReaderK key with the complete name of the contact PCSC reader

   2. Set [Agnos] Mode key to 2

   3. Set [Agnos] CL key to No

   4. Set [COM] Address key to IP v4 address where ACE-Client is running

2. Run ACE-Client

3. Run Kizis

4. Open Terminal UI in ACE-Client and check that Welcome is displayed

Setup ACE-Client

1. in Setup page line Acceptance system in Connectivity

   1. set IPv4 address of Kizis

   2. use Test button

How to set a contactless transaction

Setup Kizis

1. In agnos.ini

   1. Change [Agnos] ReaderCL key with the complete name of the contactless PCSC reader

   2. Set [Agnos] Mode key to 2

   3. Set [Agnos] CL key to Yes

   4. Set [Contactless] LegacyPaypass to Yes (if you want to run a Mastercard transaction)

   5. Set [COM] Address key to IP v4 address where ACE-Client is running

2. Run ACE-Client

3. Run Kizis

4. Open Terminal UI in ACE-Client and check that Welcome is displayed