Hosts Manager

Note: To display only the features present on a particular device, select one or more filters from the SmartDocs bar below.

Language Note: Input fields accept ENGLISH ONLY.

StageNow - 5.6

Overview

The Hosts Manager (HostsMgr) allows a device to be assigned a Host Name by which it can be identified by admins, applications and other devices on local and DNS-enabled IP networks. The Host Name binds the device's friendly name (i.e. “MyDevice”) to its IP address so that its friendly name can be used interchangeably with its "unfriendly" IP address. A friendly name can be registered with a DNS Server (if one is present on a given network) when the device joins that network, thereby allowing other stations on the network to more easily identify other devices present on the network.

Main Functionality

  • Set and display a friendly Host Name
  • Set and display a friendly Device Name

Set Host Name

This parm permits a Host Name to be assigned to a device, binding that name to the device IP address. The device can then be identified using its friendly name (i.e. “MyDevice”) by admins, applications and other devices on local and DNS-enabled IP networks. Once bound, the Host Name and IP address can be used interchangeably. A friendly name also can be registered with a DNS Server (if one is present on a given network) when the device joins that network, thereby allowing other stations on the network to more easily identify other devices present on the network.

Parm value rules

  • Accepts a string in field HostName
  • Minimum size is 0 characters (no name assigned); maximum size is 255 characters
  • Does not accept the ampersand (&) character; other special characters are allowed

Status: In devices running Android 13 and later, this feature can be accessed through StageNow and compatible EMM systems, or using Android Device Policy Manager (DPM) APIs.

Parm Name: HostName

Requires:

  • MX: 5.1+

Set Device Name

Used to enter a friendly Device Name to a device, binding that name to the device IP address. This allows the device to be identified using its friendly name (i.e. “MyDevice”) by admins, applications and other devices on local and DNS-enabled IP networks. Once bound, the Device Name and IP address can be used interchangeably and registered with a DNS Server.

Parm input rules:

  • Accepts a string from 0 (no name assigned) to 255 alpha-numeric and/or special characters
  • Ampersand (&) character not supported

Parm Name: HostName

Requires:

  • MX: 11.5+

Examples

Set Host Name

Input


<wap-provisioningdoc>
    <characteristic type="HostsMgr">
        <parm name="HostName" value="MyDevice"/>
    </characteristic>
</wap-provisioningdoc>

Output


<wap-provisioningdoc>
    <characteristic type="HostsMgr" version="5.1">
       <parm name="HostName" value="MyDevice"/>
    </characteristic>
    </wap-provisioningdoc>


Get Current Host Name (and CSP version)

Input

<wap-provisioningdoc>
    <characteristic type="HostsMgr">
        <parm-query name="Version"/>
        <parm-query name="HostName"/>
    </characteristic>
</wap-provisioningdoc>

Output

<wap-provisioningdoc>
    <characteristic type="HostsMgr" version="5.1">
        <parm name="Version" value="5.1.1"/>
        <parm name="HostName" value="MyDevice"/>
        </characteristic>
    </wap-provisioningdoc>