Configuration Command

Entering a configuration command rather than a configuration URI makes it even easier for the user who is installing DME, as the user does not need to return to the App Catalog and tap the green Configure button. All configuration is done automatically. The use of configuration commands for DME is currently only supported on devices running iOS 7 or newer.

The configuration command is created in an Application Catalog rule. The command is written as an XML dictionary (configuration) file.

The following fields are needed:

Field (case sensitive)

Required

Description

dmeHostname

Yes

Domain name of DME Server

dmePort

Yes

Default connection port

dmeSecure

Yes

1 for secure (https) connection, 0 for http

dmeUser

Yes

DME Username. Use %ENROLLEDUSER_USERNAME%

dmeExternalId

Yes

The external MDM ID. Use %DEVICEIDENTIFIER%

dmePhone

No

Device phone number. Use %PHONENUMBER%

Note: The external MDM might not know the device's phone number

The value of these fields should be inserted where the [text in brackets] are shown in the example below:

<dict>
	<key>dmeHostname</key>
	<string>[Domain name of DME server]</string>


	<key>dmePort</key>


	<string>[Default connection port]</string>




	<key>dmeSecure</key>


	<string>[https (1) or http (0)]</string>




	<key>dmeUser</key>


	<string>%ENROLLEDUSER_USERNAME%</string>




	<key>dmeExternalId</key>


	<string>%DEVICEIDENTIFIER%</string>




	<key>dmePhone</key>


	<string>%PHONENUMBER%</string>


</dict>




Note that for MobiControl to know the device's Username (%ENROLLEDUSER_USERNAME%), the device must have been enrolled using the option Utilize User Directory credentials to verify device enrollment in the Authentication part of the Add Devices rule.


Unlike the configuration URI, a MobiControl variable that cannot be resolved will not cause the entire configuration command will fail. If a variable cannot be resolved, the variable name will simply be inserted - for instance, if the %PHONENUMBER% variable cannot be resolved to an actual phone number, DME will display the text %PHONENUMBER% in the DME client where the phone number should go. 







Next topic
DME installation message template