[openstack-dev] [neutron] Plethora of dbase migration questions...
Henry Gessau
gessau at cisco.com
Tue Jul 7 12:39:24 UTC 2015
On Tue, Jul 07, 2015, Paul Michali <pc at michali.net> wrote:
> Thanks Salvatore for the responses. See @PCM in-line...
>
>
>
> On Tue, Jul 7, 2015 at 6:14 AM Salvatore Orlando <sorlando at nicira.com
> <mailto:sorlando at nicira.com>> wrote:
>
> Some comments inline.
>
> Salvatore
>
> On 6 July 2015 at 20:00, Paul Michali <pc at michali.net
> <mailto:pc at michali.net>> wrote:
>
> Hi,
>
> I have some urgent requests about migration that I'm hoping to get
> some info on. I'm working on a bug where I need to add two (related)
> fields to a table for VPNaaS. Here's the objectives related to
> migration...
>
> 1) create local_v4_ip and lcoal_v6_ip fields in the vpnservice table
> 2) for each entry in the vpnservice table:
> 2.1) Get the router.gw_port.fixed_ips list
> 2.2) Determine the version of each fixed IP and store the first
> of each version (if any) into the appropriate new field.
>
> I have created a migration file, and I changed the down_revision to
> be the number of the revision that is the first in the migration
> chain in the VPN repo.
>
> Here are the many questions I have...
>
> When I look in the VPN repo, the HEAD file has the version 'kilo',
> which is not the current head.
>
>
> Shouldn't it the version number of the first file in the migration chain?
>
>
> It should indeed. How are you generating the revision script? Using
> neutron-db-manage it should be updated automatically [1]
>
>
> @PCM I ran neutron-db-manage, when in the neutron repo, and it assigned some
> version, but it was not the latest in the neutron-vpnaas repo.
neutron-db-manage does not handle alembic branches in separate repos very well
at all yet. I am working on updating it with
https://review.openstack.org/198524 but I have quite a lot left to do.
>
> I checked the VPN repo and there were a chain of versions, which I used to
> determine what the head should be and have set the version accordingly.
> However, in the current repo, head is set to "kilo", which appears to be
> incorrect. The versions are:
>
> 56893333aa52
> kilo <<< HEAD
> 3ea02b2a773e
> start_neutron_vpnaas
> None
Ouch. That is an error, because https://review.openstack.org/190569 should have
updated HEAD but didn't.
The version sequence (you can see it in any devstack run) is:
INFO [alembic.migration] Running upgrade -> start_neutron_vpnaas, start
neutron-vpnaas chain
INFO [alembic.migration] Running upgrade start_neutron_vpnaas -> 3ea02b2a773e,
add_index_tenant_id
INFO [alembic.migration] Running upgrade 3ea02b2a773e -> kilo, kilo
INFO [alembic.migration] Running upgrade kilo -> 56893333aa52, fix identifier
map fk
>
> Should I do a separate commit that fixes the HEAD file, or just fix it as
> part of the bug fix I'm working on.
Yes, you should immediately submit a patch to change HEAD to 56893333aa52.
>
> BTW, at one point, after having correctly set the HEAD and versions in my new
> migration file, I think I ran neutron-db-manage check_migration, and I think
> it set the HEAD to my version, but it did that in the neutron repo, and not
> the VPN repo. I might have been running from the wrong repo?
I working on updating the devref docs for this process. Things have changed
quite a bit with the alembic branches in separate repos.
>
>
>
> For my commit, I'm assuming I change the HEAD file to use my
> migration file's version?
>
>
> You can do that manually too, yes.
>
>
>
> I set HEAD to my migration file, and my file has a down revision of
> the previous head's revision. If I run 'neutron-db-manage
> --config-file ../neutron/etc/neutron.conf --config-file
> ../neutron/etc/neutron/plugins/ml2/ml2_conf.ini check_migration'
> there is no output so I guess that is OK.
>
> As I develop my new migration file, is there a way that I can test it
> (running neutron-db-migration, maybe)?
>
>
> When I test migrations I usually dump the database, run the migration
> with neutron-db-manage upgrade HEAD (I think it's not necessary to
> specify HEAD), and restore the db from the dump if the migration fails.
>
>
> Is there a way to run the migration file under the debugger, as well
> (importing pdb, for example)?
>
>
> The migration process is just like any python application, so I guess you
> can debug it with pdb.
>
>
> @PCM Ah, so use "neutron-db-manage upgrade HEAD". That was the piece that was
> missing. I take it there are no specific unit tests of the migration files?
>
>
>
>
>
> In the migration, I can add the columns needed. What's the best way
> to fill out those fields - using raw SQL queries or create a Session
> object and access the VpnService object's router object?
>
>
> If the default value for the column is not enough, and you need to
> specify a value which depends on other values in the same row I would
> prefer plain SQL statements, but if that become cumbersome I guess it's
> ok to use sqlalchemy's session.
>
>
> I see there is some op.bind() call and then engine.execute(), but
> could use some help on the best way to extract the needed queries (I
> need to access the vpnservice's router, and then access the (Port)
> gw_port relationship, and from that access the (IPAllocation)
> fixed_ips list).
>
>
> Perhaps you can point us to the review pages on gerrit, and we can
> provide detailed comments there.
>
>
> @PCM Yeah, I haven't pushed it up yet. I have a few more changes to make, and
> should be able to get it up in a few days. The LP bug is 1464387.
>
> Essentially, in the vpnservices table, I'm adding an IPv4 and/or IPv6
> addresses for the "local" end of VPN connections that will be established.
> This is to allow alternative VPN implementation (appliances, separate S/W,
> H/W, VM based VPN, etc) to specify addresses different than what is available
> on the Neutron router.
>
> However, for the reference implementation, we'll use the Neutron router's
> fixed_ips list (as is done today), and to handle the migration, I'm thinking
> the following is needed:
>
> 1) create the new columns.
> 2) Identify the router for that service and obtain it's GW fixed_ips list.
> 3) Pick first IPv4 address (if any) and IPv6 address (if any), and store in
> new columns.
>
> So I need to form a query and code to do this.
>
>
>
>
>
> Appreciate any advise here on how to debug the migration stuff...
>
> Paul Michali (pc_m)
>
>
> [1]
> http://git.openstack.org/cgit/openstack/neutron/tree/neutron/db/migration/cli.py#n124
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.openstack.org/pipermail/openstack-dev/attachments/20150707/80560905/attachment.html>
More information about the OpenStack-dev
mailing list