kallithea Changeset - de92f48c1375

Changeset - de92f48c1375

Parent rev.

Child rev.

[Not reviewed]

default

0 1 0

Thomas De Schampheleire - 7 years ago 2019-03-10 20:58:28
thomas.de_schampheleire@nokia.com

docs: suggest creating a new virtual environment for major upgrades

While not strictly necessary, it may be interesting to start from a new
virtualenv rather than upgrading inside the old one. This will remove old
packages once installed manually but no longer necessary. At the same time,
it makes a rollback of the upgrade process more easy.

Update the upgrade instructions to this effect.

1 file changed with 19 insertions and 6 deletions:

docs/upgrade.rst

0 comments (0 inline, 0 general)

docs/upgrade.rst

➞

Show inline comments

@@ @@ -56,23 +56,36 @@ utility. @@
 Look for ``sqlalchemy.url`` in your configuration file to determine
 database type, settings, location, etc. If you were running Kallithea 0.3.x or
 older, this was ``sqlalchemy.db1.url``.
 . Activate the Kallithea virtual environment (if any)
 ------------------------------------------------------
 . Activate or recreate the Kallithea virtual environment (if any)
 ------------------------------------------------------------------
 .. note::
     If you did not install Kallithea in a virtual environment, skip this step.
 Verify that you are using the Python environment that you originally
 installed Kallithea in by running::
 For major upgrades, e.g. from 0.3.x to 0.4.x, it is recommended to create a new
 virtual environment, rather than reusing the old. For minor upgrades, e.g.
 within the 0.4.x range, this is not really necessary (but equally fine).
 To create a new virtual environment, please refer to the appropriate
 installation page for details. After creating and activating the new virtual
 environment, proceed with the rest of the upgrade process starting from the next
 section.
 To reuse the same virtual environment, first activate it, then verify that you
 are using the correct environment by running::
     pip freeze
 This will list all packages installed in the current environment. If
 Kallithea isn't listed, activate the correct virtual environment.
 See the appropriate installation page for details.
 Kallithea isn't listed, deactivate the environment and then activate the correct
 one, or recreate a new environment. See the appropriate installation page for
 details.
 . Install new version of Kallithea
 -----------------------------------
 Please refer to the instructions for the installation method you

0 comments (0 inline, 0 general)