Skip to content

Commit 3681a93

Browse files
Merge pull request mendix#9088 from tknippenberg/MigrationBlocked
Clarified steps for blocked migrations
2 parents 1b7916c + 422f824 commit 3681a93

1 file changed

Lines changed: 15 additions & 7 deletions

File tree

content/en/docs/developerportal/general/team-server/migrate-to-git.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -41,25 +41,33 @@ In addition to the hard criteria mentioned above, a check is performed to determ
4141

4242
### Eligibility Check Outcomes
4343

44-
#### Not Eligible for Migration
45-
46-
If your app is not eligible for migration the reason(s) will be listed on the page. to continue with the migration, resolve these reasons and try again.
44+
#### Eligible for Migrating With History
4745

48-
In case there are reasons you cannot address, please reach out to Support or your Customer Success Manager to discuss the options.
46+
If your repository is eligible for migrating with full history, you can choose whether to retain your history during migration or not. For the smoothest experience after the migration, Mendix advises to migrate without history.
4947

5048
#### Eligible for Migrating Without History
5149

52-
If your app is eligible for migration, but the SVN repository size exceeds the threshold, you can only migrate the latest commit of the main branch. This limitation has been imposed to guarantee a smooth experience post-migration, as a [large Git Repository Size](/refguide/troubleshoot-repository-size/) can have a negative effect on the developer experience.
50+
If your app is eligible for migration, but the SVN repository size exceeds the threshold, you can only migrate the latest commit of the main branch. This limitation has been imposed to guarantee a smooth experience after the migration, as a [large Git Repository Size](/refguide/troubleshoot-repository-size/) can have a negative effect on the developer experience.
5351

5452
{{% alert type="info" %}}
5553

5654
You will receive a full backup of your SVN repository after completing the migration.
5755

5856
{{% /alert %}}
5957

60-
#### Eligible for Migrating With History
58+
#### Not Eligible for Migration
59+
60+
If your app is not eligible for migration the reason(s) will be listed on a page. To continue the process, resolve these reasons and try again.
61+
62+
##### MPR File Size
63+
64+
When the size of the *.mpr* file exceeds the threshold, migration is blocked to prevent rapid repository growth after migrating to Git. To get your app approved for migration, you have to agree on the following steps with Support or your Customer Success Manager:
65+
66+
1. [Migrate without history](#without-history). This requires converging all branches which you want to retain.
67+
2. Update your app to Studio Pro version 10.18 or above, and convert to [MPRv2](/refguide/troubleshoot-repository-size/#mprv2).
68+
3. Execute a [Git cleanup](/refguide/troubleshoot-repository-size/#cleanup-tool).
6169

62-
If your repository is eligible for migrating with full history, you can choose whether to retain your history when migrating or not. For the smoothest experience post-migration we advise you to migrate without history.
70+
The first two steps need to be executed within a short timeframe. The last step is technically optional, but is strongly recommended for the best experience.
6371

6472
## How Migration Works
6573

0 commit comments

Comments
 (0)