Bug ID 658850: Loading UCS with the platform-migrate parameter could unexpectedly set or unset management DHCP

Last Modified: Apr 24, 2024

Affected Product(s):
BIG-IP TMOS(all modules)

Known Affected Versions:
12.1.1, 12.1.2, 12.1.3,,,,,,,, 12.1.4,, 12.1.5,,,, 12.1.6, 13.0.0, 13.0.0 HF1, 13.0.0 HF2, 13.0.0 HF3, 13.0.1, 13.1.0,,,,,,,,, 13.1.1,,,,, 13.1.3,,,,,,, 13.1.4,, 13.1.5,, 14.0.0,,,,,, 14.0.1,, 14.1.0,,,,,, 14.1.2,,,,,,,,, 14.1.3,, 14.1.4,,,,,,, 14.1.5,,,,,, 15.0.0, 15.0.1,,,,, 15.1.0,,,,,, 15.1.1, 15.1.2,, 15.1.3,, 15.1.4,, 15.1.5,, 15.1.6,, 15.1.7, 15.1.8,,, 15.1.9,, 15.1.10,,,, 16.0.0,, 16.0.1,,, 16.1.0, 16.1.1, 16.1.2,,, 16.1.3,,,,,, 16.1.4,,,, 17.0.0,,

Opened: Apr 17, 2017

Severity: 3-Major


When you load a UCS file using the platform-migrate parameter, the mgmt-dhcp value (enabled, disabled, or unset) will overwrite the value on the destination. Depending on the effect, this could change the destination's management IP and default management route. If the UCS does not have mgmt-dhcp explicitly written out, note that its value is treated as the default for the local system, which varies by the type of system. On Virtual Edition (VE) platforms, the default is to enable DHCP. On all other platforms, the default is to disable DHCP.


Changing the mgmt-dhcp value on the destination can result in management changing from statically configured to DHCP or DHCP to statically configured. This can result in loss of management access to the device, requiring in-band or console access.


This occurs when loading a UCS using the platform-migrate parameter: tmsh load sys ucs <ucs_file_from_another_system> platform-migrate


There are a few ways to avoid this issue: 1. Specify the "keep-current-management-ip" parameter to the "load sys ucs" command, for instance: tmsh load sys ucs <ucs_file_from_another_system> platform-migrate keep-current-management-ip Note: The "keep-current-management-ip" parameter is undocumented and will not appear in context help or tab completion. 2. If you want to reset the target device to use a static IP, run the following commands after loading the UCS with the platform-migrate command: tmsh modify sys global-settings mgmt-dhcp disabled tmsh create sys management-ip <ip>/<mask> tmsh delete sys management-route default tmsh create sys management-route default gateway <ip>

Fix Information


Behavior Change

Guides & references

K10134038: F5 Bug Tracker Filter Names and Tips