Skip to content

Prerequisites for MobileIron Core as source

Required environment’s information

You need to first setup all general prerequisites before proceeding to this guide.

Get the Exodus Companion App on your devices

This setup need to be done in your source EMM and will differ depending on the OS of your targeted devices.

For iOS devices

You need to add the Exodus companion app from the AppStore to your source EMM’s app catalog via: Apps › Add › iTunes, then add its AppStore id 1437619180 or name Exodus companion in the Application Name field to find it (see fig. 1.1).

figure 1.1

Search iOS Companion app

In App Configuration step, make sure to check the three options:

  • Send installation request or send convert unmanaged to managed app request (iOS 9 and later) on device registration or sign-in
  • Enforce conversion from unmanaged to managed app (iOS 9 or later)
  • Update app when new version is available with Automatically update app when new version is available

And uncheck Remove app when MDM profile is removed to make sure the companion can continue managing the reenrollment in your target EMM after retiring from your MobileIron Core source server (see fig. 1.2).

figure 1.2

Managed App Settings

Once the application is setup in your App Catalog, you need to create a Managed App Config by following the menu: Policies & Config › Configurations › Add New › Apple › iOS / tvOS › Managed App Config (see fig. 1.3).

figure 1.3

Create Managed App Config

From here, enter a name for the configuration, the Exodus Companion bundle id io.h2g.exodus-ios then create and upload a plist file with the following content (see fig. 1.4):

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>server-url</key>
    <string>https://#your-instance-name#-api.exodus.tools</string>
    <key>serial-number</key>
    <string>$DEVICE_SN$</string>
</dict>
</plist>

Important

Don't forget to replace #your-instance-name# by your real instance name which should be equal to the subdomain of your Exodus console url

_(eg. if you access Exodus admin console with https://example.exodus.tools/ then the server url should be https://example-api.exodus.tools)

figure 1.4

Setup Exodus Companion config

For Android devices

For Android devices, nothing needs to be done. Each user will install the companion app themselves by following a dynamic link sent to them via an email by the Exodus server when the migration will start.

Work profile

For Work Profile, it's strongly recommended to approve the Exodus companion application from your Google Play Enterprise Account.

Note

The Exodus companion application must be installed outside the Work Profile container.
But if a user tries to start their migration inside the Work Profile container, with an approved application, we can help them follow the migration steps. Otherwise, they will be redirected to an empty page on the Play Store.

For Mac computers

Migration of Mac computers from MobileIron Core is not supported in Exodus.