Volume Measurement - FAQ and Troubleshooting
- 1 How to test connection to kgs when automatic transfer is active?
- 2 Common Errors in the Content Server log
- 3 The button “View Volume Usage” is not on the status page
- 4 Is a proxy supported?
- 5 It doesn't work, how to manual transfer the data?
- 6 Is automatic transfer supported with a test license?
- 7 What kind of data are transferred?
- 8 When is the data transfered?
- 9 What is measured?
This guide will help to understand and identify issues with automatic volume transfer. It will also show an alternative in case automatic transfer is currently not possible.
It is always recommended to transfer your volume automatically to prevent manual work. For details of the transferred data see Volume Measurement - FAQ and Troubleshooting | What kind of data are transferred?
How to test connection to kgs when automatic transfer is active?
In tia® Content Server (core) the easiest solution is to use the status UI to check the connection status.
Open the Status UI tia® Status User-Interface, login if required. Select “View Volume Usage”:
A Popup opens with Volume Information for the last Month:
Connection establised | Connection establised | Connection not established |
|---|---|---|
 | 
| 
|
Connection is estabished, but there are no Volume data available, volumes become available earlies after one month of established connection. | Connection is established, data are available. | Connection is not established, but configuration for automatic transfer is configured. |
Common Errors in the Content Server log
Make sure the configuration is as described Automatic transfer of volume data . Minimum requirement for the configuration is volumecounter.file.counterSender.isActive = true and volumecounter.file.counterSender.targetUrl.
Proxies are supported too and can be configured with or without password: Automatic transfer of volume data | Proxy Configuration
When the connection shows an error check the log for more information, make sure the log level is WARN, Volume transfer issues do not interfere with document storage and therefore are not logged on error level:
Error like java.io.IOException: proxyvoli: <error Message> or java.io.IOException: VCRS responses with <error Message> indicate issues with the proxy like the proxy is not available or login is not valid.
An issue java.io.IOException: vcrs: <error Message> means that the server cannot be reached because of network issues. Make sure the tia® Content Server (core) can reach the current URL as described here: Automatic transfer of volume data | Activation of automatic transfer.
It is also possible that the data on the storage are not correct, in this case the error is <error Message> while sending volume counters to VCRS.. Please contact kgs for further instructions.
If the validation that the URL is reachable is done with a browser be aware that proxy configuration and network access can be different than the connection settings from tia® Content Server (core).
The button “View Volume Usage” is not on the status page
In this case there are two possible causes:
a test license is used see the field “
License Type/Status” test licenses are marked as “TEST / Valid“. It is not possible to transfer volume with a test license.a configuration is missing or the configuration is wrong: check settings from Automatic transfer of volume data again. The button only appears when the configuration is done.
Is a proxy supported?
Yes, http or https Proxy with or without login are supported, make sure your proxy configuration is up to date. The configuration reference can be found here: Automatic transfer of volume data | Proxy Configuration
It doesn't work, how to manual transfer the data?
If is not possible that the tia® Content Server (core) can reach the target URL a manual export can be done. Use the Status UI tia® Status User-Interface, login if required and click on “Download Volume Usage“. A File is downloaded to the computer send it e.g. by E-Mail to your kgs contact person.
Please make sure that the automatic process is working again, to prevent repetitive manual work.
Use this guide to analyse the connection issues or contact our support.
Manual transfer of volume data
Is automatic transfer supported with a test license?
No, a production license is required.
What kind of data are transferred?
In a Manuel transfer all data are exported, the file can take some time to create and can have a huge size. Automatic transfers limit the export to three month.
see Explanation of volume export data
When is the data transfered?
The goal was to send as less times as possible to ensure complete datasets.
The sending rule are:
6 minutes after start of tia® Content Server (core)
First day of the month between 1am and 2am
two weeks after the last transfer. (usually 15. of every month)
The content is explained here.
Automatic transfer contains only the data of the last three months. In case transfer was not possible for a longer period, kgs may request a manual data export.
What is measured?
Only usage data like stored pdfs, note, annotation, print lists, etc. are measured. Not measured are data in .kgs folder and metadata.