Skip to main content

​
Intro

Workbench Migration simplifies moving your Workbench jobs to a new server or Workbench machine. With a smoother import/export experience, you can securely move all your Workbench jobs, including the encryption keys. This allows you to restore settings and accounts as configured on any computer.

​
Notes

Keep the following in mind as you use Workbench Migration:
  • Jobs are saved in Domo, so any changes made to the jobs after backup will persist.
  • Any jobs scheduled to run using local time run based off the local time of the new machine after the migration.
  • If the new machine is on a new network, you may need to reconfigure the proxy settings. The proxy settings will be imported from the machine you are migrating from.
  • Make sure to turn the service OFF on the machine you are migrating from; otherwise, you will see frequent job errors. We recommend migrating to a clean machine.
  • Install all required ODBC drivers on the new machine.
  • Recreate any DSNs on the new machine that are used by Workbench jobs.
  • Workbench jobs that require user impersonation launch as the impersonated user. Make sure that impersonated users are in the Domo Workbench Users group. You can do this after Workbench is installed on the machine you are migrating to.

​
Create Backup of Workbench Configuration

  1. Navigate to Settings in Workbench. The Workbench Backup configuration section displays.
  2. In the Create backup tab, select Browse and search for and select the file name for your backup.
    browse.jpg
  3. (Conditional) Select Generate and copy if you want Domo to generate a secure passcode for your backup. Otherwise you can create your own passcode, following these criteria:
    • 20 characters or more
    • Includes at least one uppercase letter
    • Includes at least one lowercase character
    • Includes at least one number
    • Includes at least one symbol
      generate and copy.jpg
  4. Select Create.
    create.jpg

​
Import Backup

Important: Importing a system backup while Workbench is in the middle of an operation can break Workbench and cannot be fixed in code. We strongly recommend that you turn Workbench OFF while importing the backup, then turn it back on when the backup is complete.
Note: To migrate your Workbench jobs, you need to run the Workbench as an administrator.
  1. Navigate to Settings in Workbench. The Workbench Backup configuration section displays.
  2. In the Import backup tab, select Browse and select the Workbench backup file that you want to import.
    browse import.jpg
  3. Enter the passcode that you generated in the Passcode field.
    passcode field.jpg
  4. Select Import.
    import backup.jpg