GPRSCore
Version
The actual Version of the GPRSCore is 5.0.0 from Sep-13 2012
Introduction
GPRSCore is the middleware to connect GPRS-Modems to CSRC. It is always connected to a KMCore installation. GPRSCore will watch some folders for files from KMCore and vice versa. It will drop notifications and responses in folders watchded by KMCore. GPRSCore is connected via an encrypted channel with one member of the GPRS-Cascade-Cluster located at BEU in Langenhagen (Germany). GPRSCore performs the following actions:
- add a MFP, only if the MFP is know the Cluster-DB a setup can performed at the MFP
- delete a MFP
- deliver a Setup notification to KMCore
- deliver an Alarm notification to KMCore
- delegate a Datarequest to the Cluster and deliver an answer to KMCore
- delete XML files in the export and response folders if older than 3 days
- delete own log files if older than 14 days
added features in the 5.0 release:
- add a TOTAL_BLK_CMD if an alarm was received (only once in 2 hours)
- implementation of an additional Windows Service (ADKConnector) for direct communication between GPRSCore and ADK Client API
- check for Updates of GPRSCore and ADKConnector on the Server, and if available install them
- request SALES and SERVICE Office ID for each device to offer better user role management for the M2M portal
- synchronize MFP data between cluster and KMCore
Future releases will check the data coming from the MFPs for correctness of the date, and perform a Date-Setting operation on the MFP, if needed.
Installer
The installer for GPRSCore (Version >=5.0) will install two software packages:
- GPRSCore itself, a java application wrapped as Windows Service
- ADKConnector a C# application running as Windos Service
At best the suggested values for directories are choosen. If not it is very important to keep in mind that KMCore, GPRSCore and ADKConnector must be installed in one diretory.
Configuration
For normal use no additional configuration is needed, as all important information is taken from:
- the KMCSBase.ini (configuration file of the KMCore)
- the table files (containing MFP specific informations)
- ADK-Client-API via ADKConnector (authentification information is taken from KMCSBase.ini)
Additionally Configuration can be placed in a file named GprsCoreConfiguration.txt, placed in conf, a direct subdiretory of the GPRSCore folder. The configuration consists of simple key value pairs divided by whitespace, each line starting with a # is a comment. Here is an example with only comments and the correct default setting (text file): GprsCoreConfiguration.txt
Windows Service
GPRSCore is a Java application wrapped as Windows Service, ADKConnector is a C# Windows Service. The ADKConnector installer will provide a Tray Icon which gives the state of GPRSCore and ADKConnector and the possibility to start or stop this Services. If GPRSCore is running and gets no answers from the ADKConnector it will attempt to stop and start the ADKConnector Service. The ADKConnector installer will modify the Service Settings, so that the GPRSCore is restarted on an abort. To use this the Java application will shutdown itself in case of an severe error.
Debugging
The GPRSCore write its Logfile kmgprs.log to the folder $GPRSCoreHOME/log. You can watch the file by using Tail.exe from the Windows Startmenu-Konica Minolta-GPRSCore Folder.
Changelog
- Version 4.3.9 from 2011-Jan-27
- Bugfix: Added MFPs which are not listed in the Table files wont fail anymore
- Bugfix: Complains over missing Table files are changed in an INFO notice
- Version 4.4.0 rc3 from 2011-Oct-27
- Feature: Improved Message handling, Messages are only deleted from the Server on request of the GPRSCore
- Feature: Adaptive Responsesize handling, to improve robustness and stability in low bandwith installations
- Version 5.0.0. from 2012-Sep-13
- Feature: ADKConnector implemented to open a way of direct communication between GPRSCore application and ADK-Client-API
- Feature: Autoupdate of GPRSCore and ADKConnector
- Feature: TOTAL_BLK_CMD on receiving of an alert
- Feature: Fetching of SALES and SERVICE Office information for each MFP