factory-reset

Erases startup configuration on a specified device or all devices based on the parameters passed.

Supported in the following platforms:

  • Access Points — AP505i, AP510i/e, AP560i/h
  • Service Platforms — NX5500, NX7500, NX9500, NX9600, VX9000

Syntax

factory-reset [config-all|config-device-only|deep|on <RF-DOMAIN-NAME>]
factory-reset [config-all|config-device-only] [<HOSTNAME/MAC> {<HOSTNAME/MAC>}|
on <RF-DOMAIN-NAME> {containing <SUB-STRING>|exclude-controllers|
exclude-rf-domain-manager|filter <DEVICE-TYPE>}]
factory-reset deep <AP-HOSTNAME>
factory-reset on <RF-DOMAIN-NAME> {containing <SUB-STRING>|exclude-controllers|
exclude-rf-domain-manager|filter <DEVICE-TYPE>}

Parameters

factory-reset [config-all|config-device-only] [<HOSTNAME/MAC> {<HOSTNAME/MAC>}|
on <RF-DOMAIN-NAME> {containing <SUB-STRING>|exclude-controllers|
exclude-rf-domain-manager|filter <DEVICE-TYPE>}]
[config-all| config-device-only] Erases startup configuration and reloads only controller-adopted devices.
  • config-all – Erases startup configuration on all adopted devices or on specified adopted devices. Issue the command on the controller or virtual controller AP. To execute the command on a specified device, provide the device hostname/MAC address.
    Note: This option also removes the device's configuration staged on the adopting controller.
  • config-device-only – Erases only the startup configuration on all adopted devices or on specified adopted devices. Issue the command on the controller or virtual controller AP. To execute the command on a specified device, provide the device hostname/MAC address.
    Note: This option only erases the startup configuration. It does not remove the device's configuration staged on the adopting controller.
Note:

For more information on the actions performed by this command, click here.

<HOSTNAME/MAC> {<HOSTNAME/MAC>} This parameter is common to the ‘config-all‘ and ‘config-device-only‘ keywords:
  • <HOSTNAME/MAC> – Erases startup configuration and reloads the device identified by the <HOSTNAME/MAC> keyword. Specify the device‘s hostname or MAC address.
    • <HOSTNAME/MAC> – Optional. You can optionally specify multiple space-separated devices.
on <RF-DOMAIN-NAME> {containing <SUB-STRING>|exclude-controllers|exclude-rf-domain-manager|filter <DEVICE-TYPE> The following parameters are common to the ‘config-all‘ and ‘config-device-only‘ keywords:
  • on <RF-DOMAIN-NAME> – Erases startup configuration and reloads all devices or specified device(s) within a specified RF Domain
    • <RF-DOMAIN-NAME> – Specify the RF Domain name.

      After specifying the RF Domain, optionally use the filters provided to identify specific device(s) within the RF Domain. If none of the filters are used, the command is executed on all devices within the RF Domain. These filters are:

      • containing <SUB-STRING> – Optional. Executes the command on all devices containing a specified sub-string in their hostname
        • <SUB-STRING> – Specify the sub-string to match.
      • exclude-controllers – Optional. Executes the command on all devices excluding controllers. Since only a NOC controller is capable of adopting other controllers, use this option when executing the command on a NOC controller.
      • exclude-rf-domain-manager – Optional. Executes the command on all devices excluding RF Domain managers. Use this option when executing the command on the NOC, Site controller, or RF Domain manager.
      • filter <DEVICE-TYPE> – Optional. Executes the command on all devices of a specified type
        • <DEVICE-TYPE> – Specify the device type. The options are: AP510, AP505.
factory-reset deep <AP-HOSTNAME>
deep

Resets an adopted AP's mode of operation to factory-default setting (that is not specified). Issue the command on the adopting WiNG VC/Controller and specify the AP' hostname. Once the AP's mode of operation is reverted to factory-default setting, the AP reboots and moves into the discovery mode to determine its mode of operation.

The WiNG 7.1 AP505 and AP510 model access points have the capability of operating in the following two modes: Distributed and Centralized. For a newly-manufactured, out-of-the-box AP505 and AP510 access point the mode of operation is not specified.

Note: For more information on operational modes and how it is set, see Dual Mode Capability.
<AP-HOSTNAME> Specify the hostname of the AP on which the deep reset is to be implemented.
factory-reset on <RF-DOMAIN-NAME> {containing <SUB-STRING>|exclude-controllers|
exclude-rf-domain-manager|filter <DEVICE-TYPE>}
factory-reset Erases startup configuration and reloads device(s) based on the parameters passed
Note:

For more information on the actions performed by this command, click here.

on <RF-DOMAIN-NAME> {containing <SUB-STRING>| exclude-controllers| exclude-rf-domain-manager| filter <DEVICE-TYPE>]} Erases startup configuration and reloads all devices or specified device(s) within a specified RF Domain identified by the <RF-DOMAIN-NAME> keyword
  • <RF-DOMAIN-NAME> – Specify the RF Domain name. After specifying the RF Domain, optionally use the filters provided to identify specific device(s) within the RF Domain. If none of the filters are used, the command is executed on all devices within the RF Domain. These filters are:
    • containing <SUB-STRING> – Optional. Executes the command on all devices containing a specified sub-string in their hostname
      • <SUB-STRING> – Specify the sub-string to match.
    • exclude-controllers – Optional. Executes the command on all devices excluding controllers. Since only a NOC controller is capable of adopting other controllers, use this option when executing the command on a NOC controller.
    • exclude-rf-domain-manager – Optional. Executes the command on all devices excluding RF Domain managers. Use this option when executing the command on the NOC, site controller, or RF Domain manager.
    • filter <DEVICE-TYPE> – Optional. Executes the command on all devices of a specified type
      • <DEVICE-TYPE> – Specify the device type. The options are: AP510, AP505, RFS4000, NX5500, NX7500, NX9500, NX9600, and VX9000. The startup configuration is erased on all devices of the type specified here. For example, if AP510 is the device-type specified, the command is executed on all AP510s within the specified RF Domain.

Usage Guidelines (Actions performed by the factory-reset command)

The action taken by this command depends on the parameters passed.
  • For the factory-reset [<DEVICE-NAME>|on <RF-DOMAIN-NAME>] options, the command:
    • Erases startup configuration on the target device (or) all devices in the target RF Domain.
    • Erases the device configuration entries from the controller‘s configuration for the target device (or) for all the devices in the target RF Domain.
    • Reloads the target device (or) all devices in the target RF Domain.
  • For the factory-reset config-all [<DEVICE-NAME>|on <RF-DOMAIN-NAME>] options, the command:
    • Erases startup configuration on the target device (or) all devices in the target RF Domain.
    • Erases the device configuration entries from the controller‘s configuration for the target device (or) for all the devices in the target RF Domain.
  • For the factory-reset config-device-only [<DEVICE-NAME>|on <RF-DOMAIN-NAME>] options, the command:
    • Erases startup configuration on the target device (or) all devices in the target RF Domain.

Example

nx9500-6C8809#factory-reset config-device-only ap505-134038
In progress ....
Erased startup-config - success 1 fail 0
Successful device deletion - total 1
nx9500-6C8809#
nx9500-6C8809#factory-reset deep ap505-13403B
In progress ....
reset ap deep - success 1 fail 0
Successful device deletion - total 1
nx9500-6C8809#