How to upgrade Asternic 2.x to a new version

Upgrade

 

In order to upgrade, your license/support must be within the yearly support period. You can check that by logging into your existing Asternic, under Setup/License menu. If yearly support has expired, you must purchase the annual software maintenance before attempting an upgrade.

Upgrading from previous 2.X versions

To upgrade the software you need to access your server command line and have root permissions. Log into your server and follow these steps:

cd /usr/src
wget http://download.asternic.net/asternic-stats-pro-2.3.18.tgz

The above commands will download our latest release into /usr/src on your server. You need now to extract the package and change the working directory to the extracted location:

tar zxvf asternic-stats-pro-2.3.18.tgz
cd asternic-stats-pro-2.3.18

Now that the software is extracted, you can proceed to upgrade it. Simply run:

sudo make upgrade

That should get you going. When you run the above commands, be sure to inspect the output for possible errors or warnings.

Since release 2.3.0, some table schemas changed quite a bit. You will have to use the asterniclog parser instead of the (old) tailqueuelog script used in 1.X versions. Also, as the schema change is major, all existing data must be reconverted. Data migrations will be handled automatically by the asterniclog service when it restarts. If you have lots of data this process will take several minutes, up to hours depending on data amount and server load. So, if you have millions of records, it is better to attempt the upgrade after hours when the machine load is low and there is no need to get reports while the conversion takes place


Upgrading from 1.X versions

There is no upgrade path from 1.X to 2.X. If you need to perform such upgrade, please contact us and we will guide you on the upgrade.


Did you find this article useful?