Welcome Guest! Log in

After reading this article, please feel free to ask questions on the forum or to the Support Team.


Upgrading from 3.x.x to 3.6.x


When upgrading to Analytics 3.6, you may have issues with some databases providers.

Errors such as the following are thrown in console and the datasource is not initialized, so analytics does not work:


SQL Server

When this error appears with SQL Server, this may be because of the SQL Server JDBC Driver used is too old.

Using a more recent JDBC Driver can fix the issue. 

Sybase ASE

When this error appears with Sybase ASE, this might be a permission problem on the database.

Adding 'select into' and 'full logging for alter table' permissions to the Sybase ASE database may fixe the issue.

This can be done with the following commands:

sp_dboption 'anaytics_database_name','select into',true
sp_dboption 'anaytics_database_name','full logging for alter table',true

Upgrading from 2.x.x to 3.x.x

Overview of the upgrade process

Migrating from 2.x.x to 3.x.x requires a particular attention as 3.x.x introduces major improvements and changes.

A complete migration wizard included in the application has been developed to help users to migrate.

Please refer to the installation and migration parts of the reference documentation which explain everything.

We also highly recommend to have a look at the release notes for an overview of what have changed.



Installing Analytics with a MariaDB database might fail on Analytics V3 and MariaDB Version 2.4.0 (or higher).

This kind of message can be displayed:


To resolve this problem, when you have a MariaDB database as an Analytics database, use the mysql jdbc driver instead of the mariadb jdbc driver.

As a reminder, the driver is configured in the context.xml file of Tomcat.


Upgrading from 2.x.x to 2.x.x

Overview of the upgrade process

  • Make a backup of your Analytics WebappHome directory
  • Make a backup of your Analytics installation (or make sure you can reinstall your current version)
  • Please read carefully the Release Notes
  • Download and install the new Analytics version (please ask your Application Server's administrator)
  • Specific operations when upgrading from version 2.0.x to 2.1.x or 2.2.x:
    • Open and Save your analytics repositories in order to migrate them
    • Important note: once opened and saved into Analytics 2.1.x or 2.2.x, a repository can no longer be opened from Analytics 2.0.x.


# Virginie_Samson 2016-02-10 14:28
What do you mean by "open and save your analytics repositories" ?

# Virginie_Samson 2016-02-16 13:36
Help ... :-*
# Thomas BLETON 2016-02-16 14:09
In Analytics, simply double click each of your Repositories (renamed "Deployment managers" in the latest versions). And then save them (Ctrl + S).
# Virginie_Samson 2016-02-25 10:52
Can we have 2 versions of Web Analytics on the same machine? Or do we MUST stop the old one service before starting the migration ?
# Thomas BLETON 2016-02-25 15:30
Short answer: yes it is possible.
Long answer: do not use an existing webapp home with an older version of Analytics! The idea is to have your new version running under a different Port, and set a STAMBIA_WEBAPP_HOME_ variable pointing to a new directory location.
We'll write an article on this subject soon.
# Virginie_Samson 2016-02-25 11:04
Does the file tomcat-users.xml change in this version ?
Do we need to copy it back?
# Thomas BLETON 2016-02-25 15:32
As far as I know, no need to alter this file in this version. I also use Tomcat and did not have to change it.
# Virginie_Samson 2016-02-25 17:01
I did the replace of the analytics.war, the reboot of Tomcat, but we are still on the old version
(Cf Mail Support)
An idea?
# Damien ESPRIET 2016-10-24 16:12
Pour info, sous JBoss, il est nécessaire de vider le cache en supprimant le dossier tmp/work pour redémarrer correctement.
# Nicolas Verscheure 2018-01-23 09:44
We have done the migration from version 2.07 to 2.2.4. When we open the repository, we have warning on each package. The support gives us the following solution : go in the configuration section, modify a description of a configuration, save, close the repository and the warnings disapears.
# odile 2019-07-10 11:44
what is "WebappHome directory" please?
# odile 2019-07-10 11:50

You have no rights to post comments


Suggest a new Article!