Extract the data

To extract metadata and, optionally, binary image data from an MSR 2.9.x system, execute the following command on the source MSR 2.9.x system:

docker run \
--rm -it \
-v <local-migration-directory>:/migration:Z \
registry.mirantis.com/msr/mmt:$MMT_VERSION \
extract msr \
--source-mke-url <MKE url> \
--source-username <MKE admin username> \
--source-password <MKE admin password> \
--source-url <MSR 2.9 url> \
--storage-mode <inplace|copy> \
--source-insecure-tls \
/migration
Command line parameters

Parameter

Description

source-mke-url

Set the URL for the source Mirantis Kubernetes Engine (MKE) system.

source-username

Set the username of the admin user for the MKE system running MSR 2.9.x.

source-password

Set the password of the admin user for the MKE system running MSR 2.9.x.

source-url

Set the URL for the source MSR 2.9.x system.

storage-mode

Set the registry migration storage mode.

Valid values: inplace, copy

source-insecure-tls

Optional. Set whether to use an insecure connection.

Valid values: true (skip certificate validation when communicating with the source system), false (perform certificate validation when communicating with the source system)

Example output:

The Mirantis Migration Tool extracted your registry of MSR 2.9, using the
following parameters:
Source Registry: https://172.17.0.1
Mode: copy
Image data: 2 blobs (2.8 MB)

Important

To avoid data inconsistencies, the source registry must remain in read-only mode throughout the migration to MSR 3.0.x.

The data extract is rendered as a TAR file with the name msr-backup-<MSR-version>-mmt.tar in the <local-migration-directory>.