Each eTraxis version consists of three numbers − first two are major version, and last one is minor version. For example, in eTraxis 1.5.2 the 1.5 is major version, while 2 is minor. The major version is increased when data schema is changed, so you need to update your database tables before upgrade. The minor version is increased when data schema remains the same, so current database tables can be kept as they are. When major version is being increased, the minor version is changed to zero.

Upgrade procedure

Before upgrade to more recent version of eTraxis, you should compare this new version with the version you have currently installed. If both major versions are the same, your database does not require to be updated. Otherwise, you need to update your database before using newer version. Let's assume, you have installed eTraxis 1.5.2 and want to upgrade it up to 1.6.0. In this case you have to do following:

Restrict any access to your eTraxis installation from users.
Backup your current database for case of upgrade errors.
Find upgrade script for your database at '/tools/upgrade/15Xto16X'.
If your database is named other than "etraxis", update related lines on top of the upgrade script correspondingly. Below are examples of such lines for different database servers:

use etraxis;
set @dbname = 'etraxis';
connect etraxis/password@database;

Execute upgrade script on your database.
Replace current installation of eTraxis with new one.
Restore access restricted at step #1.

Please note, if difference between compared major versions is greater than 1, then you need to execute all related upgrade scripts one by one. For example, if you're upgrading from 1.3.1 to 1.6.0, then you need to perform steps 3-5 above for '/tools/upgrade/13Xto14X', then for '/tools/upgrade/14Xto15X', and finally for '/tools/upgrade/15Xto16X'.

One more thing to be aware of is '/src/engine/config.php' configuration file. You should take care about any configuration changes, you made in this file before, and put these changes back when replacing the file with newer version. Actually, this file is changed quite rarely, so in most cases you can just keep the same file you have - just check the list of changed files in the release notes of new eTraxis version to be sure that the file was not changed since the previous release.

Last update: 2010-02-16