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

Migrating runtime assets

The runtime assets migration transfers tasks, plans, and server references from the source TAC to the target TAC.

This is the third and final step in the on-premises migration workflow and requires both the administrative assets and Talend project migrations to be completed first.

Selecting the TAC environments

  1. Select Migration in the left navigation drawer to open the migration selection page.
  2. Click the Runtime Assets tile.
  3. Select the source TAC server from the left table.
  4. Select the target TAC server from the right table.
  5. Click Tasks & Plans to proceed.
Runtime Servers.

Migrating server references

A confirmation dialog prompts whether to migrate virtual servers, Job servers, and runtime servers.

Select Yes if these servers have not yet been migrated.
Servers migration confirmation.
Information noteNote: The server migration copies only the database references — the server entries (name, host, port, and configuration) — to the target TAC database. No software is installed or configured on the physical servers.

After the migration, the target TAC must be able to reach these servers on the network. Any required agents or runtime engines must be installed and configured manually on the physical machines through the target TAC.

A status alert confirms whether the server migration succeeded or failed.

Selecting tasks and plans

Two tree views are displayed: the source tree on the left and the target tree on the right.

  1. Expand the source tree to view the available tasks and plans.
  2. Select the assets to migrate by checking the corresponding checkboxes.
  3. Click the right arrow button to move the selected assets to the target tree.
Task and Plans selection.

To remove an asset from the target tree, select the asset and click the left arrow button.

Reviewing the selection

  1. Click Review to view a summary of the selected assets.
  2. The review screen displays the following counts:
    • Total Tasks
    • Total Plans
  3. The target TAC environment details are displayed, including the TAC server name and version.
  4. Optionally enter a comment in the Comment field.
  5. Verify the target TAC tree structure on the right panel.
Information noteNote: All task triggers are migrated in a paused state by default.

After the migration completes, review the tasks on the target TAC and manually resume the triggers when ready. The pause/play icon on each task in the review screen indicates the trigger state.

Running the migration

Click Migrate to begin the migration.

The migration progress screen displays real-time status updates for each asset.

The migration status for each asset is indicated by the following icons:
  • Checkmark: Migrated successfully
  • Blue square: Migrated successfully with additional information.

    Hover over the icon to view details.

  • Red circle: Migration failed with an error message.

    Hover over the icon to view the error.

Migration behavior

  • Server references: Only the database entries for virtual servers, Job servers, and runtime servers are copied. Physical server configuration is not affected.
  • Task triggers: All task triggers are migrated in a paused state.

    Resume triggers manually on the target TAC after verifying the migration.

  • Task parameters: Task context parameter overrides are preserved during the migration.
  • Plans: Execution plans and associated task relationships are migrated.

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