Comment 1 for bug 1877470

On second thought, I have a better suggestion: since live_migration_permit_post_copy and live_migration_permit_auto_converge effectively implement a three-way switch, it would be more idiomatic to deprecate them in favor of a new setting. For example:

  live-migration-force-strategy:
    type: string
    default: stop
    description: |
      Selects which strategy will be used when migrations are force-completed.
      Valid options: stop, post-copy, auto-converge
      Only used if the deprecated live-migration-permit-post-copy and
      live-migration-permit-auto-converge options are unset
  live-migration-permit-post-copy:
    type: boolean
    default: False
    description: |
      DEPRECATED: use live-migration-force-strategy instead
      If live-migration is enabled, this option allows Nova to switch an on-
      going live migration to post-copy mode.
  live-migration-permit-auto-converge:
    type: boolean
    default: False
    description: |
      DEPRECATED: use live-migration-force-strategy instead
      If live-migration is enabled, this option allows Nova to throttle down
      CPU when an on-going live migration is slow.
      WARNING: auto-converge will only be used if post-copy is disabled