Clearing the Host IP Address on the SecureStack family

FAQ_User — Mon, 18 Nov 2013 22:12:00 GMT

Article ID: 5692

Products
SecureStack C2
SecureStack B2
SecureStack A2

Commands
'set ip address'
'clear ip address'

Symptoms
"Subnet mask must have contiguous ones and be no longer than 30 bits."
"The IP address and subnet mask combination is not valid."

Cause
Having set the SecureStack host IP address by means of the 'set ip address' command, at least with earlier firmware it is not readily apparent how to change it back to its default zero value.

Here is an example of a management session in which this is attempted.

C2(rw)->show ip address
Name Address Mask
------------ ------------- -----------------
host 0.0.0.0 0.0.0.0
C2(rw)->set ip address 10.20.30.2 mask 255.255.255.0 gateway 10.20.30.1
C2(rw)->clear ip address ?
% Unrecognized command
C2(rw)->set ip address ?
IP address to be assigned to the host
C2(rw)->set ip address 0.0.0.0 ?
mask The network mask (dotted decimal notation)
gateway IP address of the next-hop router

C2(rw)->set ip address 0.0.0.0 mask 0.0.0.0
Subnet mask must have contiguous ones and be no longer than 30 bits.
C2(rw)->set ip address 0.0.0.0 mask 128.0.0.0
The IP address and subnet mask combination is not valid.
C2(rw)->set ip address 1.2.3.253 mask 255.255.255.252 gateway 1.2.3.254
C2(rw)->set vlan create 86
C2(rw)->set host vlan 86
C2(rw)->
Solution
For the C2, upgrade to firmware 4.00.24 or higher.
For the B2, upgrade to firmware 3.01.16 or higher.
For the A2, upgrade to firmware 1.03.17 or higher.

These firmware versions implement a 'clear ip address' command, a concept which is also carried forward to the SecureStack C3 and B3.

Pre-upgrade workaround:
Use the 'set ip protocol none' command, as demonstrated below.

C2(rw)->show ip address
Name Address Mask
------------ ------------- -----------------
host 1.2.3.253 255.255.255.252
C2(rw)->set ip protocol none
Changing protocol mode will reset ip configuration.
Are you sure you want to continue? (y/n)y

C2(rw)->show ip address
Name Address Mask
------------ ------------- -----------------
host 0.0.0.0 0.0.0.0
C2(rw)->
Though the default value for this host IP Address configuration command is "none" (the other possibilities are "dhcp" and "bootp"), restating the command will initialize the host IP Address parameters to zeros. Use of this command is not disruptive to the switching/routing processes.

See also: 5573 and 5628.

topic Clearing the Host IP Address on the SecureStack family in FAQs

Clearing the Host IP Address on the SecureStack family