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.
TheREADME.txt
includes the installation instructions and the URL to thecdmf-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:
Access the Management Console.
- Click Features on the Configure tab.
- Click Add Repository that is on the Repository Management tab to add the repository to the server.
- Fill out the Add Repository form and click Add.
Enter a preferred name for the repository as the Name.
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: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
Retrieve the output path of the current working directory.
pwd
Example output:
/Users/Documents/EMM/p2-repo
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.
- Select the feature and click Install.
- Click Next.
Accept the license agreement and click Next to install the features.
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.
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>
Uncomment the
APNSBasedPushNotificationProvider
that is under thePushNotificationProviders
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>
- Go back to the EMM Management console and click Restart Now.
What's next?
Next, you need to configure the general iOS server settings.