Qlik Data Transfer White screen with error "Unable to unlock the ReloadService"

[Benoit_C]

When trying to use Qlik Data Transfer for the first time after a correct installation, you might have the below white screen:

Having a white screen basically means one of the Qlik DataTransfer micro service is not started and/or not working. This can be checked in the Windows Event Application (Source: Qlik Sense Service Dispatcher) or in the Qlik DataTransfer logs (C:\ProgramData\Qlik\DataTransfer\Log).

In the \DataUploadService logs you will see this error message:

localhost 6.0.0 Global INFO Responding certificates after reading it from defined location.
localhost 6.0.0 Global ERROR Unable to unlock the ReloadService, cannot continue.
localhost 6.0.0 Global ERROR Exception: Error: Unable to unlock the reload service.

Resolution

This error message is happening directly after the step of reading certificate:

INFO Responding certificates after reading it from defined location.

Verify the certificate:

Verify what certificates you have listed in the MMC console.

1. Are no certificates listed?
   
   
   
   

2. A group policy or other system security settings may have prevented certificates from being installed. Follow the Reset certificates steps found in the second half of the article after lifting potential restrictions on the account or machine which previously prevented the certificates from being installed. 

3. If you see some Qlik DataTransfer duplicate certificates (fig 1), duplicates must be deleted.
   
   fig 1
   
   
4. Delete the two duplicates (which have no Friendly Name listed. 
5. Restart the Qlik DataTransfer service.

Are other Qlik Products installed on the same server?

Installing Qlik Sense Enterprise on Windows (Desktop or otherwise) will also lead to compatibility issues, including certificate mismatches.

1. If the other product was previously uninstalled, the certificate may still be present.
2. Verify in the MMC console and navigate to Certificates (Local Computer) --> Personal -- Certificates to see if another QlikClient certificate is installed.
3. Remove it.
4. Then follow the Reset Certificates steps found below.

Are you using a Proxy?

A proxy system variable may be set in Windows. Example: https_proxy=http://PROXY:80 

Qlik Data Transfer does not support the use of a proxy. Delete the Windows variable.

Reset Certificates 

If only Qlik DataTransfer is installed on the machine, do the following:

1. In Windows Services, stop the Qlik DataTransfer service.

2. Navigate to C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate and delete the certificates there.
   
   

3. Navigate to C:\Program Files\Qlik\DataTransfer\DataUploadService\install-utils.

4. Run Remove-Certificate.ps1 in PowerShell.

5. Delete the following folder: C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate
   

6. Start the Qlik DataTransfer service.

7. Navigate to C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate and confirm the following files are present:

   • client.pfx

   • server.pfx

If Qlik DataTransfer and Qlik Sense Enterprise on Windows are installed on the machine, do the following:

1. In Windows, Services, stop the Qlik DataTransfer service.

2. Navigate to C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate and delete the certificates in the folder.
   
   

3. In the Windows Certificate Store, delete the following certificates:

   • Local Computer > Personal > QdtClient

   • Local Computer > Trusted Root Certification Authority > <hostname.domain> or <hostname>

   • Current user > Personal > QdtClient

   Alternatively, you can run Remove-Certificate.ps1 in PowerShell as the administrator.
   
   

4. Run Configure-Service.ps1 in PowerShell as the Qlik Sense services user.

   1. For the first input dataTransferCertificatePath, enter C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate.

   2. For the second input qsefwPresent, enter Yes.

5. Navigate to C:\ProgramData\Qlik\DataTransfer\DataUpload\certificate and confirm the following files are present:

   • root.pfx

   • client.pfx

   • server.pfx

6. Restart the Qlik DataTransfer service.

Related Content 

Installing and Using Qlik DataTransfer  
Troubleshooting Qlik DataTransfer 

Environment

Qlik Data Transfer any release

[jchoucq]

Hi @Benoit_C 

thank you very much for your article
I'm exactly in this situation "You also could be where there is no certificates at all"

Even when we use the administror domain account, we do not have any certificates after installation or when using "Remove-Certificate.ps1" in PowerShell.

Do i completely miss something ?

Johann

[Benoit_C]

Hi @jchoucq, 

Your situation was different and the error you got was different as well:
Error while executing powershell script command,spawnSync powershell.exe ENOENT

This error was caused because in the Windows environment variable named "PSModulePath" you had 2 values:
%SystemRoot%\system32\WindowsPowerShell\v1.0\Modules\;C:\Program Files (x86)\Microsoft SQL Server\120\Tools\PowerShell\Modules\

We removed C:\Program Files (x86)\Microsoft SQL Server\120\Tools\PowerShell\Modules
And after a restart of the Qlik Data Transfer service, the issue was fixed.

[jchoucq]

Hi @Benoit_C, thanks again for your time ! 

[denisetrujillo]

ya hice todo lo mencionado y me sigue apareciendo en blanco y en el log Exception: Error: Unable to unlock the reload service.

[Sonja_Bauernfeind]

Hello @denisetrujillo 

If you have followed all the steps in this article and are unable to resolve the issue, then additional investigation is likely needed. I suggest starting by posting directly in our Deployment & Management forums, giving us details on error messages and what steps you have taken to troubleshoot.

All the best,
Sonja 

[adnanbaig]

Just FYI, i had same issue, i resolved it by following this article instead. 

There is a definitely difference between hosting Qlik Data Transfer  in a dedicated server, versus, Qlik Data Transfer and Qlik Sense are installed on the same machine. The certs configuration will come from central node and place its certs into the where the Qlik Data Transfer tool is installed. I hope this helps. 

https://help.qlik.com/en-US/cloud-services/Subsystems/Hub/Content/Sense_Hub/QlikDataTransfer/trouble...