Upgrading to the latest Countly Edition usually does not involve any complicated operations. However, you need to know from which version you are upgrading to, and with which method you installed Countly previously. This is due to the reason that there are two different database models (before 15.03 and starting from & after 15.03) and two installation paths (Github and now non-supported Sourceforge downloads).
Important Note: For Countly Community Edition, Starting from version 15.03.02, all downloads will be from Github releases page.
Here's a very brief table providing a summary of installation scenarios
Greater than 15.03
(e.g 15.03.01, 15.03.02, 15.08, 16.02 etc)
15.08 and further
Greater than 15.03
If you are going to upgrade from a previous version (e.g 16.06 to 16.12), things are simple - just follow the path below. If there are more than two versions that you need to upgrade (e.g from 16.02 to 16.12), then please see Skipping versions when upgrading section below.
Download Countly and extract contents over current Countly directory, overwriting all existing files
Check if there is an upgrade folder for that specific version in bin/upgrade. If there is an upgrade.sh script, then run it, just like the example below (replace 16.12 with your new version):
- If there is no such directory and upgrade.sh script inside that directory, then simply run:
#do upgrade files and restart countly countly upgrade
If you are going to upgrade from a version that was released before last version (meaning, skipping version or more), then you will need to upgrade each version one by one.
You need to download latest release and extract it on your current Countly installation and then go to countly/bin/upgrade folder and execute all consecutive upgrade scripts.
Example: If you upgrade from 15.08 to 16.06, then you should do the following:
bash bin/upgrade/16.02/upgrade.sh bash bin/upgrade/16.06/upgrade.sh
Extract new package on old Countly directory, overwriting all existing files and then run following commands:
# Go to your countly directory (depends on your installation) cd countly # Install new depdendencies, if any npm install # Prepare production files grunt dist-all # Restart countly stop countly-supervisor start countly-supervisor