Migrating data from Octopus 2.6.5 to 2018.10 LTS

When upgrading from Octopus 2.6 to Octopus 2018.10 LTS you can migrate your data. There are some points worth noting about the data migration process:

  • The data migration tool has been designed to perform a one-time migration from Octopus 2.6 to Octopus 2018.10 LTS for each backup file.
    • Re-running the data migration will overwrite matching data. See Importing in the Data Migration page for more details on how data is imported.
    • Data is matched on name. Names are unique in Octopus. This is to allow multiple backups to be run from multiple Octopus Server instances to combine into one Octopus 2018.10 LTS instance. So you can run multiple backup files into an Octopus 2018.10 LTS instance but if it matches names it will use the currently running backup as the source of truth.
  • The built-in Octopus NuGet package repository is not migrated automatically - see below for more details.
  • You can optionally limit the days of historical data to migrate - see below for more details.

The migrator can take a long time Please see our tips for minimizing the migration duration.

Importing your 2.6 backup into 2018.10 LTS

To import your 2.6 Raven data into a 2018.10 LTS installation (generally this is run after a side-by-side upgrade) you need to select import from the Octopus Manager.

This will open up the importer. From here you select that you want to import from a 2.6 backup file.

You need to select your most recent 2.6 Backup file, and provide the Master Key associated with the backup you are importing. The next step lets you perform a preview of your import.

When you deselect Preview only, your import will run against the database. This cannot be reversed. The backup is treated as the truth, so any changes that have been made to the database (if this is not your first import) will be overwritten with the backup.

If you need to use any of the options below to manage the data being imported you need to use the Show Script feature to run the migration via console.

Migrating the built-in Octopus NuGet package repository

If you use the built-in Octopus NuGet repository you will need to move the files from your 2.6 server to your 2018.10 LTS server. The package files are not included as part of the backup. In a standard Octopus 2.6 install the files can be found under C:\Octopus\OctopusServer\Repository\Packages You will need to transfer them to the new server to C:\Octopus\Packages. Once the files have been copied, go to Library ➜ Packages ➜ Package Indexing and click the RE-INDEX NOW button. This process runs in the background, so if you have a lot of packages it could take a while (5-20 mins) to show in the UI or be usable for deployments.

Migrating historical data

By default we migrate everything from your backup including all historical data. Learn about minimizing migration time.

Help us continuously improve

Please let us know if you have any feedback about this page.

Send feedback

Page updated on Sunday, January 1, 2023