1 How to test connection to kgs for automatic volume transfer?
- 1.1 Via tia core status web app
- 1.2 Manually via command line tools
  - 1.2.1 Testing VCRS connection via curl
  - 1.2.2 Testing VCRS connection via wget
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 Automatic volume transmission doesn't work. How to transfer the data manually ?
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 https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/3707109381/Volume+Measurement+-+FAQ+and+Troubleshooting#What-kind-of-data-are-transferred%3F

How to test connection to kgs for automatic volume transfer?

Via tia core status web app

In tia® Content Server (core) the most convenient solution is to use the status UI to check the connection status.
Open the Status UI https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/2738061313, 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 establised

Connection not established

Connection is estabished, but there are no Volume data available. Volume data become available one month after initial connection at the earliest.

Connection is established, data are available.

Connection is not established, but configuration for automatic transfer is configured.
see https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/3707109381/Volume+Measurement+-+FAQ+and+Troubleshooting#Common-Errors-in-the-Content-Server-log%3A

Manually via command line tools

A realistic connection check needs to be executed via container shell. Even when testing from host machine, firewall rules or similiar may interfere.

curl and wget commands are not available in tia Core images as shipped. It can be installed by using apk package manager. (internet connection is required)

Choose one of them and install it using these steps in container shell:

For curl:

Update the package repository of apk: apk update
Install curl: apk add curl

For wget:

Update the package repository of apk: apk update
Install wget: apk add ca-certificates wget

Testing VCRS connection via curl

curl -i https://vcrs.kgs-cloud.de/isAlive

HTTP/1.1 200
Date: Mon, 01 Sep 2025 13:33:32 GMT
Content-Type: application/json
Content-Length: 7
Connection: keep-alive
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Strict-Transport-Security: max-age=31536000 ; includeSubDomains
X-Frame-Options: DENY
Access-Control-Allow-Origin: https://login.microsoftonline.com

isAlive

Testing VCRS connection via wget

wget -q -S -O- https://vcrs.kgs-cloud.de/isAlive 2>&1

HTTP/1.1 200
  Date: Mon, 01 Sep 2025 13:29:42 GMT
  Content-Type: application/json
  Content-Length: 7
  Connection: keep-alive
  X-Content-Type-Options: nosniff
  X-XSS-Protection: 0
  Cache-Control: no-cache, no-store, max-age=0, must-revalidate
  Pragma: no-cache
  Expires: 0
  Strict-Transport-Security: max-age=31536000 ; includeSubDomains
  X-Frame-Options: DENY
  Access-Control-Allow-Origin: https://login.microsoftonline.com
isAlive

Common Errors in the Content Server log

Make sure the configuration is as described https://kgs-software.atlassian.net/wiki/x/SwDR3 . 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: https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/3704684619/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: https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/3704684619/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 https://kgs-software.atlassian.net/wiki/x/SwDR3 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: https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/3704684619/Automatic+transfer+of+volume+data#Proxy-Configuration

Automatic volume transmission doesn't work. How to transfer the data manually ?

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 https://kgs-software.atlassian.net/wiki/spaces/DOCUEN/pages/2738061313, 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 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)

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.

Volume Measurement - FAQ and Troubleshooting