Ethernet Manager

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

Input fields accept ENGLISH ONLY.

Queries from MX are not supported on Zebra devices running Android 11 or later. See alternative method.

Overview

Ethernet Manager (EthernetMgr) is used to administer settings for devices connected to a network through an Ethernet-equipped cradle. This CSP has no effect on Wi-Fi communications or wireless Ethernet adapter settings, which are controlled through the Wi-Fi Manager.

Main Functionality

  • Enable/Disable network connection through an Ethernet-equipped cradle
  • Configure the following settings in cradled device(s):
    • Automatically obtain an IP address via DHCP
    • Assign a static IP address, DNS server, default gateway and subnet mask
    • Enable/Disable use of a Proxy
    • Set the Proxy Port and Proxy Host Name
    • Enter Host Name(s) and/or IP address(es) that bypass the Proxy
    • Set the authentication method used for access to a network
  • Enter the following for connecting to a network from a cradled device:
    • Username and password
    • Client certificate
    • Optional server certificate
    • The domain name of a network to be joined

Settings configured through EthernetMgr are stored in the connected device(s); settings DO NOT persist in the cradle.

Ethernet Enable/Disable

Used to control the ability of a device to connect with a network via Ethernet when it is placed in an Ethernet-equipped cradle.

This parameter has no effect on Wi-Fi communications or wireless Ethernet adapter settings.

Parm Name: EthernetState

Option Name Description Note Status Requires
0 Do not change This value (or the absence of this parm from the XML) will cause no changes to the Ethernet state; any previously selected setting will be retained.

OSX: 6.2+

MX: 6.2+

Android API: 23+

1 Turn On Enables network connectivity through an Ethernet cradle port.

OSX: 6.2+

MX: 6.2+

Android API: 23+

2 Turn Off Disables network connectivity through an Ethernet cradle port.

OSX: 6.2+

MX: 6.2+

Android API: 23+

Configure IP Address (checkbox)

Controls whether a device placed in an Ethernet-equipped cradle can be assigned an IP address, either manually or through DHCP. When enabled (value=1), an IP address can be obtained automatically from a DHCP server (the default setting) or assigned manually by an administrator using the relevant parameters (below).

Parm Name: ConfigIpAddr

Option Name Description Note Status Requires
0 (unchecked) Prevents an IP address from being assigned manually or through DHCP.

OSX: 6.2+

MX: 6.2+

Android API: 23+

1 (checked) Allows an IP address to be assigned manually or through DHCP.

OSX: 6.2+

MX: 6.2+

Android API: 23+

Use DHCP (checkbox)

Controls whether a device placed in an Ethernet-equipped cradle obtains an IP settings automatically using DHCP. When disabled (value=0), the IP addresses for the device, default gateway, subnet mask and at least one DNS server must be specified manually using the relevant parameters (below) if internet connectivity is desired.

Shown if: ConfigIPAddress is "checked"

Parm Name: UseDHCP

Option Name Description Note Status Requires
0 (unchecked) Allows IP address settings to be configured manually.

OSX: 6.2+

MX: 6.2+

Android API: 23+

1 (checked) Sets the device to obtain IP settings from a DHCP server.

OSX: 6.2+

MX: 6.2+

Android API: 23+

Set IP Address

Used to enter an IP address to assign to a device for connection to the internet through an Ethernet-equipped cradle. Must be an address that is unique to the network on which the device will operate.

Parm value input rules:

  • String containing a valid IPv4 address (e.g. 192.168.0.100)

Shown if: The "Configure IP Address" box is checked and "Use DHCP" box is unchecked

Parm Name: IpAddress

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API: 23+

Set Default Gateway

Used to enter the IP address of the default gateway for a device when connected to an Ethernet-equipped cradle, through which packets to and from outside networks are routed. This parameter is required only if the device must have access to (or from) networks beyond its local subnet.

Parm value input rules:

  • String containing a valid IPv4 address (e.g. 192.168.0.1)

Shown if: The "Configure IP Address" box is checked and "Use DHCP" box is unchecked

Parm Name: Gateway

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API: 23+

Set Subnet Mask

Used to enter the subnet mask for a device when connected to an Ethernet-equipped cradle, which defines the network subdivision on which the device will operate.

Parm value input rules:

  • String containing a valid IPv4 address (e.g. 255.255.255.0)

Shown if: The "Configure IP Address" box is checked and "Use DHCP" box is unchecked

Parm Name: NetMask

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API: 23+

Set Primary DNS

Used to enter the primary domain name server for a device when connected to an Ethernet-equipped cradle.

Parm value input rules:

  • String containing a valid IPv4 address (e.g. 8.8.8.8)

Shown if: The "Configure IP Address" box is checked and "Use DHCP" box is unchecked

Parm Name: DNS1

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API: 23+

Set Secondary DNS

Used to enter the secondary domain name server for a device when connected to an Ethernet-equipped cradle.

Parm value input rules:

  • String containing a valid IPv4 address (e.g. 8.8.4.4)

Shown if: The "Configure IP Address" box is checked and "Use DHCP" box is unchecked

Parm Name: DNS2

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API: 23+

Ethernet Proxy Enable/Disable

Controls whether an Ethernet Proxy is used by the device when connecting to a network through an Ethernet-equipped cradle. When "None" is selected (value=1), all Ethernet transactions are conducted directly from the device. When "Manual" is selected (value=2), a Proxy Host Name and Proxy Host Port must be specified, and traffic is routed through that server.

Parm Name: SetEthernetProxySettings

Option Name Description Note Status Requires
0 Do not change This value (or the absence of this parm from the XML) causes no change to Ethernet Proxy settings; any previously selected setting is retained.

OSX: 6.2+

MX: 6.2+

Android API: 23+

1 None Disables the use of an Ethernet Proxy.

OSX: 6.2+

MX: 6.2+

Android API: 23+

2 Manual Enables the use of an Ethernet Proxy.

OSX: 6.2+

MX: 6.2+

Android API: 23+

Set Proxy Host Name

Used to enter the Host Name of the Proxy server through which network communications will pass.

Parm value input rules:

  • String from 1–64 characters containing the Proxy Host Name (e.g. www.MyProxyHostServer.com)

Shown if: Ethernet Proxy Setting is "Manual"

Parm Name: ProxyHostName

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API: 23+

Set Proxy Port

Used to enter the two-digit Port number for accessing the Proxy server through which network communications will pass.

Parm value input rules:

  • Integer containing the two-digit port number of the proxy server being used

Shown if: Ethernet Proxy Setting is "Manual"

Parm Name: ProxyPort

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API: 23+

Set Bypass Proxy

Used to enter the host name(s) and/or IP address(es) for direct access by a device, bypassing the Proxy server specified in the Proxy Host Name parameter. Multiple names and/or IP addresses can be specified in any combination, separated by commas. Generally used for entering internal servers and/or as a means to prevent traffic overload on the specified Proxy server. Traffic bound for any host not specifically excluded using this parameter will be routed through the specified Proxy server.

Zebra recommends testing bypass-proxy settings on a working device before general deployment.

Parm value input rules:

  • String from 1-256 characters entering one or more host names and/or IP addresses separated by commas. For example: "www.MyBypassProxy.com,192.168.1.100,our.internalServer.lan"

Shown if: Ethernet Proxy Setting is "Manual"

Parm Name: BypassProxy

Requires:

  • OSX: 6.2+
  • MX: 6.2+
  • Android API: 23+

Authentication Type

Used to select the type of authentication required for connecting to a network.

Note: This feature is supported only on Zebra 6490-platform devices.

Parm Name: Authentication

Option Name Description Note Status Requires
99 Do not change This value (or the absence of this parm from the XML) causes no change to device settings; any previously selected setting is retained.

MX: 13.3+

Android API: 33+

0 Disable Sets the authentication type to 'NONE'

MX: 13.3+

Android API: 33+

1 EAP-TLS Sets authentication to 802.1x Extensible Authentication Protocol - Transport Layer Security (EAP-TLS).

MX: 13.3+

Android API: 33+

Identity

Used to enter the user name for authentication on a network.

Parm value input rules:

  • String from 0–64 characters containing the network user name

Note: This feature is supported only on Zebra 6490-platform devices.

Shown if: Authentication is set to "EAP-TLS" or "PEAP-MSCHAPV2"

Parm Name: Identity

Requires:

  • MX: 13.3+
  • Android API: 33+

Password

Used to enter the password corresponding to the user name entered in the Identity field.

Parm value input rules:

  • String from 0–64 characters containing the relevant password

Note: This feature is supported only on Zebra 6490-platform devices.

Shown if: Authentication is set to "PEAP-MSCHAPV2"

Parm Name: Password

Requires:

  • MX: 13.3+
  • Android API: 33+

Domain Name

Used to enter the domain name of the network to be joined.

Parm value input rules:

  • String from 0–64 characters containing a valid domain name (e.g. myCompanyDomain.com)

Note: This feature is supported only on Zebra 6490-platform devices.

Parm Name: DomainName

Requires:

  • MX: 13.3+
  • Android API: 33+

Mandatory Client Certificate

Used to enter the name of the certificate to validate a user on a network.

Parm value input rules:

  • String from 1–64 characters containing a client certificate

Note: This feature is supported only on Zebra 6490-platform devices.

Shown if: Authentication is set to "EAP-TLS"

Parm Name: MandatoryClientCertificate

Requires:

  • MX: 13.3+
  • Android API: 33+

Optional CA Certificate

Used to enter the name of the optional certificate (if used) to validate a server on a network.

Parm value input rules:

  • String from 0–64 characters containing a CA server certificate

Note: This feature is supported only on Zebra 6490-platform devices.

Shown if: Authentication is set to "EAP-TLS" or "PEAP-MSCHAPV2"

Parm Name: OptionalCACertificate

Requires:

  • MX: 13.3+
  • Android API: 33+