Migrating foundational services version 3.x to 4.x

Foundational services version 4.x has several breaking changes compared to 3.x and requires scripts or manual steps for migration. A simple channel switch to upgrade the operators is not sufficient and can break foundational services.

Supported versions to migrate from:

• If on v3 channel, then 3.19.9 and later
• If on v3.x channel, then 3.20.0 and later

There are two types of migration methods, each for different use cases. Each method outlines the manual steps and also includes steps to run the scripts that automate the migration process.

• In-place migration
• Isolated migration
  • Cleaning up foundational services version 3.x control namespace after upgrading to version 4.x
• AllNamespaces migration
• Preloading Mongo data