Server properties
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, seeTuning XenMobile Operations.
Deliver legacy Android apps to Android Enterprise devices:Ifafw.allow.legacy.apps
is set totrue
, Android Enterprise devices receive both legacy Android apps and Android Enterprise apps. Iffalse
, Android Enterprise devices only receive Android Enterprise apps. The default istrue
.
Allow file extensions for the file policy:Configurefile.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:
- .cab
- .appx
- .ipa
- .apk
- .xap
- .mdx
- .exe
The default value is7z,rar,zip,csv,xls,xlsx,jad,jar,pdf,bmp,gif,jpg,png,pps,ppt,pptx,bsh,js,lua,mscr,pl,py,rb,sh,tcl,txt,htm,html,doc,docx,rtf,xap
.
Access all apps in the managed Google Play store:Iftrue
, XenMobile makes all apps from the public Google Play store accessible from the managed Google Play store. Setting this property totrue
allows the public Google Play store apps for all Android Enterprise users. Administrators can then use theRestrictions device policyto control access to these apps. Defaults tofalse
.
Android Enterprise work profile on corporate-owned devices enrollment:Whenafw.work_profile_for_corporate_owned_device.enrollment_mode.enabled
is set totrue
, 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 tofalse
, no WPCOD settings are available. The default value istrue
.
Additional Android Enterprise restrictions settings:If the propertyafw.restriction.policy.v2
is set totrue
, the following restriction settings are available for Android Enterprise devices:
- Allow app uninstall
- Allow Bluetooth sharing
For more information about these settings, seeRestrictions device policy.
Android Enterprise restrictions for COPE devices:Setafw.restriction.cope
totrue
to enable theApply to fully managed devices with a work profile/Work profile on corporate-owned devicessetting in the restrictions device policy. The default istrue
. For more information about this setting, seeRestrictions device policy.
Allow hostnames for iOS App Store links:Propertyios.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 isitunes.apple.com,vpp.itunes.apple.com,apps.apple.com
.
Alternative APNs port:You can use port 2197 instead of port 443 to send and receive APNs notifications fromapi.push.apple.com
. The port uses the HTTP/2-based APNs provider API. Set the propertyapns.http2.alternate.port.enabled
totrue
to use port 2197. The default value of the server propertyapns.http2.alternate.port.enabled
isfalse
.
Enable password validation to prevent local users with weak passwords:Ifenable.password.strength.validation
is set totrue
, you can’t add local users with a weak password. If set tofalse
, you can create local users with a weak password. The default istrue
.
Block Enrollment of Rooted Android and Jailbroken iOS Devices:When this property istrue
, XenMobile blocks enrollments for rooted Android devices and jailbroken iOS devices. Default istrue
. Recommended setting istrue
for all security levels.
Enrollment required: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 isfalse
, users can decline enrollment, but can still access apps on their devices through the XenMobile Store. When this property istrue
, 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, seeDevice Management and MDM Enrollment.
Enable multimode enrollment:Propertyenable.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 isfalse
, those enrollment options aren’t available when setting up enrollment profiles. The default value istrue
. Devices that enroll when this property istrue
still work if you change the property tofalse
.
Enable the Self-Help Portal:Ifshp.console.enable
isfalse
, 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. Iftrue
, provides access to the Self-Help Portal over port 443. Defaults tofalse
.
Local user account lockout limit:Using the restriction policy, you can set a limit on sign-in attempts for Active Directory users. Use the keylocal.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 theLocal user account lockout timeproperty. The default value is6
.
Local user account lockout time:Propertylocal.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 is30
minutes.
Maximum size of file upload restriction enabled:Enable restricting the maximum file size for uploads settingmax.file.size.upload.restriction
totrue
. If you enable this restriction, configure the maximum file size usingmax.file.size.upload.allowed
. The default value for this property istrue
.
Maximum size of file upload allowed:Withmax.file.size.upload.allowed
, you can specify a maximum file size for any uploads. Example values include500 B
,1 KB
,1 MB
,1 MiB
,1 G
, or1 GiB
. The default value is5 MB
.
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 of0
means that an inactive user remains logged in. For third-party apps that access the API, remaining logged in is typically necessary. Default is5
.
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 propertyios.mdm.enrollment.installRootCaIfRequired
tofalse
. The default value istrue
. With that change, a Safari window opens during MDM enrollment to simplify the profile installation for users.
VPP baseline interval:Propertyvpp.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 every1440
minutes.
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 is30
.
弃用年代upport for the Nexmo SMS gateway:Propertydeprecate.carrier.sms.gateway
removes the support for the Nexmo SMS gateway, which is set toTrueby default. Nexmo SMS is also deprecated in the Self-Help Portal.
弃用年代upport for the Mobile Service Provider (MSP) interface:Propertydeprecate.mobile.service.provider
removes the MSP interface from the XenMobile Server console, which is set toTrueby default.
弃用年代upport for the Windows Information Protection policy:As per the Windowsannouncement, XenMobile Server has deprecated support for Windows Information Protection (WIP). The server propertywindows.wip.deprecation
消除了对在制品的支持,将Trueby default.
Support for Enterprise apps on macOS devices:If the propertymac.app.push
is set toTrue, the Enterprise apps are automatically installed when downloaded on devices running macOS.
Support for eSim on iOS devices:If the propertyios.esim.support
is set toTrue, then XenMobile Server gets the eSim information from the iOS devices and displays the eSim related device properties on the user interface.