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
9
2
0 comments (0 inline, 0 general)
docs/upgrade.rst
➞
Show inline comments
 
@@ -52,13 +52,14 @@ If using PostgreSQL, please consult the
 
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``.

			




	
	
	
		
 

			




	
	
	
		
 

			




	
	
	
		
 
3. Activate the Kallithea virtual environment (if any)

			




	
	
	
		
 
------------------------------------------------------

			




	
	
	
		
 

			




	
	
	
		
 
Verify that you are using the Python environment that you originally

			




	
	
		
 
@@ -98,13 +99,14 @@ private changes (in which case you shoul

			




	
	
	
		
 
-----------------------------

			




	
	
	
		
 

			




	
	
	
		
 
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:

			




	
	
		
 
@@ -194,12 +196,17 @@ new Whoosh versions can introduce incomp

			




	
	
	
		
 
9. 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.

			




        

    



    


    



    



      

      





    
    0 comments (0 inline, 0 general)
    





    


  

  







  


    




    








    
        
    
    
        This site is powered by
            Kallithea 0.7.0,
        which is
        © 2010–2025 by various authors & licensed under GPLv3.