What is the "controller-ip" command used for?

Aruba Employee
Aruba Employee

Product and Software: This article applies to Aruba OS version 3.4 and later.


The controller IP address is used by the controller to communicate with external devices such as APs.


In ArubaOS versions prior to 3.4, the IP address of the Aruba controller is determined in the following manner. If the loopback interface address is configured, it is always selected as the switch/controller IP address. Otherwise, the VLAN 1 interface IP address is selected if it has an IP address assigned. If not, the first configured VLAN interface IP address is selected as the switch IP address. Generally (even on factory default), VLAN 1 is configured with IP address and hence it becomes the switch IP (as long as loopback IP is not configured).


With the above approach, it is not possible to force the controller IP to a particular VLAN interface or loopback address.


ArubaOS version 3.4 introduced a new command, "controller-ip". This command allows users to configure the controller IP to a specific VLAN or loopback interface IP address across multiple machine reboots.


After you configure an interface to be the controller IP address, that interface address cannot be deleted until you remove it from the controller IP configuration.


As in previous versions, if the controller IP address is not configured, then the controller IP defaults to the current loopback interface address. If the loopback interface address is not configured, then the first configured VLAN interface address is selected. Generally, VLAN 1 is the factory default setting and thus becomes the controller IP address.



  •  Any change to the controller IP configuration requires a reboot with the configuration save (appropriate message will be given).
  •  Controller IP cannot be configured to a VLAN interface that does not exist.



If you are using the loopback IP address to access the WebUI, changing the loopback IP address will result in loss of connectivity. Aruba recommends that you use one of the VLAN interface IP addresses to access the WebUI.


You can configure the controller IP address either from the CLI (in config mode) or the Web UI.


Using the CLI to Set the Controller IP Address

(Aruba3200) (config) #controller-ip ?

loopback             Set to loopback interface

vlan                 Set to VLAN interface


(Aruba3200) (config) #controller-ip vlan 104

Since controller IP address will change, connectivity to this controller might be affected.

Do you want to proceed with this action [y/n]: y

This configuration change requires a reboot.  PLEASE SAVE THE CONFIGURATION AND REBOOT.

(Aruba3200) (config) #write memory

(Aruba3200) (config) #exit

(Aruba3200) # reload


(Aruba3200) #show controller-ip

Switch IP Address:

Switch IP is from Vlan Interface: 104


Using the WebUI to Set the Controller IP Address


1)    Navigate to Configuration > Network > Controller > System Settings.

2)    Locate the Controller IP Details section.

3)    Select the address you want to set the controller IP to from the VLAN ID drop-down menu. This list contains only the VLAN IDs that have statically assigned IP addresses. If a loopback interface IP address has been previously configured, it also appears in this list. Dynamically assigned IP addresses, for example DHCP/PPPOE, are not displayed.

4)    Click Apply.

5)    Navigate to the Maintenance > Controller > Reboot Controller page to reboot the controller to apply the change of controller IP address.

6)    Click Continue to save the configuration.

7)    When prompted that the changes were written successfully to flash, click OK.

The controller boots up with the changed controller IP address of the selected VLAN ID.

Version history
Revision #:
1 of 1
Last update:
‎07-09-2014 11:36 AM
Updated by:
Labels (1)
Search Airheads
Showing results for 
Search instead for 
Did you mean: