5730d87c26
Add L3 HA base classes on the plugin side. A new admin-only ha attribute is added to the API router resource. Conversion from or to HA router is possible. Each tenant gets a single network used for HA traffic. The tenant_id for that network is set to '' so that it isn't visible via the CLI or GUI. A new table is added to map a tenant to its HA network. Specific HA attributes are added to the extra router attributes table. Finally, each HA router gets a port on the HA network, per l3 agent it is scheduled on. A new table is added to track these bindings. A new table is added in order to track VRID allocations. DVR integration is not expected to work. Any issues will be reported as bugs and handled after the feature merges. Migrating a router to HA or from HA works server side but is not expected to work (Yet) agent side. This will be dealt with as a bug in the future. DocImpact Partially-implements: blueprint l3-high-availability Change-Id: I9d935cf5e0c231e8cb7af5f61b9a9fc552c3521e Co-Authored-By: Assaf Muller <amuller@redhat.com> |
||
---|---|---|
.. | ||
alembic_migrations | ||
models | ||
__init__.py | ||
alembic.ini | ||
cli.py | ||
migrate_to_ml2.py | ||
README |
# Copyright 2012 New Dream Network, LLC (DreamHost) # # Licensed under the Apache License, Version 2.0 (the "License"); you may # not use this file except in compliance with the License. You may obtain # a copy of the License at # # http://www.apache.org/licenses/LICENSE-2.0 # # Unless required by applicable law or agreed to in writing, software # distributed under the License is distributed on an "AS IS" BASIS, WITHOUT # WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the # License for the specific language governing permissions and limitations # under the License. # # @author Mark McClain (DreamHost) The migrations in the alembic/versions contain the changes needed to migrate from older Neutron releases to newer versions. A migration occurs by executing a script that details the changes needed to upgrade/downgrade the database. The migration scripts are ordered so that multiple scripts can run sequentially to update the database. The scripts are executed by Neutron's migration wrapper which uses the Alembic library to manage the migration. Neutron supports migration from Folsom or later. If you are a deployer or developer and want to migrate from Folsom to Grizzly or later you must first add version tracking to the database: $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini stamp folsom You can then upgrade to the latest database version via: $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini upgrade head To check the current database version: $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini current To create a script to run the migration offline: $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini upgrade head --sql To run the offline migration between specific migration versions: $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini upgrade \ <start version>:<end version> --sql Upgrade the database incrementally: $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini upgrade --delta <# of revs> Downgrade the database by a certain number of revisions: $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini downgrade --delta <# of revs> DEVELOPERS: A database migration script is required when you submit a change to Neutron that alters the database model definition. The migration script is a special python file that includes code to update/downgrade the database to match the changes in the model definition. Alembic will execute these scripts in order to provide a linear migration path between revision. The neutron-db-manage command can be used to generate migration template for you to complete. The operations in the template are those supported by the Alembic migration library. $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini revision \ -m "description of revision" \ --autogenerate This generates a prepopulated template with the changes needed to match the database state with the models. You should inspect the autogenerated template to ensure that the proper models have been altered. In rare circumstances, you may want to start with an empty migration template and manually author the changes necessary for an upgrade/downgrade. You can create a blank file via: $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini revision \ -m "description of revision" The migration timeline should remain linear so that there is a clear path when upgrading/downgrading. To verify that the timeline does branch, you can run this command: $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini check_migration If the migration path does branch, you can find the branch point via: $ neutron-db-manage --config-file /path/to/neutron.conf \ --config-file /path/to/plugin/config.ini history