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 |
Files
The QlikView Distribution Service (QDS) files can be divided into three groups based on main purpose. All files, with the exception of DistributionGroupDefinition.xml, are stored in the QDS “Data” folder.
In a clustered setup, all QDSs must share the same program folder. This is solved by the file config_<server_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 |
|---|---|
| service_key.txt | The service key that is used to make calls to the QMS API. |
| Config_servername.xml |
This file lists all changes made to the default configuration of the QVDistributionService.exe.config file. In a QDS clustered environment, this file exists on each node. |
| 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. Used to synchronize the files in that folder with QVPR. |
| TriggerDetails.xml |
A list of the available triggers in the Triggers folder. 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.
It is recommended that you make a copy of QVDistributionService.exe.config as a backup before you edit QVDistributionService.exe.config.
Do the following:
- Open Windows Services.
- Stop the QlikView Distribution Service by right-clicking the service and clicking Stop.
- Close Windows Services.
- Browse to C:\Program Files\QlikView\DistributionService and open QVDistributionService.exe.config with a text editing program.
- Locate <add key="NbrOfDaysToKeepQDSLogs" value="30" /> and add the number of days reports are to be stored as the value.
- Save and close the file.
- Open Windows Services.
- Restart the QlikView Distribution Service by right-clicking the service and clicking Start.
- Close Windows Services.
