Migrating from Kong Gateway (OSS) to Kong Gateway

Run kong migrations commands to migrate from an open-source Kong Gateway installation to an Enterprise one.

You can only migrate to a Kong Enterprise version that supports the same Kong Gateway (OSS) version.

Prerequisites

Warning: This action is irreversible, therefore it is strongly recommended to back up your production data before migrating from Kong Gateway (OSS) to Kong Enterprise.

If running a version of Kong Gateway (OSS) earlier than 3.0.x, upgrade to Kong Gateway (OSS) 3.0.x before migrating Kong Gateway (OSS) to Kong Enterprise 3.0.x.

Migration steps

The following steps guide you through the migration process.

  1. Download the Kong Gateway 3.0.x Enterprise package and configure it to point to the same data store as your Kong Gateway (OSS) 2.8.x node. The migration command expects the data store to be up to date on any pending migration:

    1. kong migrations up [-c configuration_file]
    2. kong migrations finish [-c configuration_file]

  2. Confirm that all of the entities are now available on your Kong Enterprise node.