Frequently Asked Questions

The exact answer to this will depend on the circumstances of your installation, along with your own skill level and preferences.

For any minor updates (moving from version 2.9.1 to 2.9.2 for example) it's recommended that you simply upgrade CKAN "in-place" on your existing instance. This can be done quite easily by following the instructions provided here: http://docs.ckan.org/en/latest/maintaining/upgrading/upgrade-source.html

If you'd prefer to create a new instance running the newer CKAN version then that is also fine, however the following steps should be taken to ensure the data you had on the old instance is brought over to the new one:

On the old instance:

1. Export the "ckan_default" and "datastore_default" PostgreSQL databases
2. If you have enabled the CKAN filestore, archive it's directory and all files
   1. If you're unsure, check /etc/ckan/default/production.ini for the "ckan.storage_path" variable to see if it is set

Once the new instance is running:

1. Import both database backups to overwrite the databases of the same name on the new instance.
2. Extract the filestore archive to the same location on the new instance and set the "ckan.storage_path" value appropriately within the /etc/ckan/default/production.ini file.
3. Restart Supervisor
4. Perform a Solr re-index so the new Solr service contains records of the newly imported data. Use the commands below:

. /usr/lib/ckan/default/bin/activate
ckan -c /etc/ckan/default/production.ini search-index rebuild