Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Table of Contents
maxLevel3
minLevel3

Configuration changes

The following are some of the changes in EMM 1.1.0 configurations compared to EMM 1.0.1 that need to be taken into consideration.

  • The mdm-config.xml, which is in the <EMM_HOME>/repository/conf/ directory, has been renamed to emm-config.xml in EMM 1.1.0 together with the following tags:

    EMM 1.0.1 TagEMM 1.1.0 Tag
    <ios-enroll-url><iOSEnrollURL>
    <ios-profile-url><iOSProfileURL>
    <ios-checkin-url><iOSCheckinURL>
    <ios-server-url><iOSServerURL>
    <ios-device-property-post-url><TokenURL>
  • The following configurations in the mdm-config.xml file, which is in the <EMM_HOME>/repository/conf/ directory, have been removed in EMM 1.1.0 and these configurations need to be configured via the iOS Settings page in the EMM Console.

    Code Block
    <!-- iOS APNS configurations -->
                   <ios-apns-cert-path>[APNS-CERTIFICATE-PATH]</ios-apns-cert-path>
                   <ios-apns-cert-password>[APNS-PASSWORD]</ios-apns-cert-password>
                   <ios-apns-production-mode>true</ios-apns-production-mode>
      
                   <!-- iOS MDM APNS configurations -->
                   <ios-mdm-apns-cert-path>[MDM-APNS-CERTIFICATE-PATH]</ios-mdm-apns-cert-path>
                   <ios-mdm-apns-cert-password>[MDM-APNS-PASSWORD]</ios-mdm-apns-cert-password>
                   <ios-mdm-apns-production-mode>true</ios-mdm-apns-production-mode>
    
                   <!-- iOS mdm topic id -->
                   <ios-mdm-topic-id>[MDM-TOPIC-ID]</ios-mdm-topic-id>

Preparing to upgrade

The following are the specific prerequisites you must complete before you upgrade from EMM 1.0.1 to EMM 1.1.0:

...

  1. Copy the data from the old database (EMM 1.0.1) to the staging database you created. This becomes the new database for your new version of WSO2 EMM.

  2. Download EMM 1.1.0 and connect it to your staging database.
  3. Configure the following files for the new production server. 
  4. Run the attached mysql_migration.sql script in to the EMM MySQL DB.
  5. Navigate to the <EMM_HOME>/repository/deployment/server/jaggeryapps/publisher/upload/ directory in the WSO2 EMM 1.0.1 pack and copy the content in that folder to the same location in the WSO2 EMM 1.1.0 pack.
  6. The mdmUpdate the EMM server domain and port in the following emm-config.xml file, which is in the <EMM_HOME>/repository/conf/ directory, has been renamed to emm-config.xml in EMM 1.1.0 together with the following tags:

    EMM 1.0.1 TagEMM 1.1.0 Tag
    <ios-enroll-url><iOSEnrollURL>
    <ios-profile-url><iOSProfileURL>
    <ios-checkin-url><iOSCheckinURL>
    <ios-server-url><iOSServerURL>
    <ios-device-property-post-url><TokenURL>

      Ensure to configure the EMM server domain and port in the following emm-config.xml file configurations directory, as follows:

    Code Block
    <iOSEnrollURL>[EMM-SERVER-DOMAIN]:[PORT]/emm/scep</iOSEnrollURL>
    <iOSProfileURL>[EMM-SERVER-DOMAIN]:[PORT]/emm/profile</iOSProfileURL>
    <iOSCheckinURL>[EMM-SERVER-DOMAIN]:[PORT]/emm/checkin</iOSCheckinURL>
    <iOSServerURL>[EMM-SERVER-DOMAIN]:[PORT]/emm/server</iOSServerURL>
    <TokenURL>[EMM-SERVER-DOMAIN]:[PORT]/emm/api/devices/iostokenregister</TokenURL> 
  7. Perform any configurations required for the server (e.g., external user stores, clustering, caching, mounting etc.). 

    Note

    Note that configurations should not be copied directly between servers. 

  8. Start the server.

...