Frequently Asked Question

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

CKAN updates can be installed "in-place" on your existing instance. The exact process depends on the version you're moving to but more specific instructions can be found here.

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