Upgrades - v3.1 or Later

Upgrade Instructions

This is only for versions 3.1 or Later.

Please ensure you have a full backup of your current system before starting the upgrade.

Passwords - Please Read

If you are upgrading from a version older than 4.0, all passwords will be reset. In 4.0+ passwords are now stored using the PHP password API which uses bcrypt. This favours the less secure sha1 used in previous versions.

Once the upgrade has completed, you'll need to use the reset option to reset all staff passwords.

Account visitors will need to use the 'forgot password' option to reset their password. You can also batch reset the passwords via the admin interface and send out a broadcast message to let people know.

How to Upgrade

1 Backup your existing structure and database.

2 Download the latest version of Maian Support.

3 From the latest archive, remove the following files:

licence.lic

4 If the 'control/_cfg.php' file does not exist in your installation, copy the '_control/_cfg-sample.php' as 'control/_cfg.php' and complete the options in the file. You can copy the information from the old 'control/connect.php' file. Note that your admin login details are here now too, so copy the info from your existing 'admin/control/access.php' file or simply enter new login details in the new '_cfg.php' file.

5 Upload all other files to replace/overwrite your existing structure.

6 Access the upgrade installer in your browser:

https://www.example.com/helpdesk/install/upgrade.php

7 Follow the instructions to upgrade your setup.

8 Delete the "install" folder from your installation.

9 Important: If you are running a version less than 4.3, you need to update the cron job paths if you are using them. More info here.

10 Refer to the Maian Support Changelog to see what has been added/updated in the latest version.

11 If you are using a custom template, check the templates section below for any new folders or file locations that may need updating for the version you are upgrading to. If no changes are shown for the version you are upgrading to, you can ignore this.

12 Upgrade completed

Templates

If you made custom changes to the default template set, details are provided of changes to the latest default template set, which need to be deployed to your existing set for it to work with the latest changes. Only versions shown below have any template changes. Click for information.

v4.0 Template Changes & Updates
v4.2 Template Changes & Updates
v4.3 Template Changes & Updates
v4.4 Template Changes & Updates

Language

This section details language changes which are useful if you are using a language translation.

Language Changes & Additions

Changelog

To view the changelog, here.

Return to Upgrade Overview