Build Console Migration Tool

The Build Console Migration Tool can be used to migrate File Library and Project content from one administrative machine to another.

Content included in the export

The following content is included when performing a Build Console Migration Tool export.

Using the Build Console Migration Tool

The following tasks can be performed using the Build Console Migration Tool.

Clean up before export

Before running the Build Console Migration Tool we recommend completing the following steps to ensure only required projects and media are migrated:

  1. Use Manage Projects to ensure all projects are valid and remove any that are no longer required.]
  2. From the Tools menu, select Remove unused files.

Exporting from the source machine

Follow these steps to export Build Console File Library and Project content from the source machine.

Warning: The export process can be a lengthy operation depending on the size of File Library and Project content. Build Console cannot be used whilst the Migration Tool is running.

  1. Close Build Console if running on the source machine.
  2. On the target machine where Imaging Toolkit 11.0.9 is installed, open the following folder based on the OS platform of the source machine:

    <InstallationPath>\Tools\<Platform>

  3. Copy the Build Console Migration Tool (MigTool.exe) from the target machine to a folder on the source machine, and launch it from there.
  4. Select Export mode.
  5. Browse to a Target folder where the exported archive (.bcarc) will be created.
  6. Click Export.
  7. After the export has completed, click OK, then click Exit.

Importing to the target machine

Follow these steps on the target machine to import previously exported Build Console File Library and Project content.

Warning: The import process can be a lengthy operation depending on the size of File Library and Project content. Build Console cannot be used whilst the Migration Tool is running.

  1. Ensure Build Console options have been configured including File Library and Projects folder, and if required a Monitoring server (Deployment Monitor) has been defined.

    Note:
    • Ensure there is sufficient disk space on the target machine based on the disk usage from the source machine and the size of the exported archive.
    • Build Console configured folders will be used by the Build Console Migration Tool during import to restore the File Library and Project content.
  2. Close Build Console if running.
  3. Run the Build Console Migration Tool based on the target machine OS platform as follows:
    <InstallationPath>\Tools\<Platform>\MigTool.exe
  4. Select Import mode.
  5. Browse to a Source archive (.bcarc) file that will be imported.
  6. Click Import.
  7. After the import has completed, click OK, then click Exit.