OEM Default Configuration¶
Your product may contain settings that are different from the Lantronix factory defaults for the gateway. If so, you can define the default configuration to your settings.
You send the XML to load the XML configuration record (XCR). To change the default configuration, import the configuration settings that differ from the default with the following XML. You can do this through the serial port or the Web APIs. You do not need to import the entire configuration.
When importing configuration, you need to provide the current password, if set, in the XML Import Control configgroup. To change the password, provide the new password in the OEM configgroup.
<?xml version="1.0" standalone="yes"?>
<!DOCTYPE configrecord [
<!ELEMENT configrecord (configgroup+)>
<!ELEMENT configgroup (configitem+)>
<!ELEMENT configitem (value+)>
<!ELEMENT value (#PCDATA)>
<!ATTLIST configrecord version CDATA #IMPLIED>
<!ATTLIST configgroup name CDATA #IMPLIED>
<!ATTLIST configgroup instance CDATA #IMPLIED>
<!ATTLIST configitem name CDATA #IMPLIED>
<!ATTLIST configitem instance CDATA #IMPLIED>
<!ATTLIST value name CDATA #IMPLIED>
]>
<configrecord version = "0.1.0.1">
<configgroup name = "XML Import Control">
<configitem name = "OEM">
<value>Set Configuration</value>
</configitem>
<configitem name = "Password">
<value>[current-password]</value>
</configitem>
</configgroup>
<configgroup name = "OEM">
<configitem name = "Interface" instance = "eth0">
<value name = "MAC Address">00 80 A3 B7 6A 59</value>
</configitem>
<configitem name = "Region">
<value>Japan</value>
</configitem>
<configitem name = "Password">
<value>[new-password]</value>
</configitem>
</configgroup>
</configrecord>
The XML Import Control configgroup with the Set Configuration value is necessary to save the OEM configuration as the factory default configuration.
The password, if set, protects your OEM configuration from being changed subsequently unless the XML Import Control configgroup contains the password. Set a password to keep your device secure. For more information on keeping your device secure, see Securing Your Device.
Removing OEM Configuration¶
To remove the OEM configuration and restore it to the default configuration, include Remove Configuration as shown in the following example:
<?xml version="1.0" standalone="yes"?>
<!-- Automatically generated XML -->
<!DOCTYPE configrecord [
<!ELEMENT configrecord (configgroup+)>
<!ELEMENT configgroup (configitem+)>
<!ELEMENT configitem (value+)>
<!ELEMENT value (#PCDATA)>
<!ATTLIST configrecord version CDATA #IMPLIED>
<!ATTLIST configgroup name CDATA #IMPLIED>
<!ATTLIST configgroup instance CDATA #IMPLIED>
<!ATTLIST configitem name CDATA #IMPLIED>
<!ATTLIST configitem instance CDATA #IMPLIED>
<!ATTLIST value name CDATA #IMPLIED>
]>
<configrecord version = "0.1.0.1">
<configgroup name = "XML Import Control">
<configitem name = "OEM">
<value>Remove Configuration</value>
</configitem>
<configitem name = "Password">
<value>[secret-phrase]</value>
</configitem>
</configgroup>
</configrecord>
OEM Specific Settings¶
You can configure OEM specific settings such as the region code and/or MAC Address to values that differ from the Lantronix factory default configuration.
The region code should be configured to the region where your product will be sold.
The MAC address can be configured for the different interface instances.
Changing Region Code¶
Set the region code to the region where the unit will be used.
The following region codes are supported:
- United States
- Canada
- Japan
- European Union
- China
- Australia
- New Zealand
- India
- Taiwan
- Korea
To change the region code, include the following XML, with the Region value configured to the appropriate region:
<configrecord version = "0.1.0.1">
<configgroup name = "OEM">
<configitem name = "Region">
<value>Japan</value>
</configitem>
</configgroup>
</configrecord>
If the unit will be used in a different region not listed above, contact your Lantronix FAE or Technical Support to get specific regional code information.
Changing MAC Address¶
You can configure the MAC address for the interface instances. If you don't specify the interface, it will assign to eth0 by default. When you change the MAC address, the DHCP server will assign a different DHCP address on eth0 and wlan0.
To change the MAC address, include the following XML:
<configrecord version = "0.1.0.1">
<configgroup name = "OEM">
<configitem name = "Interface" instance = "ap0">
<value name = "MAC Address">00 80 A3 B7 6A 60</value>
</configitem>
<configitem name = "Interface" instance = "eth0">
<value name = "MAC Address">00 80 A3 B7 6A 59</value>
</configitem>
<configitem name = "Interface" instance = "wlan0">
<value name = "MAC Address">00 80 A3 B7 6A 60</value>
</configitem>
</configgroup>
</configrecord>