Migrating from legacy versions of keystone

It is important that the database that you specify be different from the one containing your existing install.

Run the following command to configure the most recent schema in your new Identity installation:

keystone-manage db_sync

Use the following command to import your old data:

keystone-manage import_legacy [db_url, e.g. 'mysql://root@foobar/keystone']

Specify db_url as the connection string that was present in your old keystone.conf file.

While the older Identity service stored the service catalog in the database, the updated version configures the service catalog using a template file. An example service catalog template file may be found in etc/default_catalog.templates.

To import your legacy catalog, run this command:

keystone-manage export_legacy_catalog \
    [db_url e.g. 'mysql://root@foobar/keystone'] > \
    [path_to_templates e.g. 'etc/default_catalog.templates']

After executing this command, you will need to restart the keystone service to see your changes.