How do I migrate from Kong Gateway open source (OSS) to Kong Gateway Enterprise?
You can migrate to Kong Gateway Enterprise using the kong migrations
CLI commands.
Warning: This action is irreversible, therefore we strongly recommend backing up your production data before migrating from Kong Gateway OSS to Kong Gateway Enterprise.
You can only migrate to a Kong Gateway Enterprise version that supports the same OSS version. For example, if you want to migrate to Kong Gateway Enterprise 3.10, you must upgrade to Kong Gateway OSS 3.10 first.
- Download the Kong Gateway Enterprise package and configure it to point to the same data store as your Kong Gateway OSS node. The migration command expects the data store to be up to date on any pending migration:
kong migrations up [-c configuration_file] kong migrations -f finish [-c configuration_file]
Copied to clipboard!Caution: When adding new plugins to the existing installation (either manually or via the extension of
bundled
plugins), thekong migrations finish
orkong migrations up
must be run with the-f
flag to forcefully upgrade the plugin schemas. - Confirm that all of the entities are now available on your Kong Gateway Enterprise node.