Skip to content

Latest commit

 

History

History
92 lines (56 loc) · 2.41 KB

upgrade-source.rst

File metadata and controls

92 lines (56 loc) · 2.41 KB
Raw

Upgrading a source install

Note

Before upgrading CKAN you should check the compatibility of any custom themes or extensions you're using, check the changelog, and backup your database. See upgrading.

The process for upgrading a source install is the same, no matter what type of CKAN release you're upgrading to:

  1. Activate your virtualenv and switch to the ckan source directory, e.g.:

    cd /src/ckan

  2. Checkout the new CKAN version from git, for example:

    git fetch
git checkout release-v2.0

    If you have any CKAN extensions installed from source, you may need to checkout newer versions of the extensions at this point as well. Refer to the documentation for each extension.

  3. Update CKAN's dependencies:

    2.1 In CKAN 2.0 and earlier the requirements file was called pip-requirements.txt, not requirements.txt as below.

    pip install --upgrade -r requirements.txt

  4. Register any new or updated plugins:

    python setup.py develop

  5. If there have been changes in the Solr schema (check the /changelog to find out) you need to restart Jetty for the changes to take effect:

    sudo service jetty restart

  6. If you are upgrading to a new major release <releases> update your CKAN database's schema using the db upgrade command.

    For example:

    paster db upgrade --config=

    See paster db for details of the db upgrade command.

  7. Rebuild your search index by running the ckan search-index rebuild command:

    paster search-index rebuild -r --config=

    See rebuild search index for details of the ckan search-index rebuild command.

  8. Finally, restart your web server. For example if you have deployed CKAN using the Apache web server on Ubuntu linux, run this command:

  9. You're done!

You should now be able to visit your CKAN website in your web browser and see that it's running the new version of CKAN.