Transform the data extract¶

Note

If your migration originates from MSR 3.x.x, proceed directly to Restore the data extract.

Once you have extracted the data from your source MSR system, you must transform the metadata into a format that is suitable for migration to an MSR 3.x.x system.

Kubernetes target systems

Deploy MMT as a Pod onto your MSR target cluster.
Exec into the MMT Pod.
Execute the transform command:
```
./mmt transform metadata msr \
--fullname <dest-MSR-instance-name>
--storage-mode <inplace|copy> \
--enzipassword <source-MSR-password> \
/migration
```
Note

The value of --enzipassword is the MSR source system password. This optional parameter is required when the source and target MSR passwords differ.

Swarm target systems

On the target system, run the following command from inside a worker node on which MSR is installed:

docker run \
--rm --it \
-v /var/run/docker.sock:/var/run/docker.sock \
-v <local-migration-directory>:/migration:Z \
--mount source=msr_msr-storage,target=/storage \
--network msr_msr-ol \
registry.mirantis.com/msr/mmt:$MMT_VERSION \
transform metadata msr \
--storage-mode <inplace|copy> \
--enzipassword <source-MSR-password> \
--swarm=true \
/migration

Note

The value of --enzipassword is the MSR source system password. This optional parameter is required when the source and target MSR passwords differ.

Command line parameters¶
Parameter	Description
`storage-mode`	Set the registry migration storage mode. Valid values: `inplace`, `copy`
`disable-analytics`	Optional. Disables MMT metrics collection for the `transform` command. You must include the flag each time you run the command.
`swarm`	Optional. Specifies that the source system runs on Docker Swarm. Default: `false`
`fullname`	Sets the name of the MSR instance to which MMT will migrate the transformed data extract. Use only when the target system runs on a Kubernetes cluster. Default: `msr`
`namespace`	Optional. Sets the namespace scope for the given command. Default: `default`.

Example output:

Writing migration summary file
Finalizing backup directory structure
Creating tar file
Cleaning transform operation artifacts from directory: "/home/<user-directory>/tmp/migrate"