This knowledge base has moved to the documentation site. Please visit the knowledge base here for the most up to date content. This site is no longer maintained.

Hostname Configured in /etc/hostname Is Superseded by the DHCP hostname Option


If a Cumulus Linux switch receives a DHCP lease containing the hostname option, the received DHCP hostname will supersede any hostname applied in /etc/hostname. 



Changing the system hostname via /etc/hostname in Cumulus Linux does not have any effect while an active DHCP lease containing the hostname option exists, or if an active DHCP server continues to offer the hostname option in assigned leases. 


  • Cumulus Linux 2.5.x
  • Active DHCP lease containing the hostname option cached in /var/lib/dhcp/dhclient.eth0.leases, and/or a DHCP server offering a lease containing the hostname option
  • DHCP client configuration in /etc/dhcp/dhclient.conf containing default parameters send host-name and request host-name


This condition can occur when a switch running Cumulus Linux obtains a DHCP lease on management port eth0 and an attempt is made to change the hostname by editing /etc/hostname.

If you try to reboot the switch in order to change to the new hostname configured in /etc/hostname while the previous DHCP lease is still active, the DHCP hostname option cached locally on the switch in /var/lib/dhcp/dhclient.eth0.leases and/or the hostname option received from an active DHCP server supersedes the name manually configured in /etc/hostname.

Note that even if the DHCP server is not explicitly configured to offer a lease containing the hostname option, it may continue to send a previous version of the switch hostname configured in /etc/hostname because the send-hostname option is enabled by default in /etc/dhcp/dhclient.conf on Cumulus Linux. This causes the switch to send the locally-configured hostname in DHCP Discover and Request messages. The DHCP server may cache this value and continue to offer it back in subsequent DHCP offers to the switch as long as the original lease is active, which supersedes any new changes made to /etc/hostname on the switch. 


You have two ways to work around this issue. You can configure dhclient.conf to:

  • Supersede the hostname option received from DHCP
  • Not request the hostname option in DHCP Discover and Request packets

Superseding the hostname Option 

After configuring the desired hostname in /etc/hostname, add the following line to /etc/dhcp/dhclient.conf to supersede any received hostname option from DHCP with the desired hostname configured in /etc/hostname instead:

supersede host-name "configured-hostname";

Not Requesting the hostname Option

If preferred, you can configure /etc/dhcp/dhclient.conf to not request the hostname option in the Parameter Request List [option 55] in DHCP Discover and Request packets.

To do this, edit /etc/dhcp/dhclient.conf and remove "host-name" from the Request option list, as highlighted here:

request subnet-mask, broadcast-address, time-offset, routers,
domain-name, domain-name-servers, domain-search, host-name,, dhcp6.domain-search,
netbios-name-servers, netbios-scope, interface-mtu,
rfc3442-classless-static-routes, ntp-servers, cumulus-provision-url;


This support portal has moved

Cumulus Networks is now part of the NVIDIA Networking Business Unit! The NVIDIA Cumulus Global Support Services (GSS) team has merged its operations with the NVIDIA Mellanox support services team.

You can access NVIDIA Cumulus support content from the Mellanox support portal.

You open and update new cases on the Mellanox support portal. Any previous cases that have been closed have been migrated to the Mellanox support portal.

Cases that are still open on the Cumulus portal will continue to be managed on the Cumulus portal. Once these cases close, they will be moved to the Mellanox support portal.

Powered by Zendesk