QlikView Distribution Service

Overview

Executable %ProgramFiles%\QlikView\Distribution Service\QVDistributionService.exe
Data %ProgramData%\QlikTech\DistributionService
Listens to HTTP: 4720; SNMP: 4721
Uses/Controls DSC, QVS, QVB
Used by QMS
Note: After restarting the machine, the Windows event log may contain a message that the QlikView Distribution Service (QDS) failed to start in a timely manner, even though it started successfully. This is because the QDS initialization phase is longer than the Windows timeout period (30 seconds by default). To avoid the event log message, either change the Windows timeout period or configure QDS to depend on another late starting service to make QDS start up during a less busy period.

Files

The QlikView Distribution Service (QDS) files can be divided into three groups based on main purpose. All files are stored in the QDS “Data” folder.

See: Overview

In a clustered setup, all QDSs must share the same program folder. This is solved by the file config_<computer_name>.xml, which contains the program data path to use.

Settings and Configuration

The files listed below are local copies of the information stored in QVPR.

File Description
Configuration.xml Configuration file for the service.
Tasks\Task_<GUID>.xml The actual tasks. Note that deleted tasks are not automatically removed (due to support issue analysis).
Triggers\Triggers_<GUID>.xml The actual triggers. Note that deleted triggers are not automatically removed (due to support issue analysis).
MasterConfigurationNotification.xml A list of configuration notification files. Used to keep QDS in sync and to notify QDS nodes of configuration changes.
MasterTaskNotification.xml A list of task notification files. Used to keep QDS in sync and to notify QDS nodes of task changes.
MasterTaskExecutionNotification.xml A list of task execution notification files. Used to keep QDS in sync and to notify QDS nodes of task execution changes.
MasterTriggerNotification.xml A list of trigger notification files. Used to keep QDS in sync and to notify QDS nodes of changes to triggering events.
TaskDetails.xml A list of the available tasks in the Tasks folder. In addition, used to synchronize the files in that folder with QVPR.
TriggerDetails.xml A list of the available triggers in the Triggers folder. In addition, used to synchronize the files in that folder with QVPR.
DistributionGroupDefinition.xml Configuration file for Distribution Groups

Cluster

File Description
LoadBalancer.xml Used by QDS to decide which node (in a cluster) should run a task.
NodeInformation.xml Contains all other QDS node data that is not used by the load balancer.

Logs

File Description
TaskResults\TaskResult_<GUID>.xml Latest result of the task identified by the GUID.
TaskLogIndex\TaskLogIndex_<GUID>.xml This is just for lookup (one file per task), pointing to the actual log.
EdxResults\EdxResult_<GUID>.xml Until the task is completed, this file contains the current status of the EDX task. When the execution is finished, it contains the result (success/fail) and the task started as a result (if any).
<node-nr>\Log\<Date>.txt General QDS event and error log.
<node-nr>\Log\Cluster_<Date>.txt Synchronization log.
<node-nr>\Log\LoadBalancer_<Date>.txt Load balancing log.
<node-nr>\Log\Root_<Date>.txt QDS event log.
<node-nr>\Log\WebService_<Date>.txt QDS event log.
<node-nr>\Log\Workorder_<Date>.txt QDS event log.
<node-nr>\Log\<date>\<time> - <task name>\Tasklog.txt QDS task event log.
<node-nr>\Log\<date>\<time> - <task name>\DistributionReport.xml The distribution related to the task (only exists for distribution tasks).

Changing the storage time of log files

By default, log files are stored for 30 days and then are deleted from the Application Data Folder, by default C:\ProgramData\QlikTech\DistributionService.

You can change the storage time of log files within the QVDistributionService.exe.config file.

Note:

It is recommended that you make a copy of QVDistributionService.exe.config as a backup before you edit QVDistributionService.exe.config.

Do the following:

  1. Open Windows Services.
  2. Stop the QlikView Distribution Service by right-clicking the service and clicking Stop.
  3. Close Windows Services.
  4. Browse to C:\Program Files\QlikView\DistributionService and open QVDistributionService.exe.config with a text editing program.
  5. Locate <add key="NbrOfDaysToKeepQDSLogs" value="30" /> and add the number of days reports are to be stored as the value.
  6. Save and close the file.
  7. Open Windows Services.
  8. Restart the QlikView Distribution Service by right-clicking the service and clicking Start.
  9. Close Windows Services.

Did this information help you?

Thanks for letting us know. Is there anything you'd like to tell us about this topic?

Can you tell us why it did not help you and how we can improve it?