MicroStrategy ONE

Create Migration Packages

This former preview feature, introduced in MicroStrategy 2021 Update 4, is out of the box starting in MicroStrategy 2021 Update 7.

Users can only view objects to which they have access.

There are three different package types you can create:

  • Object: Copies chosen objects with or without their dependencies between projects.

  • Project: Synchronizes a large number of objects between projects.

  • Administration: Copies the chosen administration objects with or without their dependencies between environments.

Object Migration Packages

The object package type is used to move objects between projects.

  1. Open the Workstation window.
  2. In the Navigation pane, click , next to Migrations. The Object package Type is selected by default.

    You can also multi-select objects anywhere within the Workstation window, right-click, and choose New Migration Package.

  3. Choose a Source environment and project.

  4. Click Add Objects to add content to your package.

    You can also drag and drop objects from anywhere within the Workstation window.

    If the user does not have the read and browse ACL when creating a package, the object cannot be seen in the Add Objects dialog and an error appears when dragging and dropping objects into the Create Package dialog.

    When objects are updated before the user clicks Create, an error with the object name and failure details appears. This message details whether the object was deleted, modified, or there is no longer read access since the objects' ACL changed.

  5. Once you have added objects, you can add their dependencies. Right-click an object and choose Add Dependencies.

  6. Select the type of dependencies you want to add to your package. Objects from other categories are not added.

    Your selections on this dialog are remembered the next time you add dependencies. If you don't want to add different object types as dependencies, select Remember the selected object type and the dialog will not appear again for this package.

  7. Added dependencies appear in a tree structure. You can choose to remove one or all dependencies of an object.

    When adding dependencies, an error with a dependencies count appears when those dependencies lack the read ACL.

  8. Set the Action for objects in the package. The action determines the how the object is saved in the source environment.

  9. Click Settings to set ACL Options and Update Schema for migration objects.

  10. Click Create.

Project Migration Packages

The project package type is used to merge large amounts of objects between projects.

  1. Open the Workstation window.
  2. In the Navigation pane, click , next to Migrations.

    You can also multi-select objects anywhere within the Workstation window, right-click, and choose New Migration Package.

  3. Change the package Type to Project.

  4. Choose a Source environment and project.

  5. Click Add Objects to add content to your package.

    You can also drag and drop objects from anywhere within the Workstation window.

  6. You can assign different actions to folders and objects. Next to Folders or Objects, click Add.

    Objects located directly within chosen folder have the same Action assigned by default. The Action is not changed recursively for objects in subfolders. A different Action set on a specific object overwrites the Action chosen for the entire category of this type.

  7. Click Settings to set ACL Options, Schema Update details, and Advanced Conflict Resolution for migrating objects.

  8. Click Create.

Administration Migration Packages

The administration package type is used to move administration objects between environments.

  1. Open the Workstation window.
  2. In the Navigation pane, click , next to Migrations.

    You can also multi-select objects anywhere within the Workstation window, right-click, and choose New Migration Package.

  3. Change the package Type to Administration.

  4. Choose a Source environment and project. Only environments supporting migrations appear.

  5. Click Add Objects to add content to your package.

    You can also drag and drop objects from anywhere within the Workstation window.

  6. Once you have added objects, you can right-click them to Add Dependencies or Change Action based on your needs.

  7. Click Settings to set ACL Options and Security Links for migration objects.

  8. Click Create.

  9. Track the progress of the package back in the grid. Once it is finished, click Migrate in the Action column.

  10. Select the target environment and project and click OK.

  11. If the migration is successful, the Action column changes to Reverse. If you need to undo the migration, click Reverse. You can also right-click the record and delete it. If the migration fails, the Action column changes to Failed. Hover over it to view details about the migration failure.