Operation Manual

System Services Commands
Mobility System Software Command Reference Guide
Version 7.3
4 – 24
Syntax
set auto-config {enable | disable}
Defaults
The auto-config option is automatically enabled on an unconfigured MXR-2 when the
factory reset switch is pressed during power on. However, auto-config is disabled by default on
other models.
Access
Enabled.
History
Introduced in MSS Version 4.0.
Usage
A network administrator at the corporate office can preconfigure the switch in a
RingMaster network plan. The switch configuration must have a name for the switch, the model
must be MXR-2, and the serial number must match the switch’s serial number. The configuration
should also include all other settings required for the deployment, including MP configuration,
SSIDs, AAA settings, and so on.
When the RingMaster server in the corporate network receives the configuration request, the
server looks in the currently open network plan for a MX configuration with the same model and
serial number as the one in the configuration request.
If the network plan contains a configuration with a matching model and serial number,
RingMaster sends the configuration to the MX and restarts the MX. The MX boots using the
configuration received from RingMaster.
If the network plan does not have a configuration with a matching model and serial number, a
verification warning appears in RingMaster. The warning lists the MX serial number and IP
address. The network administrator can upload the MX into the network plan, configure MX
parameters, and deploy the configuration to the MX.
To use the auto-config option with a new (unconfigured) MXR-2, insert a paperclip or similar
object into the MXR-2 factory reset hole to press the switch. The factory reset switch must be held
for about 3 seconds while the factory reset LED (the right LED above port 1) is lit. Normally, this
LED remains solidly lit for 3 seconds after power on. However, when the factory reset switch is
pressed, the LED flashes for 3 seconds instead.
If you want another MX model to be able to access a RingMaster server for a configuration, you
also must preconfigure the MX with the following information:
IP address
Default router (gateway) address
Domain name and DNS server address
You can enable the MX to use the MSS DHCP client to obtain this information from a DHCP
server in the local network where the MX is deployed. Alternatively, you can statically configure
the information.
The IP address and DNS information are configured independently. You can configure the
combination of settings that work with the network resources available at the deployment site.
The following examples show some of the combinations you can configure.
Examples
The following commands stage an MX to use the auto-config option. The network where
the MX is installed has a DHCP server, so the MX is configured to use a MSS DHCP client to
obtain an IP address, default router address, DNS domain name, and DNS server IP addresses.
1. Configure a VLAN:
MX8# set vlan 1 port 7
success: change accepted.
2. Enable the DHCP client on VLAN 1:
MX# set interface 1 ip dhcp-client enable
success: change accepted.
enable Enables the switch to contact a RingMaster server to request a configuration.
disable Disables the auto-config option.