Manual upgrade instructions#
Occasionally there is a change to devstack that requires existing devstack installations to be manually upgraded. When this happens, instructions should be added here.
Please add new instructions to the top, include a date, and make a post in the Devstack forum.
(If you just need to update your devstack to the latest version of everything, see updating_devstack.)
2023-10-05 - MySQL upgrade from version 5.7 to 8.0#
The MySQL service has been upgraded from version 5.7 to 8.0. Developers will need to follow the following instructions.
Take the latest pull of images
Run provisioning command
[Optional] Additionally, there is a database copy command to help you transfer data from MySQL 5.7 to 8.0. After provisioning use the
dev.dbcopyall8command. This command will stop all of your services, clean your
mysql80container, and copy all of your databases from
This command copies the following databases:
If you prefer not to copy all databases, update
DB_NAMES_LIST in the
Makefile of devstack before running the dbcopy command.
Now start your desired services again using
dev.upcommand. For example running following command will start
You might need to apply latest migrations to your
mysql80container for some services. To do that, you can use
dev.migratecommand. For example for
lmsyou can run
2023-08-02 - Forum upgrade from Ruby 2 to 3#
The forum service has been upgraded from Ruby 2 to Ruby 3. Developers who use forum will need to pull the new image and reprovision the service:
make dev.pull.forum # pull in new forum image
make dev.provision.forum # provision forum service