Setting up Switch Registrar Discovery
You can configure the ICX device to retrieve the correct SmartZone management IP address, IP address set, or fully qualified domain name (FQDN) from the switch registrar. The switch registrar must be set up in advance through Managed Service Provider (MSP) with SmartZone IP addresses or an FQDN and the ICX serial numbers they can manage.
How Switch Registrar Discovery Works
The ICX device sends an HTTP GET message to a default server host, sw-registrar.ruckuswireless.com, for the list of SmartZone management IP addresses or an FQDN, unless the system administrator configures an alternate host. The SmartZone IP address or FQDN obtained in response to the GET message is used to query the SmartZone device to set up a connection. If the ICX device receives a set of IP addresses from the switch registrar, it stores the information and tries the addresses in turn until a successful connection is established with the SmartZone device. The IP address, set of IP addresses, or FQDN obtained through the switch registrar is given priority above all other addresses in the list of SmartZone IP addresses, including addresses received from other sources such as the DHCP list, the active list, and the backup list. Once the ICX device has obtained a SmartZone IP address from the switch registrar, it no longer attempts switch registrar discovery.
This query is performed only for greenfield deployments and when the ICX device boots up with no startup configuration. ICX switches being upgraded from older releases that already have a configuration in place will not have the registrar-based SmartZone discovery turned on. The HTTPS session used for the database query uses the device certificate installed on the switch for SSL session establishment. For the initial release of the switch registrar, no server certificate validation will be performed.
Disabling or Enabling Switch Registrar Discovery
The system administrator can disable or enable switch registrar discovery from the command line.
To disable switch registrar discovery, enter the
no manager registrar command in global configuration mode, and use the
write memory command to save the change as shown in the following example.
ICX# configure terminal ICX(config)# no manager registrar ICX(config)# write memory
To restart the switch registrar discovery process, use one of the following commands at the Privileged EXEC level:
To enable switch registrar discovery on an alternate registrar host server and save the entry to the startup configuration, enter the following commands.
ICX# configure terminal ICX(config)# manager registrar sw-alternate.ruckuswireless.com ICX(config)# write memory
Confirming Successful Switch Registrar Discovery
To display log entries specific to registrar queries, use the
show manager log command.
When the switch registrar database has been successfully queried, a syslog message similar to the following is displayed.
Aug 8 21:47:17:I:MGMT Agent: SZ Switch Registrar Query to 54.186.143.194 Success
When the ICX device requires a restart to connect to the SmartZone address because a new registrar list has been received, a syslog message similar to the following is displayed.
Aug 8 21:47:17:I:MGMT Agent: Disconnect to SZ: 54.16.143.194, Got SZ ip via registrar
You can use the
show running-config
command to check for the name of the registrar host and the registrar list of SmartZone
IP addresses.
The following example indicates that the ICX device uses the default switch registrar host and has obtained one SmartZone IP address (of a possible set of two addresses).
ICX# show running-config ! ! manager registrar manager registrar-list 23.251.150.119 ! !
You can also enter the show manager status
command to obtain information on the switch registrar as shown in the following
example.
ICX# show manager status ============ SZ Agent State Info =================== Config Status: None Operation Status: Enabled State: SZ SSH CONNECTING Prev State: INIT Event: NONE SWR List : 23.251.150.119 Active List : None DHCP Option 43 : No DHCP Opt 43 List : None Backup List : None Merged List : 23.251.150.119 Merged Idx: 0 IP : 23.251.150.119 Switch registrar host : sw-registrar.ruckuswireless.com
Troubleshooting Switch Registrar Discovery
In the event that switch registrar discovery fails, check for the following conditions:
- The running configuration contains "manager disable".
- The switch registrar is not configured on the ICX device.
- The DNS configuration needed to resolve the switch registrar address is not present on the ICX device.
- The ICX device could not reach the switch registrar due to routing issues.
no manager disable command, switch registrar discovery is still started when the registrar IP list is
empty.