upgrade

Adds a device upgrade rule to this auto provisioning policy. When applied to a controller, the upgrade rule ensures adopted devices, of the specified type, are upgraded automatically.

Supported in the following platforms:

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

Syntax

upgrade [anyap|ap505|ap510|rfs4000|nx5500|nx75xx|nx95xx|vx9000|nx96xx]
upgrade [anyap|ap505|ap510|rfs4000|nx5500|nx75xx|nx95xx|vx9000|nx96xx] 
precedence <1-10000> [any|cdp-match|dhcp-option|fqdn|ip|ipv6|lldp-match|mac|model-number|
serial-number|vlan]
upgrade [anyap|ap505|ap510|rfs4000|nx5500|nx75xx|nx95xx|vx9000|nx96xx] 
precedence <1-10000> any
upgrade [anyap|ap505|ap510|rfs4000|nx5500|nx75xx|nx95xx|vx9000|nx96xx] 
precedence <1-10000> [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>|
serial-number <SERIAL-NUMBER>|vlan <VLAN-ID>]

Parameters

upgrade [anyap|ap505|ap510|rfs4000|nx5500|nx75xx|nx95xx|vx9000|nx96xx] 
precedence <1-10000> any
upgrade Adds a device upgrade 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:

AP505, AP510, RFS4000, NX5500, NX7500, NX9500, NX9600, VX9000

Note: Use the ‘anyap‘ option to auto provision any AP regardless of its model type.
precedence <1-10000> Sets the rule precedence. Rules with lower values get precedence over rules with higher values.

any

Indicates any device. Any device, of the selected type, is upgraded.
upgrade [anyap|ap505|ap510|rfs4000|nx5500|nx75xx|nx95xx|vx9000|nx96xx] 
precedence <1-10000> [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>|
serial-number <SERIAL-NUMBER>|vlan <VLAN-ID>]

upgrade

Adds a device upgrade 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:

AP505, AP510, RFS4000, NX5500, NX7500, NX9500, NX9600, VX9000

Note: Use the ‘anyap‘ option to auto provision any AP regardless of its model type.
precedence <1-10000> Sets the rule precedence. Rules with lower values get precedence over rules with higher values.
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 upgraded.
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 upgraded.
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 upgraded.
ip [<START-IP> <END-IP>|<IP/MASK>] Upgrades if a device's IPv4 address matches the specified IP address or is within the specified IP address range
  • <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.
ipv6 [<START-IP> <END-IP>| <IP/MASK>] Upgrades 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 strings.

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 upgraded.
mac <START-MAC> {<END-MAC>} Configures a single or a range of MAC addresses. Devices matching the specified values are upgraded.
  • <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 upgraded.
serial-number <SERIAL-NUMBER> Configures the device‘s serial number
  • <SERIAL-NUMBER> – Specify the serial number. Device with the specified serial number is upgraded.
vlan <VLAN-ID> Configures the VLAN ID
  • <VLAN-ID> – Specify the VLAN ID. Devices assigned to the specified VLAN are upgraded.

Examples

rfs4000-229D58(config-auto-provisioning-policy-test1)#upgrade ap8432 precedence 10 any
rfs4000-229D58(config-auto-provisioning-policy-test1)#upgrade ap7522 precedence 11 vlan 1
rfs4000-229D58(config-auto-provisioning-policy-test1)#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
 upgrade ap8432 precedence 10 any
 upgrade ap7522 precedence 11 vlan 1
rfs4000-229D58(config-auto-provisioning-policy-test1)#

Related Commands

no Removes an upgrade rule from this Auto Provisioning Policy