This documentation is for WSO2 Enterprise Mobility Manager 2.2.0. View documentation for the latest release.
Installing WSO2 EMM iOS Features via the P2 Repository - Enterprise Mobility Manager 2.2.0 - WSO2 Documentation
Enterprise Mobility Manager 2.2.0
||
Skip to end of metadata
Go to start of metadata

The P2 repository contains the feature list required to enable iOS.  

If you are on a Windows OS, be sure to point the -Dcarbon.home property in the product's startup script (wso2server.bat) to the product's distribution home (e.g., -Dcarbon.home=C:\Users\VM\Desktop\wso2emm- 2.2.0). Alternatively, you can also set the carbon.home as a system property in Windows. Then, restart the server. Without this setting, you might not be able to install features through the management console.

Where do I get the P2 repository from?

 After you obtained the signed CSR and submitted it, the WSO2 Account Managers will evaluate the CSR file you submitted. Once the evaluation process is complete, you will receive an email with the following:

  • WSO2 MDM Connector for iOS
    This contains the P2 repository with the iOS features, End User License Agreement (EULA) and the README.txt.
    The README.txt includes the installation instructions and the URL to the cdmf-agent-ios repository, which contains the agent source code.
  • The signed CSR file in the .plst format

If you failed the evaluation process or have your own signed certificate, fill the Contact Us form, select IoT as the area of interest, and request for the P2 repository for EMM 220, which is needed to configure WSO2 IoT Server for iOS.

Follow the instruction below to install the iOS features via the P2 repository you received via email:

  1. Access the Management Console.

     Click here for more information.

    Start the server before carrying out the instructions below.

    Follow the instructions below to sign into the EMM Management Console:

    1. Access the EMM Management Console: https://<EMM_HOST>:<EMM_PORT>/carbon

      • By default, <EMM_HOST> is localhost. However, if you are using a public IP, the respective IP address or domain needs to be specified.
      • By default, <EMMS_PORT> has been set to 9443 for HTTPS. However, if the port offset has been incremented by n, the default port value needs to be incremented by n.

      The following interface appears:

    2. Enter your username. The default username is admin. This field is case sensitive.
    3. Enter your password. The default password is admin. This field is case sensitive.
    4. If you wish your browser to save your login details, select the Remember Password checkbox.
    5. Click Sign-in. 

  2. Click Features on the Configure tab.
  3. Click Add Repository that is on the Repository Management tab to add the repository to the server.
  4. Fill out the Add Repository form and click Add.

    1. Enter a preferred name for the repository as the Name.

    2. Select the Location.
      If the local option is selected for location, you need to provide the path to the current working directory. 
      Follow the steps below to retrieve the path:

      1. Unzip the p2-repo.zip file you received via email when obtaining the CSR file and navigate to the respective directory.

        cd <EMM_HOME>/p2-repo

      2. Retrieve the output path of the current working directory.

        pwd

        Example output:

        /Users/Documents/EMM/p2-repo

  5. Click the Available Features tab and select the respective repository, and click Find Features.

    If the Group features by category is selected by default, deselect it before checking for the available features.

  6. Select the feature and click Install.
  7. Click Next.

  8. Accept the license agreement and click Next to install the features.

  9. Once the features are successfully installed, you will be prompted to click Restart Now and Restart Later.

    Until you complete step 10 and 11 don't click Restart Now.

  10. Update the following parameters in the ios-config .xml file, which is in the <EMM_HOME>/repository/conf directory: 
    Enter the server IP or the server domain name for the following parameters:

    • iOSEnrollURL

    • iOSProfileURL

    • iOSCheckinURL

    • iOSServerURL TokenURL

    For example:

    <?xml version="1.0" encoding="ISO-8859-1"?>
<iOSEMMConfigurations>
    <!-- iOS MDM endpoint urls -->
    <iOSEnrollURL>https://10.10.10.193:9443/ios-enrollment/scep</iOSEnrollURL>
    <iOSProfileURL>https://10.10.10.193:9443/ios-enrollment/profile</iOSProfileURL>
    <iOSCheckinURL>https://10.10.10.193:9443/ios-enrollment/checkin</iOSCheckinURL>
    <iOSServerURL>https://10.10.10.193:9443/ios-enrollment/server</iOSServerURL>
</iOSEMMConfigurations>

  11. Uncomment the APNSBasedPushNotificationProvider that is under the PushNotificationProviders configuration in the <EMM_HOME>/repository/conf/cdm-config.xml file.
    For example:

    <PushNotificationProviders>
    <Provider>org.wso2.carbon.device.mgt.extensions.push.notification.provider.gcm.GCMBasedPushNotificationProvider</Provider>
    <Provider>org.wso2.carbon.device.mgt.mobile.impl.ios.apns.APNSBasedPushNotificationProvider</Provider>
    <!--<Provider>org.wso2.carbon.device.mgt.extensions.push.notification.provider.mqtt.MQTTBasedPushNotificationProvider</Provider>-->
    <!--<Provider>org.wso2.carbon.device.mgt.extensions.push.notification.provider.xmpp.XMPPBasedPushNotificationProvider</Provider>-->
</PushNotificationProviders>
  12. Go back to the EMM Management console and click Restart Now.

What's next?

Next, you need to configure the general iOS server settings.

  • No labels
||