what does the 'load sys ucs' platform-migrate option do?

When restoring a UCS from PlatformX to PlatformY ignores the platform specific information.

I rememeber "no-platform-check", but not 'platform-migrate'. Is this something new? On which BIGIP SW version you can see this option?

Hi, When you are trying to load a saved UCS on another device and be careful of the migration to not override the existing device specific information - You will need the platform migration option of load sys ucs followed by the ucs file name and then the Platform No check option.

I normally use

root@(kishore)(cfg-sync In Sync)(Active)(/Common)(tmos) load sys ucs test.ucs ?
Options:
  no-license         This option mostly is for RMA use. It loads full configuration from a UCS file except license file.
  no-platform-check  Bypass platform check.
  passphrase         Passphrase for (un)encrypting UCS.
  reset-trust        Reset device and trust domain certificates and keys when loading a UCS.

To know more no this option please proceed to read this one below :

https://support.f5.com/kb/en-us/solutions/public/16000/200/sol16216.html

Not sure when it appeared, but it's in 12.1.1:

test@(test)(cfg-sync Standalone)(Active)(/Common)(tmos) load sys ucs config.ucs ?
    Options:
      no-license         This option mostly is for RMA use. It loads full configuration from a UCS file except license file.
      no-platform-check  Bypass platform check.
      passphrase         Passphrase for (un)encrypting UCS.
      platform-migrate   Don't load or modify some objects specific to a particular device.
      reset-trust        Reset device and trust domain certificates and keys when loading a UCS.

So, this Platform-migrate will not consider loading entities related to specific devices. Example bigip_base.conf ( this is just one comparision ) and objects that cannot be loaded to a different device because that might cause a collision at the configs.

No-platform-check does not care about the platform while load the UCS - applies all settings

platform-migrate carefully migrates only config that can be shared between two differnt platform devices.

There's now a knowledge article available on Ask F5 for platform-migrate: https://support.f5.com/csp/article/K82540512