Fast forward upgrades
Revision as of 15:57, 26 February 2018 by Adam Spiers (talk | contribs) (add section explaining why we want to do it offline)
Fast Forward Upgrade steps
This document will serve to record a suggested path (and gotchas) when performing a fast-forward upgrade (ffu), as well as link to relevant projects (triple-o, ansible, etc) documentation for ffu.
Contents
What is a Fast Forward Upgrade?
A fast-forward upgrade is an offline upgrade which effectively runs the upgrade processes for all versions of openstack components from your originating version to your desired final version.
Preconditions
- Control plane will be down for the entire time of upgrade
- VMs should be accessible by customer
- Since control plane is down, operator can't do actions on existing instances (duh!)
- Take a full backup of your database before running the migration scripts just in case things get weird
Why offline not online?
High level upgrade process
Detailed X->Y upgrade reports
Oath fast-forward upgrade process for Juno to Ocata
Upgrade scripts
Testing Fast Forward upgrades
Validation
Gotchas
- There is a corner case when Upgrading from Nova X (figure out which version) to Y that you bring the cluster online and allow it to perform another upgrade step online. When fast-forwarding through this version you'll need to run some manual steps to fix things up correctly. Or you'll need to pause your FFU and bring the cluster online during this intermediary version. (Just stubbing this out, add details.)