Standalone instance upgrade
This page describes the process of upgrading a standalone Tarantool instance in production. Note that this always implies a downtime because the application needs to be stopped and restarted on the target version.
To upgrade without downtime, you need multiple Tarantool servers running in a replication cluster. Find detailed instructions in Replication cluster upgrade.
Before upgrading, make sure your application is compatible with the target Tarantool version:
- Set up a development environment with the target Tarantool version installed. See the installation instructions at the Tarantool download page and in the tt install reference.
- Deploy the application in this environment and check how it works. In case of any issues, adjust the application code to ensure compatibility with the target version.
When your application is ready to run on the target Tarantool version, you can start upgrading the production environment.
Stop the Tarantool instance.
Make a copy of all data and the package from which the current (old) version was installed. You may need it for rollback purposes. Find the backup instruction in the appropriate hot backup procedure in Backups.
Install the target Tarantool version on the host. You can do this using a package manager or the tt utility. See the installation instructions at Tarantool download page and in the tt install reference. To check that the target Tarantool version is installed, run
tarantool -v.Start your application on the target version.
Run box.schema.upgrade(). This will update the Tarantool system spaces to match the currently installed version of Tarantool.
Note
To undo schema upgrade in a case of failed upgrade, you can use box.schema.downgrade().
The rollback procedure for a standalone instance is almost the same as the upgrade. The only difference is in the last step: you should call box.schema.downgrade() to return the schema to the original version.