Here are some points to take into account while performing Pootle upgrades.
Warning
Upgrading Pootle to a newer version can be a dangerous endeavour, so please:
This page is divided in three sections. The first one lists some previous tasks that should be performed before upgrading. The second section includes a detailed list of steps to follow to actually perform the upgrade. The third one suggests some possible tasks to fine tune the setup after upgrading.
Note
If you perform all the steps in this section you will:
Before upgrading Pootle to a newer version, make sure to go through this checklist.
Here is the list of steps to upgrade a Pootle install using the pip tool.
Note
Since these instructions don’t take into account other possible installation methods, like using a checkout from git, you will have to do the appropriate adjustments in this list if you didn’t install Pootle using pip.
Warning
Always backup the following before upgrading:
To perform the upgrade follow the next steps:
If you want to perform a database migration then do it right now.
It is highly recommended to use a virtualenv, so if you don’t use it please set up a virtualenv.
Upgrade the Pootle package:
(env)$ pip install --upgrade Pootle==2.6.0
Note
If you weren’t using a virtualenv before upgrading, instead of upgrading you will be just doing a fresh install of Pootle in a blank virtualenv:
(env)$ pip install Pootle
Update Pootle settings to include new useful settings and updating existing ones, while keeping the necessary data from the old install. Deleting now unused settings is also advisable. Check the available settings.
Note
If you are upgrading from a version of Pootle that uses localsettings.py then you must move your custom settings to a new location in order to ensure that Pootle uses them.
Perform the database schema and data upgrade by running:
(env)$ pootle setup
Reapply your custom changes to Pootle code, templates or styling. Check about the customization of style sheets and templates to move your customizations to the right locations in order to reduce the pain in future upgrades.
Finally clear your cache. For users of memcached it is enough to restart it.
After a succesful upgrade you can now consider making some optimizations to your setup, like for example using a real database or a proper web server.
Note
If you are already using some optimizations you might need to find out if you need to perform any adjustment or reload any server.
Also you might want to create a local Translation Memory. Have in mind that this can take a lot of time depending on how many translations you have in your Pootle database.
(env)$ pootle create_local_tm