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.

Enable Remote Management Server

Supported in:

Kiosk Pro Plus and Enterprise

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:

Kiosk Pro Plus and Enterprise

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:

Kiosk Pro Plus and Enterprise

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:

Kiosk Pro Plus and Enterprise

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:

Kiosk Pro Plus and Enterprise

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

Still stuck? How can we help? How can we help?