Advanced configuration

Introduction

Some of the configuration options that control AdvanNet operation is only available at one xml file found in the reader file system. The file is

/home/keonn/kernel/module/app.AdvanNet/META-INF/connectors.xml

In order to gain access to the reader file system, please follow the instructions explained on the Discalimer Agreement section of Series 150 page

How to locate the connectors.xml file

There can be several connectors.xml files in a device but only one is used in a given time. This is because each AdvanNet installation has its own copy, depending on the AdvanNet version the connectors.xml contents can change. To know the "current" connectors.xml file check the following guidelines

    1. Does the folder /home/keonn/kernel/module/app.AdvanNet/alternatives exist?

      1. No: The file you want is then /home/keonn/kernel/module/app.AdvanNet/META-INF/connectors.xml

      2. Yes: next step

    2. The contents of the alternatives folder is a list of folders 2.x.x-xxx.ZZZ

      1. The connectors.xml will be the file /home/keonn/kernel/module/app.AdvanNet/alternatives/2.x.x-xxx.ZZZ/META_INF/connectors.xml with ZZZ the highest.

How to edit the connectors.xml file

Backup

As a first step, please make a backup of the current connectors.xml file

    • Use any SFTP client to download to your local PC a copy of

/home/keonn/kernel/module/app.AdvanNet/META-INF/connectors.xml

Edit connectors.xml file

There are two methods to change the contents of connectors.xml

1. SSH

Logging in into the reader by using SSH and then use any of the command line available editors: vi, nano

2. SFTP client

    • Download a copy of /home/keonn/kernel/module/app.AdvanNet/META-INF/connectors.xml to your local PC

    • Edit the file using your preferred editor

    • Upload the modified copy of /home/keonn/kernel/module/app.AdvanNet/META-INF/connectors.xml to your local PC

Add/change configuration options in connectors.xml

The connectors.xml file is a regular xml file divided into several configuration blocks.

<?xml version='1.0' encoding='utf-8'?>

<aliases>

<load-order-scope>default</load-order-scope>

<load-order>20000</load-order>

<!-- Global options -->

<CONFIGURATION>

....

</CONFIGURATION>


<!-- Other configuration blocks -->

<DEFAULT_CONF_RUNTIME>

...

</DEFAULT_CONF_RUNTIME>


<DEVICE_MANAGER>

...

</DEVICE_MANAGER>

...

</aliases>

Global options

Adding an option is as easy as including a line in the <CONFIGURATION>

In case the option already exists, then just modify the contents, never duplicate an existing line

For example, in case we wanted to modify the refresh period of the monitor tab, we would need to add/modify the entry com.keonn.advannet.manager.refreshMonitorPeriod

<!-- Global options -->

<CONFIGURATION>

<com.keonn.advannet.manager.refreshMonitorPeriod>500</com.keonn.advannet.manager.refreshMonitorPeriod>

...

</CONFIGURATION>