Upgrading to the latest Countly Edition usually does not involve any complicated operations. However, you need to know which version you are upgrading to.
For Countly Lite
To get the latest Countly Lite package, go to our Github repository.
For Countly Enterprise
To get the latest Countly Enterprise package, login to our support system and go to the Enterprise package page. If you don't have an account there, you can sign up for one here.
Regular Upgrade
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 the 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 19.02 with your new version):
bash bin/upgrade/19.02/upgrade.sh
If there is no such directory and upgrade.sh script inside that directory, then simply run:
#do upgrade files and restart countly countly upgrade
Skipping Versions When Upgrading
If you are going to upgrade from a version that was released before the last version (meaning, skipping one version or more), then you will need to upgrade each version one by one, as shown below.
For this, you first need to download the 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 18.04 to 19.02, then you should do the following after extracting 19.02 package on top of 18.04:
bash bin/upgrade/18.08/upgrade.sh bash bin/upgrade/19.02/upgrade.sh
Upgrading from Countly Lite to Countly Enterprise
Countly CLI is already able to upgrade from Countly Lite to Countly Enterprise. You can follow this procedure to complete process:
cd `countly dir`/../ (download enterprise edition package which is provided by us) countly upgrade ee
Post-Upgrade Checklist
You can ensure that the upgrade was successful by going through the below checklist:
- Upgrade finished without errors
- Countly is accessible and dashboard loads
- New data arriving in Overview (Sessions or users are increasing)
- For Countly Enterprise, you can also check new data arriving in Users -> User Profile list (list changes with latest users)
- New data arriving in Utilities -> Request Logs (new request logs are coming in)
- No errors after starting Countly in countly/log/countly-api.log or top cog -> Server Logs -> API