replace

Selects an existing device by its MAC address or hostname and replaces it with a new device having a different MAC address. Internally, a new device is created with the new MAC address. The old device‘s configuration is copied to the new device, and then removed from the controller‘s configuration (i.e., the old device‘s configuration is no longer staged on the controller).

Supported in the following platforms:

Syntax

replace device [<MAC-ADDRESS>|<HOSTNAME>] <NEW-MAC-ADDRESS>

Parameters

replace device [<MAC-ADDRESS>|<HOSTNAME>] <NEW-MAC-ADDRESS>
replace-device Replaces an existing device with a new device, such that the old device‘s configuration is copied on to the new device
[<MAC-ADDRESS>| <HOSTNAME>] Identifies the device to replace by its MAC address or hostname
  • <MAC-ADDRESS> – Identifies the device to replace by its MAC address. Specify the device‘s existing MAC address.
  • <HOSTNAME> – Identifies the device to replace by its hostname. Specify the device‘s hostname.
<NEW-MAC-ADDRESS> Specifies the new device‘s MAC address. Both the new and old devices should of the same model type.

Examples

nx9500-6C8809(config)#replace device ap7632-4BF364 ?
  AA-BB-CC-DD-EE-FF New device MAC address
nx9500-6C8809(config)#replace device ap7632-4BF364 00-15-0F-BB-98-30

The following example shows an existing AP7632 (MAC: DD-AA-BB-88-12-43) configuration staged on a VX9000 controller:

VX9000-NOC-DE9D(config-device-DD-AA-BB-88-12-43)#show context
ap7632 DD-AA-BB-88-12-43
 use profile default-ap7632
 use rf-domain default
 hostname ap7632-881243
 interface radio1
  wlan theMOZART bss 1 primary
 interface radio2
  wlan theMOZART bss 1 primary
 interface ge1
  switchport mode access
  switchport access vlan 1
 controller host 12.12.12.2
VX9000-NOC-DE9D(config-device-DD-AA-BB-88-12-43)#

The following example shows AP7632 (MAC: DD-AA-BB-88-12-43) replaced by another AP7632 having MAC address 11-22-33-44-55-66:

Note that the new AP7632 device has the same configuration as the old AP7632 device. The HOSTNAME remains the same. Consequently, objects that refer to this particular hostname need not be updated. For example, an hostname alias identifying this particular device, and TLOs using this alias, such as IP/MAC ACLs, remain unchanged.

VX9000-NOC-DE9D(config)#replace device DD-AA-BB-88-12-43 11-22-33-44-55-66
VX9000-NOC-DE9D(config)#ap7632 11-22-33-44-55-66
VX9000-NOC-DE9D(config-device-11-22-33-44-55-66)#show context
ap7632 11-22-33-44-55-66
 use profile default-ap7632
 use rf-domain default
 hostname ap7632-881243
 interface radio1
  wlan theMOZART bss 1 primary
 interface radio2
  wlan theMOZART bss 1 primary
 interface ge1
  switchport mode access
  switchport access vlan 1
 controller host 12.12.12.2
VX9000-NOC-DE9D(config-device-11-22-33-44-55-66)#
9036514-01 Rev AA