kallithea Changeset - 874ed3e58579

Changeset - 874ed3e58579

Parent rev.

Child rev.

[Not reviewed]

default

0 1 0

Thomas De Schampheleire - 7 years ago 2018-12-28 22:11:40
thomas.de_schampheleire@nokia.com

docs: upgrade: misc. clarification on upgrade from 0.3.x to 0.4

1 file changed with 9 insertions and 2 deletions:

docs/upgrade.rst

0 comments (0 inline, 0 general)

docs/upgrade.rst

➞

Show inline comments

@@ @@ -46,25 +46,26 @@ Back up your database @@
 ^^^^^^^^^^^^^^^^^^^^^
 If using SQLite, simply make a copy of the Kallithea database (``.db``)
 file.
 If using PostgreSQL, please consult the documentation for the ``pg_dump``
 utility.
 If using MySQL, please consult the documentation for the ``mysqldump``
 utility.
 Look for ``sqlalchemy.url`` in your configuration file to determine
 database type, settings, location, etc.
 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)
 ------------------------------------------------------
 Verify that you are using the Python environment that you originally
 installed Kallithea in by running::
     pip freeze
 This will list all packages installed in the current environment. If
 Kallithea isn't listed, activate the correct virtual environment.
@@ @@ -92,25 +93,26 @@ private changes (in which case you shoul @@
     pip install --upgrade -e .
 .. _upgrade_config:
 . Upgrade your configuration
 -----------------------------
 Run the following command to create a new configuration (``.ini``) file::
     kallithea-cli config-create new.ini
 Then compare it with your old config file and see what changed.
 Then compare it with your old config file and copy over the required
 configuration values from the old to the new file.
 .. note::
     Please always make sure your ``.ini`` files are up to date. Errors
     can often be caused by missing parameters added in new versions.
 .. _upgrade_db:
 . Upgrade your database
 ------------------------
 .. note::
@@ @@ -188,24 +190,29 @@ following command:: @@
 -------------------------------------
 It is recommended that you rebuild the Whoosh index after upgrading since
 new Whoosh versions can introduce incompatible index changes.
 . Start the Kallithea web application
 --------------------------------------
 This step once again depends entirely on the web server software used to
 serve Kallithea.
 If you were running Kallithea 0.3.x or older and were using ``paster serve
 my.ini`` before, then the corresponding command in Kallithea 0.4 and later is::
     gearbox serve -c new.ini
 Before starting the new version of Kallithea, you may find it helpful to
 clear out your log file so that new errors are readily apparent.
 .. note::
     If you're using Celery, make sure you restart all instances of it after
     upgrade.
 . Update Git repository hooks
 -------------------------------
 It is possible that an upgrade involves changes to the Git hooks installed by

0 comments (0 inline, 0 general)