Device Aggregator/Device Server Issues

From KeystoneIntranet
Revision as of 13:12, 12 April 2018 by Chanson (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

Log Files

Both Device Aggregator and Device Server store log files in the following folder on the PC where they are running:

C:\ProgramData\GivenHansco\Keystone\Log

NOTE: If you browse to the C: drive and you do not see the "Program Data" folder (it is a hidden folder by default) you can type C:\ProgramData in the search window at the top of File Explorer.

Log files are separated by date. A maximum of 10 log files will be stored for each server.

Here is an example of 10 log files for both Device Aggregator and Device Server:

CCDeviceAggregator.log   <--- most recent
CCDeviceAggregator_1.log
CCDeviceAggregator_2.log
CCDeviceAggregator_3.log
CCDeviceAggregator_4.log
CCDeviceAggregator_5.log
CCDeviceAggregator_6.log
CCDeviceAggregator_7.log
CCDeviceAggregator_8.log
CCDeviceAggregator_9.log <--- oldest
CCDeviceServer.log   <--- most recent
CCDeviceServer_1.log
CCDeviceServer_2.log
CCDeviceServer_3.log
CCDeviceServer_4.log
CCDeviceServer_5.log
CCDeviceServer_6.log
CCDeviceServer_7.log
CCDeviceServer_8.log
CCDeviceServer_9.log <--- oldest

Device Aggregator runs but does not show any connected Device Servers.

Check the Windows event log for errors from CCDeviceAggregator.exe. Look toward the end of the text for this: "Another user is upgrading the company database." If you see this, it indicates that one or more of the company databases have not yet been upgraded to the current version. Make sure that you login to all companies, then restart the aggregator.


Cannot connect to the Device Aggregator or Device Server using the web interface.

By default the Device Aggregator uses the following TCP ports:

  • 6010 (Device Server connection)
  • 6011 (web interface)

By default the Device Server uses the following TCP ports:

  • 6010 (Device Aggregator connection)
  • 6021 (web interface)

Sometimes one or more of these ports are already in use. When a web interface port is already in use there is no way to use the web interface to re-configure to use a different port. In this case, you must manually edit the INI file.

The INI files are located in the following folders, depending on your version of Windows:

  • C:\ProgramData\GivenHansco\Keystone\Settings (Windows Vista and higher)
  • C:\Documents and Settings\All Users\GivenHansco\Keystone\Settings (prior to Windows Vista)

Note that on Windows Vista of higher, you must run Notepad as Administrator to avoid creating a "virtual" copy of the INI file!

Here is a sample CCDeviceAggregator.ini file with the relevant entries for ports indicated:

[TCPServer]
IPPort=6010
[HTTPServer]
IPPort=6011
[AppServer]
ConnectInterval=60000


Here is a sample CCDeviceServer.ini file with the relevant entries for ports indicated:

[HTTPServer]
IPPort=6021
[GatorConnection]
IPAddress=127.0.0.1
IPPort=6010
ConnectInterval=60
PingInterval=60
[Identity]
DeviceServerID=DS1