While migrating File Server to SharePoint Online in a Multigeo Tenant I realized that there was no Migration Manager Agent available for the migration job. After some research, thanks o a colleague, I came back to the Migration-Manager Setup documentation. So as a reminder to myself and for everyone who came across this issue here are the steps to use the agent in a Multi-Geo Tenant.

When the setup routine is started, don’t click on “Next”.

While leaving this window open, open windows explorer and switch to the temporary install path of the agent: 

%temp%\SPMigrationAgentSetup\SPMigrationAgentSetup\

The relvant file is: “Microsoft.SharePoint.Migration.ClientShared.dll.config” The default content of the file is:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    </assemblyBinding>
  </runtime>
  <appSettings>
    <clear />
    <add key="ClientManifestURL" value="mmagent/migrationclientinstall.json" />
    <add key="UpgraderManifestURL" value="mmagent/upgraderinstall.json" />
    <add key="UseNewAppId" value="1" />
    <add key="IsPrivateBuild" value="0" />
  </appSettings>
</configuration>

According to the setup documentation it is necessary to add a key for the required geolocation:

<add key="GeoLocation" value="DEU" />

The geolocation is odentified by the three letter country code documented here for geolocations: Microsoft 365 multi-geo availability

The config file for the german geolocation looks like:

<?xml version="1.0" encoding="utf-8"?>
<configuration>
  <runtime>
    <assemblyBinding xmlns="urn:schemas-microsoft-com:asm.v1">
    </assemblyBinding>
  </runtime>
  <appSettings>
    <clear />
    <add key="ClientManifestURL" value="mmagent/migrationclientinstall.json" />
    <add key="UpgraderManifestURL" value="mmagent/upgraderinstall.json" />
    <add key="UseNewAppId" value="1" />
    <add key="IsPrivateBuild" value="0" />
    <add key="GeoLocation" value="DEU" />
  </appSettings>
</configuration>

After saving the config file we can complete the setup wizard. Now we have an agent available in the german geolocation. I hope this helps someone who is struggeling with no available agent, like me.

And yes, it would be nice to see this option in the setup GUI of the agent. Because this feels like a hack.

Glück Auf

Adrian

Sources:

https://learn.microsoft.com/en-us/sharepointmigration/mm-setup-clients#multi-geo-agent-setup

Share