Remote Management Server General Settings
The Remote Management Server allows you to fully monitor and administer your iPad kiosks in the field through a simple web-based interface. This interface allows you to monitor the device through regular heartbeats and event logs, upload new content or settings to Kiosk Pro, and report kiosk usage by session length and navigation history.
In this article
Enable Remote Management Server
Supported in:
This toggle controls the Remote Management Server feature.
Default Value: Off
In addition to turning on this toggle, you will need to set a Site Name, and a Kiosk Name and/or Unit Name in order for Kiosk Pro to connect to your Remote Management Server account.
Values for Remote Settings Control & Managed App Configuration
Key | enabledKWC |
---|---|
Key Type | boolean |
Default Value | false |
Site Name
Supported in:
The Site Name is preconfigured in the Remote Management Server when you sign up for an account.
This setting applies to all of your kiosks and cannot be changed without updating each individual kiosk.
Default Value: blank
Values for Remote Settings Control & Managed App Configuration
Key | KWC_SiteName |
---|---|
Key Type | string |
Default Value | (blank) |
Kiosk Name
Supported in:
The Kiosk Name is the primary identifier of your kiosk. Each Kiosk Name must be unique to that iPad kiosk.
Default Value: blank
The Kiosk Name is required, unless a Unit Name is set. It must be composed of standard alphanumeric characters and cannot include any special characters, including periods, hyphens or underscores.
Values for Remote Settings Control & Managed App Configuration
Key | KWC_KioskName |
---|---|
Key Type | string |
Default Value | (blank) |
Note: This identifier is not included in a Remote Settings or Managed App Configuration export from within the app as it is expected to be unique to a single kiosk. As such, it must be manually added to a file if needed using the following formats:
Remote Settings Control (current V2 XML format) & Managed App Configuration
<key>KWC_KioskName</key> <string>ENTER KIOSK NAME HERE</string> (this would be inserted alongside other settings in between an opening <dict> and closing </dict> tag within the file)
Remote Settings Control (legacy XML format)
<dict> <key>Key</key><string>KWC_KioskName</string> <key>Value</key><string>ENTER KIOSK NAME HERE</string> </dict><br>
In addition, this value cannot be overwritten with a blank value during a Remote Settings Update without additional configuration - see this article for more detail.
Unit Name
Supported in:
The Unit Name acts as a secondary identifier. While it does not have to be unique, the Unit Name is required, unless a Kiosk Name is set. It must be composed of standard alphanumeric characters and cannot include any special characters, including periods, hyphens or underscores.
Default Value: blank
Values for Remote Settings Control & Managed App Configuration
Key | KWC_UnitName |
---|---|
Key Type | string |
Default Value | (blank) |
Note: This identifier is not included in a Remote Settings or Managed App Configuration export from within the app as it is expected to be unique to a single kiosk. As such, it must be manually added to a file if needed using the following formats:
Remote Settings Control (current V2 XML format) & Managed App Configuration
<key>KWC_UnitName</key> <string>ENTER UNIT NAME HERE</string> (this would be inserted alongside other settings in between an opening <dict> and closing </dict> tag within the file)
Remote Settings Control (legacy XML format)
<dict> <key>Key</key><string>KWC_UnitName</string> <key>Value</key><string>ENTER UNIT NAME HERE</string> </dict><br>
In addition, this value cannot be overwritten with a blank value during a Remote Settings Update without additional configuration - see this article for more detail.
Settings XML Filename
Supported in:
Configure a specific filename that will be used to initiate a remote settings update through the Remote Management Server interface.
Default Value: settings.xml
To update the app’s settings through the Remote Management Server, you’ll first need to create an .xml file with the preferred app settings (either manually using a template or automatically by exporting settings from a configured device).
Once you have that file, upload it through the Site File Manager in the RMS interface and set up a content update including that file. More information on setting up content updates is available here.
During a content update, the app will check to see if any files downloaded match the filename configured in this setting. If it matches, the settings defined in the file will be applied and an event log confirming the update will be posted.
Using Multiple XML files
You can use multiple XML files in this setting by separating the filenames with a comma (for example: "texas.xml,store3.xml"). This is helpful if you need one configuration for multiple kiosks, and a different configuration for a specific kiosk. The XML files will be applied in the order they are listed. If a specific key is included in multiple files, the last file applied will take precedence - to prevent confusion we generally recommend only including a specific key in one of the files to be applied.
Values for Remote Settings Control & Managed App Configuration
Key | KWC_xmlFilenameForRemoteSettingsControl |
---|---|
Key Type | string |
Default Value | settings.xml |
Change Log
Included in the initial release of Enterprise. Added to Plus in version 6.2