changeset 7494:874ed3e58579

docs: upgrade: misc. clarification on upgrade from 0.3.x to 0.4
author Thomas De Schampheleire <thomas.de_schampheleire@nokia.com>
date Fri, 28 Dec 2018 22:11:40 +0100
parents b3644eeee445
children 013796b2c861
files docs/upgrade.rst
diffstat 1 files changed, 9 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/docs/upgrade.rst	Fri Dec 28 22:46:35 2018 +0100
+++ b/docs/upgrade.rst	Fri Dec 28 22:11:40 2018 +0100
@@ -55,7 +55,8 @@
 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``.
 
 
 3. Activate the Kallithea virtual environment (if any)
@@ -101,7 +102,8 @@
 
     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
@@ -197,6 +199,11 @@
 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.