- Is your license active?
- Take your support desk offline
- Backup the support desk data
- Download and extract the latest release product archive
- Upload the product files
- Moving directories/files
- Setting file permissions
- Run the upgrade script
- Restore templates
- Restore language phrases
- Rebuild support desk cache
This procedure involves upgrading to a newer version of Kayako Fusion, Case or Engage from a lower release.
It is always recommended that the support desk be running on the latest Kayako 4 release. The latest releases have the most recent bug fixes and security patches applied, hence making your help desk bug free and secure.
Is your license active?
In order to get access to the latest updates for your Kayako helpdesk, your license needs to be active (your product updates and support subscription). To check if your license is active, login to my.kayako.com and click on Orders.
Take your support desk offline
To ensure that your clients does not face any inconvenience while the support desk is being upgraded, it is recommended to take it offline. This is easily done by putting up a single index.html file in the document root directory. This file should have a notice in it explaining to your customers that you're currently upgrading your help desk and that it will be back shortly.
This also prevents any incoming email sent to your email queue(s) from becoming tickets and interfering with the upgrade process.
Backup the support desk data
The most important step in upgrading the support desk is making very sure you have a complete and valid backup of your version 4 support desk data.
Data directory backup
By default, the storage location of download files and file attachments is set to "files" directory (to check the storage location, click here). In this case, keep a copy of the files directory (placed in ../swift/ directory) as all of your ticket attachments and download files are stored here.
MySQL has published information about backing up databases here.
You should store this backup database on a RAID machine or optical storage (or multiple physical locations) for safe-keeping.
Modified templates backup
Export all the support desk templates that you have modified. The procedure to export the templates is as explained here.
Modified language pack backup
Export the language pack or additional language packs, if any. The procedure to export the languages is as explained here.
Download and extract the latest release product archive
Once the archive is extracted, you will get a directory which has the following directories:
This directory contains the live chat application - Kayako Desktop.
Contains the product files
Upload the product files
Upload the contents of the "upload" directory to the document root of the web server, overwriting the current version product files. The procedure to upload product files using an FTP client is as explained here.
Now copy/move the following backed up directories/files to the document root, replacing them with the existing directories/files:
Setting file permissions
You need to set the file permissions, as described here.
Run the upgrade script
Access the setup page as http://your_supportdesk_URL/setup/ and click Upgrade as shown:
Clicking on the Upgrade option from the menu, you will be prompted to review the license agreement as shown here:
Click on the I Agree button and the script will then check your web server to ensure that it meets the minimum system requirements for the upgrade. If you encounter errors, follow the instructions on your screen. Otherwise, press Next to start the automated upgrade procedure:
The automated upgrade procedure will cycle through screens resembling this one until it has completed:
Once the upgrade process has completed, you will see the following screen:
Login to the admin control panel and you will get the alerts to restore the templates and language phrases.
After upgrading your installation of Kayako Fusion, Case or Engage, you may need to restore some templates. This is because the newer version of the software may carry with it newer versions of templates. Rather than overwriting your customized templates, the upgrade system will simply mark the modified templates as “Upgrade Revert Required” after the upgrade. It may be such that you do need to revert the templates that have been updated, so that new functionality can be implemented.
The procedure to restore the templates is as explained here.
Restore language phrases
After upgrading your installation of Kayako Fusion, Case or Engage, you may need to restore some phrases. This is because the newer version of the software may carry with it the newer version of the language phrases. Rather than overwriting your customized phrases, the upgrade system will simply mark the modified phrases as “Upgrade Revert Required” after the upgrade.
The procedure to restore the language phrases is as explained here.
Rebuild support desk cache
The support desk cache needs to be rebuild to recreate the cached contents in the "__swift/cache/" directory, as well as all the cached data like "settings", "staffgroups","languagephrase" etc. stored in the database, prior to the upgrade.
The procedure to rebuild support desk cache is as explained here.non