Amadis
ACE -Virtual Machine
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):
pcsclite
libusb
scmccid generic driver
using this command: sudo pcsc_scan
if the result is : SCardEstablishContext: Service not available., PCSC daemon is not running. Start the daemon with sudo pcscd
if pcscd is not installed: sudo apt-get install pcscd
if pcsc_scan is not installed: sudo apt-get install pcsc-tools
Otherwise the scan results, identified by scanning present readers, as for example:
0: Gemalto Prox-DU [Prox-DU HID_15100940] 00 00
1: Gemalto Prox-DU [Prox-DU HID_15100940] 00 01
These readers identification must be set in the Agnos.ini file in fields ReaderK and ReaderCL, as for example:
ReaderK=OMNIKEY CardMan (076B:5421) 5421 (OKCM0071405152041251832650474094) 00 00
ReaderCL=OMNIKEY CardMan (076B:5421) 5421 (OKCM0071405152041251832650474094) 00 01
Windows
Use TestResMan tool in order to identify which PCSC readers are available
How to set a contact transaction
Setup Kizis
In agnos.ini
Change
[Agnos]
ReaderK
key with the complete name of the contact PCSC readerSet
[Agnos]
Mode
key to2
Set
[Agnos]
CL
key toNo
Set
[COM]
Address
key to IP v4 address where ACE-Client is running
Run ACE-Client
Run Kizis
Open
Terminal UI
in ACE-Client and check thatWelcome
is displayed
Setup ACE-Client
in
Setup
page lineAcceptance system
inConnectivity
set IPv4 address of Kizis
use
Test
button
How to set a contactless transaction
Setup Kizis
In agnos.ini
Change
[Agnos]
ReaderCL
key with the complete name of the contactless PCSC readerSet
[Agnos]
Mode
key to2
Set
[Agnos]
CL
key toYes
Set
[Contactless]
LegacyPaypass
toYes
(if you want to run a Mastercard transaction)Set
[COM]
Address
key to IP v4 address where ACE-Client is running
Run ACE-Client
Run Kizis
Open
Terminal UI
in ACE-Client and check thatWelcome
is displayed