Skip to main content Skip to complementary content
Qlik Resources
Loading SearchUnify's search If you need assistance with your product, please contact Qlik Support.
Qlik Customer Portal
Loading SearchUnify's search If you need assistance with your product, please contact Qlik Support.
Qlik Customer Portal

Installing the Qlik Analytics Migration Tool

The Qlik Analytics Migration Tool includes a guided installer that streamlines deployment while supporting advanced configurations for enterprise environments. This installation guide outlines each step, including certificate setup, port validation, service account configuration, and final verification.

Prerequisites

Confirm that all System requirements are met, including supported operating systems, disk space, memory, permissions, and network access.

Installation steps

1. Download the installer

Download the Qlik Analytics Migration Tool installer from the Qlik Community.

2. Run the installer as administrator

Right-click the downloaded .exe file and select Run as administrator to launch the guided setup.

3. Accept the license agreement

Do the following:

  1. Review the End User License Agreement.
  2. Select Accept to proceed.

4. Install required runtime

If prompted, install the required .NET packages.

5. Enter company name

Provide a company name to be used as a display label within the Qlik Analytics Migration Tool.

Information note

This does not need to reflect a legal entity.

6. Configure certificate and domain

Dedicated server

  • Certificate: Select a valid third-party SSL/TLS certificate from the LocalMachine certificate store.
  • Domain: Enter the fully qualified domain name (FQDN) that matches the certificate (for example, migrationtool.company.com).

Ensure the certificate presented in the browser after installation matches the configured domain. A browser warning typically indicates a mismatch.

Non-dedicated server (evaluation)

  • Certificate: Use a self-signed certificate.

7. Configure ports

  • Default Ports:
    • HTTP: 9037
    • HTTPS: 9038
  • Dedicated Server Option:
    • HTTP: 80
    • HTTPS: 443

To validate port availability:

  • netstat -ano | findstr :80
  • netstat -ano | findstr :443
  • netstat -ano | findstr :9037
  • netstat -ano | findstr :9038

To identify which process is using a port:

  • tasklist /FI "PID eq <PID>"

8. Configure optional email notifications

Enter SMTP server details to enable user invitation notifications via email.

This step is optional.

9. Select authentication type

Choose Windows Authentication (default and recommended).

Azure Entra ID is also supported, currently in preview and not fully documented.

10. Set administrator and service account

Admin user

Enter a Windows account to serve as the initial administrator.

This account will be used to access the web interface after installation.

Service account

Select the Windows service account type:

  • Windows User: Specify a domain account manually.
  • Local System: Use the built-in system context.
Information note

Important:

If migrating file-based data (fore example, QVDs, CSVs, TXT), select a domain account with appropriate access to the necessary file shares.

If file migration is not required, Local System may be used.

Updating the service account After installation

Do the following:

  1. Open services.msc.
  2. Locate Qlik Analytics Migration Tool.
  3. Right-click → Properties → Log On tab.
  4. Select This account and provide domain credentials.
  5. Click Apply, then restart the service.

11. Configure proxy (optional)

If a proxy is required for outbound internet access:

  • Check the Enable Proxy box.
  • Enter the proxy address and port.
  • Check the Use default Windows credentials box, or enter authentication credentials if applicable.

12. Select installation directory

Choose a destination folder with sufficient free space to support:

  • Exported or imported Qlik apps
  • Migrated data files (QVDs, CSVs, and so on)
  • Log files and backups

Qlik apps are exported without data by default. When exporting with data or migrating large datasets, ensure sufficient disk capacity.

13. Final setup options

  • Create Desktop Shortcut: Add a shortcut to the desktop.
  • Launch Application After Install: Automatically open the tool in the browser upon completion.

Select Install to begin the installation process.

Completion

After installation:

If Launch Application After Install was enabled, the Qlik Analytics Migration Tool will open automatically.

Otherwise, access the tool using a supported browser:

  • If a self-signed certificate was used on a non-dedicated machine:
    https://<machine-name>:<HTTPS port>

  • If a third-party certificate was used:
    https://<FQDN> (using port 443, else include selected HTTPS port)

Log in using the configured admin account and verify that:

  • The web interface is accessible.
  • All services are operational.

Related pages

Visit the discussion forum at community.qlik.com

Did this page help you?

If you find any issues with this page or its content – a typo, a missing step, or a technical error – please let us know!

Leave your feedback here