Support Support Downloads Knowledge Base Juniper Support Portal Community

Knowledge Base

Search our Knowledge Base sites to find answers to your questions.

Ask All Knowledge Base Sites All Knowledge Base Sites JunosE Defect (KA)Knowledge BaseSecurity AdvisoriesTechnical BulletinsTechnotes Sign in to display secure content and recently viewed articles

[WLC] How to use the auto-config function



Article ID: KB27844 KB Last Updated: 04 Sep 2013Version: 1.0

This article describes what the auto-config function is and how we use/troubleshoot it.





Enables a WLC switch to contact a RingMaster server for its configuration.

A network administrator at the corporate office can pre configure the switch in a RingMaster network plan. The switch configuration must have a name for the switch, the model must be WLCR-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 WLA 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 WLC 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 WLC and restarts the WLC. The WLC 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 WLC serial number and IP address.

The network administrator can upload the WLC into the network plan, configure WLC parameters, and deploy the configuration to the WLC. To use the auto-config option with a new (unconfigured) WLCR-2/WLC-2, insert a paperclip or similar object into the WLCR-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 WLC model to be able to access a RingMaster server for a configuration, you also must preconfigure the WLC with the following information:

  • IP address
  • Default router (gateway) address
  • Domain name and DNS server address

You can enable the WLC to use the MSS DHCP client to obtain this information from a DHCP server in the local network where the WLC 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.


set auto-config {enable | disable}


The auto-config option is automatically enabled on an unconfigured WLCR-2 when the factory reset switch is pressed during power on. However, auto-config is disabled by default on other models.

  • enable: Enables the switch to contact a RingMaster server to request a configuration.
  • disable: Disables the auto-config option.


The following commands stage an WLC to use the auto-config option. The network where the WLC is installed has a DHCP server, so the WLC 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:

WLC8# set vlan 1 port 7
success: change accepted.

2. Enable the DHCP client on VLAN 1:

WLC# set interface 1 ip dhcp-client enable
success: change accepted.

3. Enable the auto-config option:

WLC# set auto-config enable
success: change accepted.

4. Save the configuration changes:

WLC# save config
success: configuration saved.


If you see the following error in the log buffer of your WLC:

ERROR HTTPD: Unable to resolve configuration server: wlan-config-srv

then most likely you have used the following command:

set auto-config enable

and no Ring Master server is in range to offer the WLC its

To get rid of it, either disable the auto-config or configure a Ring Master server as described above.

Comment on this article > Affected Products Browse the Knowledge Base for more articles related to these product categories. Select a category to begin.

Getting Up and Running with Junos

Getting Up and Running with Junos Security Alerts and Vulnerabilities Product Alerts and Software Release Notices Problem Report (PR) Search Tool EOL Notices and Bulletins JTAC User Guide Customer Care User Guide Pathfinder SRX High Availability Configurator SRX VPN Configurator Training Courses and Videos End User Licence Agreement Global Search