Server properties are global properties that apply to operations, users, and devices across an entire XenMobile instance. Citrix recommends that you evaluate for your environment the server properties covered in this article. Be sure to consult with Citrix before changing other server properties.
A change to some server properties requires a restart of each XenMobile Server node. XenMobile notifies you when a restart is required.
Some server properties help improve performance and stability. For details, see Tuning XenMobile Operations.
Deliver legacy Android apps to Android Enterprise devices: If
afw.allow.legacy.apps is set to
true, Android Enterprise devices receive both legacy Android apps and Android Enterprise apps. If
false, Android Enterprise devices only receive Android Enterprise apps. The default is
Allow file extensions for the file policy: Configure
file.extension.allowlist with a comma-separated list of file types that admins can upload using the Files device policy. The following file types can’t be uploaded even if you add them to this allow list:
The default value is
Access all apps in the managed Google Play store: If
true, XenMobile makes all apps from the public Google Play store accessible from the managed Google Play store. Setting this property to
true allows the public Google Play store apps for all Android Enterprise users. Administrators can then use the Restrictions device policy to control access to these apps. Defaults to
Android Enterprise work profile on corporate-owned devices enrollment: When
afw.work_profile_for_corporate_owned_device.enrollment_mode.enabled is set to
true, devices running Android 11 or later can enroll in the work profile on corporate-owned devices (WPCOD) mode. The XenMobile Server console reflects the changes for this enrollment mode. If set to
false, no WPCOD settings are available. The default value is
Additional Android Enterprise restrictions settings: If the property
afw.restriction.policy.v2 is set to
true, the following restriction settings are available for Android Enterprise devices:
- Allow app uninstall
- Allow Bluetooth sharing
For more information about these settings, see Restrictions device policy.
Android Enterprise restrictions for COPE devices: Set
true to enable the Apply to fully managed devices with a work profile/Work profile on corporate-owned devices setting in the restrictions device policy. The default is
true. For more information about this setting, see Restrictions device policy.
Allow hostnames for iOS App Store links: Property
ios.app.store.allowed.hostnames is a list of allowed host names used when uploading public app store apps to the server using the public APIs. If you plan on uploading public app store apps using the public APIs rather than uploading the apps through the server, configure this property. The default value is
Alternative APNs port: You can use port 2197 instead of port 443 to send and receive APNs notifications from
api.push.apple.com. The port uses the HTTP/2-based APNs provider API. Set the property
true to use port 2197. The default value of the server property
Enable password validation to prevent local users with weak passwords: If
enable.password.strength.validation is set to
true, you can’t add local users with a weak password. If set to
false, you can create local users with a weak password. The default is
Block Enrollment of Rooted Android and Jailbroken iOS Devices: When this property is
true, XenMobile blocks enrollments for rooted Android devices and jailbroken iOS devices. Default is
true. Recommended setting is
true for all security levels.
wsapi.mdm.required.flag, which applies only when the XenMobile Server Mode is ENT, specifies whether you require users to enroll in MDM. The property applies to all users and devices for the XenMobile instance. Requiring enrollment provides a higher level of security. However, that decision depends on whether you want to require MDM. By default, enrollment is not required.
When this property is
false, users can decline enrollment, but can still access apps on their devices through the XenMobile Store. When this property is
true, any user who declines enrollment is denied access to any apps.
If you change this property after users enroll, the users must re-enroll.
For a discussion about whether to require MDM enrollment, see Device Management and MDM Enrollment.
Enable multimode enrollment: Property
enable.multimode.xms allows you to create enrollment profiles on one XenMobile Server that controls enrollment settings for both device and app management for Android and iOS devices. In addition, the new enhanced enrollment profiles feature enables enrollment of dedicated devices for Android and MAM-only enrollment for Android and iOS devices. When this property is
false, those enrollment options aren’t available when setting up enrollment profiles. The default value is
true. Devices that enroll when this property is
true still work if you change the property to
Enable the Self-Help Portal: If
false, it prevents access to the Self-Help Portal. Users who navigate to the Self-Help Portal on port 443 get a 404 error. Users who navigate to the portal on port 4443 get an “Access Denied” message. If
true, provides access to the Self-Help Portal over port 443. Defaults to
Local user account lockout limit: Using the restriction policy, you can set a limit on sign-in attempts for Active Directory users. Use the key
local.user.account.lockout.limit to do the same for local user accounts. After users attempt to sign in the number of times you specify, they can’t attempt again until an amount of time passes. Configure that time with the Local user account lockout time property. The default value is
Local user account lockout time: Property
local.user.account.lockout.time allows you to set a number of minutes that must pass before a locked out local user account can attempt to sign in again. The default value is
Maximum size of file upload restriction enabled: Enable restricting the maximum file size for uploads setting
true. If you enable this restriction, configure the maximum file size using
max.file.size.upload.allowed. The default value for this property is
Maximum size of file upload allowed: With
max.file.size.upload.allowed, you can specify a maximum file size for any uploads. Example values include
1 G, or
1 GiB. The default value is
Inactivity Timeout in Minutes: The number of minutes after which XenMobile logs out an inactive user who used the XenMobile Server Public API to access the XenMobile console or any third-party app. A time-out value of
0 means that an inactive user remains logged in. For third-party apps that access the API, remaining logged in is typically necessary. Default is
iOS Device Management Enrollment Install Root CA if Required: The latest enrollment workflow from Apple requires that users manually install the MDM profiles. That workflow doesn’t apply to MDM enrollment to servers assigned in Apple Business Manager or Apple School Manager. However, during manual enrollment in MDM, iOS device users receive only the MDM device certificate prompt during enrollment.
To provide a better user experience during manual enrollment, Citrix recommends changing the server property
false. The default value is
true. With that change, a Safari window opens during MDM enrollment to simplify the profile installation for users.
VPP baseline interval: Property
vpp.baseline sets the minimum interval that XenMobile reimports volume purchase licenses from Apple. Refreshing license information ensures that XenMobile reflects all changes, such as when you manually delete an imported app from volume purchase. By default, XenMobile refreshes the volume purchase license baseline a minimum of every
If you have many volume purchase licenses installed (for example, over 50,000), Citrix recommends that you increase the baseline interval to reduce the overhead of importing licenses. If you expect frequent volume purchase license changes from Apple, Citrix recommends that you lower the value to keep XenMobile updated with the changes. The minimum interval between two baselines is 60 minutes. Because the cron job runs every 60 minutes, if the volume purchase baseline interval is 60 minutes, the interval between baselines can be delayed up to 119 minutes.
XenMobile MDM Self Help Portal console max inactive interval (minutes): This property name reflects the older XenMobile versions. The property controls the XenMobile console max inactive interval. That interval is the number of minutes after which XenMobile logs an inactive user out of the XenMobile console. A time-out of 0 means that an inactive user remains logged in. Default is
Deprecated support for the Nexmo SMS gateway: Property
deprecate.carrier.sms.gateway removes the support for the Nexmo SMS gateway, which is set to True by default. Nexmo SMS is also deprecated in the Self-Help Portal.
Deprecated support for the Mobile Service Provider (MSP) interface: Property
deprecate.mobile.service.provider removes the MSP interface from the XenMobile Server console, which is set to True by default.
Deprecated support for the Windows Information Protection policy: As per the Windows announcement, XenMobile Server has deprecated support for Windows Information Protection (WIP). The server property
windows.wip.deprecation removes the support for WIP, which is set to True by default.
Support for Enterprise apps on macOS devices: If the property
mac.app.push is set to True, the Enterprise apps are automatically installed when downloaded on devices running macOS.
Support for eSim on iOS devices: If the property
ios.esim.support is set to True, then XenMobile Server gets the eSim information from the iOS devices and displays the eSim related device properties on the user interface.
Support for “Domain” field in the Wi-Fi policy for 802.1x settings for Android Enterprise: If the property
afw.network.domain.support is set to True, then the Domain field gets added in the 802.1x settings for Android Enterprise.