Skip to main content

Exporting and importing tasks

Information note

This functionality is supported with Replicate tasks only.

The ability to export tasks is useful if you need to migrate tasks between different Enterprise Manager machines, which may be necessary if you need to decomission a machine or when moving from a test machine to a production machine, for example. Tasks can be exported with or without endpoints.

Task export use cases
Export Task When

With Endpoints

  • The task's endpoints do not exist in the target environment. This way, the task will be created with endpoints when it is imported.
  • The endpoints already exist in the target environment but with a different configuration that you would like to override.

    Information note

    In both of the above cases, after importing the task, you need to edit the endpoints and re-enter the passwords. This will encrypt the passwords using the Master User Key of the target machine.

Without Endpoints

The task's endpoints already exist in the target environment with a suitable configuration.

For information on what permissions are required to export and import tasks, see Roles and permissions.

  1. In Tasks view, do one of the following:

    • Select or open the task you want to export and then click the Export Task toolbar button.
    • Right-click the task you want to export and select Export Task from the context menu.
  2. Select Without Endpoints or With Endpoints accordingly.

    Depending on your browser settings, the task JSON file will either be downloaded to your default Downloads folder or you will be prompted to save it to you preferred location.

    The file name format is as follows:


  1. If the task is running on the target server, stop the task.
  2. In Servers view, do one of the following:

    • Select the target server (i.e. the server to which you want the task to be imported).
    • Right-click the target server and select Import Task from the context menu.

    The Import Task window opens.

  3. Either select the task JSON file using the Browse button or drag the file to the window.
  4. Click Import.
  5. Optionally, when the import completes, start the task.


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 – let us know how we can improve!