Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

This section relates to the directory structure used to store the POI configurations. The parameter are:

Parameters

Previous Parametersparameters

BaseDirectory

POIDataRoot

DirectoriesPermissions

n/a

...

If the BaseDirectory does not exists, it will be created and will have its permissions assigned to the value of the parameter DirectoriesPermissions. For example, 0755. The leading zero is required.

Parameters that are no longer in the configuration file

These parameters must be moved into the specific configuration files

MOVED

ASFileUploadSignatureKey

NexoMessagesUploadURL

GatewayId

DELETED

DebugDumpMessages

...

Nexo

This section contains parameters that will be embedded into the configuration sent to the POI’s.

Parameters

Previous parameters

ProtocolVersion

NexoTMSProtocolVersion

TerminalManagerId

TerminalManagerId

ProtocolVersion refers to the supported Nexo version. Currently, it is 6.0.

TerminalManagerId is the terminal id that will be embedded into the configuration messages sent to the POI’s.

Parameters that are no longer in the configuration file

These parameters must be moved into the specific configuration files

MOVED

ASFileUploadSignatureKey

NexoMessagesUploadURL

GatewayId

DELETED

DebugDumpMessages

How about user and group ???????

Sample Configuration

Code Block
###############################################################################
#
# Atheos Gateway V3 Configuration File
#
# Copyright ©2005-2021 - 9164-4187 QUEBEC INC (“AMADIS”), All Rights Reserved
#
###############################################################################
#

[LogFile]

# Log file location.  A fully qualified file name must be supplied.
URI = file:///var/server.crtlog/amadis/atheosgw.log

# PrivateDirectories keypermissions
forDirectoriesPermissions the= server0770
certificate. Password
protected# keysFile arepermissions
notFilePermissions #= supported0640
yet.
[ServerSSLPrivateKeyMessagesRepositories]

# CryptographicProviderBase =directory OpenSSLwhere Typethe =messages PrivateKeyreceived Formatand =sent PEM
URI=file://server.unprotected.key

#[ServerSSLPrivateKey]
#CryptographicProvider = hsm1
#Type = PrivateKey
#URI = pkcs11:model=SoftHSM%20v2;manufacturer=SoftHSM%20project;serial=abe6ed66024f38b2;token=claude;id=%40%00;object=serverkey;type=private;pin-value=4321

[hsm1]

# Engine type (internal or HSM)
Type = PKCS11HSM

# Engine ID
ID=pkcs11

# Engine library path
SOPath=/usr/lib/x86_64-linux-gnu/engines-1.1/libpkcs11.so

# Engine module path as required by the engine shared object library.
ModulePath=/usr/lib/softhsm/libsofthsm2.so

# Engine PIN
PIN=4321

[OpenSSL]
Type = OpenSSL
Version = 1.0.0

[Performance]

# Maximum number of concurrent connections the server will handle before 
# queuing the other ones.
MaximumConnections = 10

# Pending connections queue length.  If MaximumConnections is reached, up to 
# PendingConnectionQueueLength connections will be queued before rejecting 
# them.
PendingConnectionQueueLength = 200

# Maximium wait time while listening for a new connection in microseconds.
ListeningMaximumWaitTime = 100000

# Time in seconds the server will wait before terminating
# active connections.
ShutdownDelay = 60

# Timeout in seconds of a connection with a POI.
SSLTimeout = 60

# Maximum wait time when waiting for an event on a socket.
SocketSelectMaximumWaitTime = 100000

# Nexo message initial input buffer size in bytes. This value shall not be
# lower than 2000 bytes.
NexoMessageInitialBufferSize = 48000

# Nexo Builder Buffer size in bytes. NexoBuilderErrorMessagesBufferSize bytes
# are reverved as the error message buffer.
NexoBuilderBufferSize = 48000

# How much space to reserve in the Nexo Builder Buffer for error messages.
# It must be lower than 3072.
NexoBuilderErrorMessagesBufferSize = 1024

[Nexo]
# Nexo protocol version included in the Nexo messages
ProtocolVersion = 6.0

# Terminal Manager Id included in the Nexo messages
TerminalManagerId=ATHEOS-TMS01

[PoiConfigurations]

# Base directory root where the configuration files and
# the management plans for the POIs are located.
BaseDirectory = /home/amadis/poi

# Directories permissions for the POI configuration repositories
DirectoriesPermissions = 0770






# User under which the AtheosGW will be running.  Should not be root.
User=amadis

# Group under which the AtheosGW will be running.  Should not be root.
Group=amadis

old file

Code Block
# User under which the AtheosGW will be running.  Should not be root.
User=amadis

# Group under which the AtheosGW will be running.  Should not be root.
Group=amadis

# Version of the Nexo TMS protocol handled by the server.
# This value is included in the Nexo messges sent to the
# POIs.  Currently, it has no effect of the behavior of
# the server.
NexoTMSProtocolVersion=6.0

# Terminal Manager Id.  This value is include in Nexo 
# messages sent to the POIs.
TerminalManagerId=ATHEOS-NPS-TMS1
to the POI are saved.
# Previously FileRepositoryBaseDir
BaseDirectory=/home/amadis/files

# Directories permissions for the message repositories
DirectoriesPermissions = 0770

# File permissions for the message repositories
FilePermissions = 0640

[Connectivity]

# Server incoming connection port.  Previously ServerPort
ListeningPort = 55554

# Address on which the server will bind (listen) to.
BindingAddress = 0.0.0.0

# Server certificate used 
[ServerSSLCertificate]
CryptographicProvider = OpenSSL
Type = X509Certificate
Format = PEM
URI = file://server.crt

# Private key for the server certificate. Password protected keys are not
# supported yet.
[ServerSSLPrivateKey]
CryptographicProvider = OpenSSL
Type = PrivateKey
Format = PEM
URI=file://server.unprotected.key

#[ServerSSLPrivateKey]
#CryptographicProvider = hsm1
#Type = PrivateKey
#URI = pkcs11:model=SoftHSM%20v2;manufacturer=SoftHSM%20project;serial=abe6ed66024f38b2;token=claude;id=%40%00;object=serverkey;type=private;pin-value=4321

[hsm1]

# Engine type (internal or HSM)
Type = PKCS11HSM

# Engine ID
ID=pkcs11

# Engine library path
SOPath=/usr/lib/x86_64-linux-gnu/engines-1.1/libpkcs11.so

# Engine module path as required by the engine shared object library.
ModulePath=/usr/lib/softhsm/libsofthsm2.so

# Engine PIN
PIN=4321

[OpenSSL]
Type = OpenSSL
Version = 1.0.0

[Performance]

# Maximum number of concurrent connections the server will handle before 
# queuing the other ones.
MaximumConnections = 10

# Pending connections queue length.  If MaximumConnections is reached, up to 
# PendingConnectionQueueLength connections will be queued before rejecting 
# them.
PendingConnectionQueueLength = 200

# Maximium wait time while listening for a new connection in microseconds.
ListeningMaximumWaitTime = 100000

# Time in seconds the server will wait before terminating
# active connections.
ShutdownDelay = 60

# Timeout in seconds of a connection with a POI.
SSLTimeout = 60

# Maximum wait time when waiting for an event on a socket.
SocketSelectMaximumWaitTime = 100000

# Nexo message initial input buffer size in bytes. This value shall not be
# lower than 2000 bytes.
NexoMessageInitialBufferSize = 48000

# Nexo Builder Buffer size in bytes. NexoBuilderErrorMessagesBufferSize bytes
# are reverved as the error message buffer.
NexoBuilderBufferSize = 48000

# How much space to reserve in the Nexo Builder Buffer for error messages.
# It must be lower than 3072.
NexoBuilderErrorMessagesBufferSize = 1024

[Nexo]
# Nexo protocol version included in the Nexo messages
ProtocolVersion = 6.0

# Terminal Manager Id included in the Nexo messages
TerminalManagerId=ATHEOS-TMS01

[PoiConfigurations]

# Base directory root where the configuration files and
# the management plans for the POIs are located.
BaseDirectory = /home/amadis/poi

# Directories permissions for the POI configuration repositories
DirectoriesPermissions = 0770






# User under which the AtheosGW will be running.  Should not be root.
User=amadis

# Group under which the AtheosGW will be running.  Should not be root.
Group=amadis