redirect

Adds a rule redirecting device adoption to another controller within the system. Devices seeking adoption are redirected to a specified controller based on the redirection parameters specified.

Supported on the following devices:

Syntax

redirect [anyap|ap410|ap460|ap505|ap510|ap560|nx5500|nx75xx|nx95xx|vx9000|nx96xx]
redirect [anyap|ap410|ap460|ap505|ap510|ap560|nx5500|nx75xx|nx95xx|vx9000|nx96xx] precedence <1-10000> 
controller [<CONTROLLER-IP>|<CONTROLLER-HOSTNAME>] [any|cdp-match|dhcp-option|fqdn|ip|ipv6|level|
lldp-match|mac|model-number|pool|serial-number|vlan]
redirect [anyap|ap410|ap460|ap505|ap510|ap560|nx5500|nx75xx|nx95xx|vx9000|nx96xx] precedence <1-10000> 
controller [<CONTROLLER-IP>|<CONTROLLER-HOSTNAME>|ipv6] any
redirect[anyap|ap410|ap460|ap505|ap510|ap560|nx5500|nx75xx|nx95xx|vx9000|nx96xx] precedence <1-10000> 
controller [<CONTROLLER-IP>|<CONTROLLER-HOSTNAME>|ipv6] [cdp-match <LOCATION-SUBSTRING>|
dhcp-option <DHCP-OPTION>|fqdn <FQDN>|ip [<START-IP> <END-IP>|<IP/MASK>]|ipv6 [<START-IP> <END-IP>|
<IP/MASK>]|level [1|2]|lldp-match <LLDP-STRING>|mac <START-MAC> {<END-MAC>}|
model-number <MODEL-NUMBER>|pool <1-2>|serial-number <SERIAL-NUMBER>|vlan <VLAN-ID>] {upgrade}

Parameters

redirect [anyap|ap410|ap460|ap505|ap510|ap560|nx5500|nx75xx|nx95xx|vx9000|nx96xx] precedence <1-10000> 
controller [<CONTROLLER-IP>|<CONTROLLER-HOSTNAME>|ipv6] any

redirect

Adds a redirect adoption rule. The rule applies to the device type selected. Specify the device type and assign a precedence to the rule.

The different device types are:

AP410, AP460. AP505, AP510, AP560, NX5500, NX7500, NX9500, NX9600, and VX9000.

Note: ‘anyap‘ is used in auto provisioning policies to create rules that are applicable to any AP regardless of the model type.
Note: An adoptee controller, such as NX5500 can be redirected to another controller (configured to adopt controllers) with a capacity equal to or higher than its own. For more information, see controller

precedence <1-10000>

Sets the rule precedence. Rules with lower values get precedence over rules with higher values.

controller [<CONTROLLER-IP>| <CONTROLLER-HOSTNAME>|ipv6]
Configures the controller to which the adopting devices are redirected. Specify the controller‘s IP address or hostname.
  • <CONTROLLER-IP> – Specifies the controller‘s IP address

  • <CONTROLLER-HOSTNAME> – Specifies the controller‘s hostname

  • ipv6 – Specify the controller‘s IPv6 address

any

Indicates any device. Any device seeking adoption is redirected.
redirect [anyap|ap410|ap460|ap505|ap510|ap560|nx5500|nx75xx|nx95xx|vx9000|nx96xx] precedence <1-1000> 
controller [<CONTROLLER-IP>| <CONTROLLER-HOSTNAME>|ipv6] [cdp-match <LOCATION-SUBSTRING>|
dhcp-option <DHCP-OPTION>|fqdn <FQDN>|ip [<START-IP> <END-IP>|<IP/MASK>]|ipv6[<START-IP> 
<END-IP>|<IP/MASK>]|lldp-match <LLDP-STRING>|mac <START-MAC> {<END-MAC>}|model-number 
<MODEL-NUMBER>|pool <1-2>|serial-number <SERIAL-NUMBER>|vlan <VLAN-ID>] {upgrade}

redirect

Adds a redirect adoption rule. The rule applies to the device type selected. Specify the device type and assign a precedence to the rule.

The different device types are:

AP410, AP460. AP505, AP510, AP560, NX5500, NX7500, NX9500, NX9600, and VX9000.

Note: ‘anyap‘ is used in auto provisioning policies to create rules that are applicable to any AP regardless of the model type.
Note: An adoptee controller, such as NX5500 can be redirected to another controller (configured to adopt controllers) with a capacity equal to or higher than its own. For more information, see controller.

precedence <1-10000>

Sets the rule precedence. Rules with lower values get precedence over rules with higher values.

controller [<CONTROLLER-IP>| <CONTROLLER-HOSTNAME>|ipv6]
Configures the controller to which the adopting devices are redirected. Specify the controller‘s IP address or hostname.
  • <CONTROLLER-IP> – Specifies the controller‘s IP address

  • <CONTROLLER-HOSTNAME> – Specifies the controller‘s hostname

  • ipv6 – Specify the controller‘s IPv6 address

After specifying the rule precedence and the controller, specify the match criteria.

cdp-match <LOCATION-SUBSTRING>

Configures the device location to match, based on CDP snoop strings
  • <LOCATION-SUBSTRING> – Specify the location. Devices matching the specified string are redirected.

dhcp-option <DHCP-OPTION>

Configures the DHCP options to match

DHCP options identify the vendor and DHCP client functionalities. This information is used by the client to convey to the DHCP server that the client requires extra information in a DHCP response.

  • <DHCP-OPTION> – Specify the DHCP option value. Devices matching the specified value are redirected.

fqdn <FQDN>

Configures the FQDN to match

FQDN is a domain name that specifies its exact location in the DNS hierarchy. It specifies all domain levels, including its top-level domain and the root domain.

  • <FQDN> – Specify the FQDN. Devices matching the specified value are redirected.

ip [<START-IP> <END-IP>|<IP/MASK>]

Configures a range of IP addresses and subnet address. Devices having IPv4 addresses within the specified range or are part of the specified subnet are redirected.
  • <START-IP> – Specify the first IPv4 address in the range.
    • <END-IP> – Specify the last IPv4 address in the range.
  • <IP/MASK> – Specify the IPv4 subnet and mask to match against the device‘s IP address.
level[1|2] Configures the routing level
  • level1 – Specifies level 1 as local routing
  • level2 – Specifies level2 as inter-site routing
ipv6 [<START-IP> <END-IP>| <IP/MASK>] Redirects if a device's IPv6 address matches the specified IP address or is within the specified IP address range
  • <START-IP> – Specify the first IPv6 address in the range.
    • <END-IP> – Specify the last IPv6 address in the range.
  • <IP/MASK> – Specify the IPv6 subnet and mask to match against the device‘s IP address.

lldp-match <LLDP-STRING>

Configures the device location to match, based on LLDP snoop string

LLDP is a vendor neutral link layer protocol used to advertise a network device‘s identity, capabilities, and neighbors on a local area network.

  • <LLDP-STRING> – Specify the location. Devices matching the specified string are redirected.

mac <START-MAC> {<END-MAC>}

Configures a single or a range of MAC addresses. Devices matching the specified values are redirected.
  • <START-MAC> – Specify the first MAC address in the range. Provide only this MAC address to filter a single device.
    • <END-MAC> – Optional. Specify the last MAC address in the range.

model-number <MODEL-NUMBER>

Configures the device model number
  • <MODEL-NUMBER> – Specify the model number. Devices matching the specified model number are redirected.
pool <1-2> Configures the controller pool
  • <1-2> – Configures the pool to which the specified controller belongs to. The default pool value is 1.

serial-nuber <SERIAL-NUMBER>

Configures the device‘s serial number

  • <SERIAL-NUMBER> – Specify the serial number. Devices matching the specified serial number are redirected.

vlan <VLAN-ID>

Configures the VLAN ID

  • <VLAN-ID> – Specify the VLAN ID. Devices assigned to the specified VLAN ID are redirected.

upgrade Optional. Upgrades APs before redirecting the device for adoption within the system

Examples

nx9500-6C8809(config-auto-provisioning-policy-test)#redirect ap81xx precedence 6 controller 192.168.13.10 ip 192.168.13.11 192.168.13.15
nx9500-6C8809(config-auto-provisioning-policy-test)#redirect ap7532 precedence 7 controller 192.168.13.10 model-number AP-7532-67030-WR
nx9500-6C8809(config-auto-provisioning-policy-test)#show context
auto-provisioning-policy test
 default-adoption
 evaluate-always
 deny ap8432 precedence 1 mac 74-67-F7-07-02-35
 deny ap8432 precedence 2 ip 192.168.13.24 102.168.13.26
 adopt ap8432 precedence 5 profile default-ap8432 rf-domain TechPubs vlan 1
 redirect ap81xx precedence 6 controller 192.168.13.10 ip 192.168.13.11 192.168.13.15
 redirect ap7532 precedence 7 controller 192.168.13.10 model-number AP-7532-67030-WR
nx9500-6C8809(config-auto-provisioning-policy-test)#

Related Commands

no

Removes a redirect rule from this Auto Provisioning Policy