Matomo › Update

Matomo database will be upgraded from version 2.15.0-b12 to the new version 4.2.0.

The following plugins will be updated: LanguagesManager, Goals, Provider.

The following dimensions will be updated: log_conversion.revenue, log_link_visit_action.idaction_content_interaction, log_link_visit_action.idaction_content_name, log_link_visit_action.idaction_content_piece, log_link_visit_action.idaction_content_target, log_link_visit_action.idaction_product_cat, log_link_visit_action.idaction_product_cat2, log_link_visit_action.idaction_product_cat3, log_link_visit_action.idaction_product_cat4, log_link_visit_action.idaction_product_cat5, log_link_visit_action.idaction_product_name, log_link_visit_action.idaction_product_sku, log_link_visit_action.idpageview, log_link_visit_action.product_price, log_link_visit_action.search_cat, log_link_visit_action.search_count, log_link_visit_action.time_spent_ref_action, log_visit.config_browser_engine, log_visit.config_browser_name, log_visit.config_browser_version, log_visit.config_client_type, log_visit.config_cookie, log_visit.config_device_brand, log_visit.config_device_model, log_visit.config_device_type, log_visit.config_flash, log_visit.config_java, log_visit.config_os, log_visit.config_os_version, log_visit.config_pdf, log_visit.config_quicktime, log_visit.config_realplayer, log_visit.config_resolution, log_visit.config_silverlight, log_visit.config_windowsmedia, log_visit.location_browser_lang, log_visit.location_country, log_visit.location_latitude, log_visit.location_longitude, log_visit.location_region, log_visit.profilable, log_visit.referer_name, log_visit.referer_url, log_visit.user_id, log_visit.visit_entry_idaction_name, log_visit.visit_entry_idaction_url, log_visit.visit_exit_idaction_name, log_visit.visit_exit_idaction_url, log_visit.visit_goal_buyer, log_visit.visit_goal_converted, log_visit.visit_total_actions, log_visit.visit_total_events, log_visit.visit_total_interactions, log_visit.visit_total_searches, log_visit.visit_total_time, log_visit.visitor_count_visits, log_visit.visitor_localtime, log_visit.visitor_returning, log_visit.visitor_seconds_since_first, log_visit.visitor_seconds_since_last, log_visit.visitor_seconds_since_order.

Important notes for large Matomo installations

This is a major update! It will take longer than usual. The following advice is especially important for large installations.

If you have a large Matomo database, updates might take too long to run in the browser. In this situation, you can execute the updates from your command line:

php /var/www/vhosts/soyubey.de/statistik.soyubey.de/console core:update

If you manage a high traffic Matomo server, we recommend to momentarily disable visitor Tracking and put the Matomo User Interface in maintenance mode.

FYI: these are the SQL queries and console commands that will be executed to upgrade your database to Matomo 4.2.0

› Click here to view and copy the list of SQL queries and console commands that will get executed

# These console commands will be run: 
./console plugin:activate "Heartbeat"

# These SQL queries will be executed: 
UPDATE user_dashboard SET layout = '{\"config\":{\"layout\":\"33-33-33\"},\"columns\":[[{\"uniqueId\":\"widgetVisitsSummarygetEvolutionGraphforceView1viewDataTablegraphEvolution\",\"parameters\":{\"module\":\"VisitsSummary\",\"action\":\"getEvolutionGraph\",\"columns\":[\"nb_uniq_visitors\"],\"viewDataTable\":\"graphEvolution\",\"rows\":[],\"forceView\":\"1\"},\"isHidden\":false},{\"uniqueId\":\"widgetDevicesDetectiongetBrowsers\",\"parameters\":{\"module\":\"DevicesDetection\",\"action\":\"getBrowsers\"},\"isHidden\":false},{\"uniqueId\":\"widgetExampleFeedburnerfeedburner\",\"parameters\":{\"module\":\"ExampleFeedburner\",\"action\":\"feedburner\"},\"isHidden\":false}],[{\"uniqueId\":\"widgetReferrersgetKeywords\",\"parameters\":{\"module\":\"Referrers\",\"action\":\"getKeywords\"},\"isHidden\":false},{\"uniqueId\":\"widgetReferrersgetWebsites\",\"parameters\":{\"module\":\"Referrers\",\"action\":\"getWebsites\"},\"isHidden\":false}],[{\"uniqueId\":\"widgetUserCountryMapworldMap\",\"parameters\":{\"module\":\"UserCountryMap\",\"action\":\"worldMap\"},\"isHidden\":false},{\"uniqueId\":\"widgetLivewidget\",\"parameters\":{\"module\":\"Live\",\"action\":\"widget\"},\"isHidden\":false},{\"uniqueId\":\"widgetReferrersgetSearchEngines\",\"parameters\":{\"module\":\"Referrers\",\"action\":\"getSearchEngines\"},\"isHidden\":false},{\"uniqueId\":\"widgetExampleRssWidgetrssPiwik\",\"parameters\":{\"module\":\"ExampleRssWidget\",\"action\":\"rssPiwik\"},\"isHidden\":false}]]}' WHERE iddashboard = 1;
CREATE TABLE `plugin_setting` (`plugin_name` VARCHAR(60) NOT NULL, `setting_name` VARCHAR(255) NOT NULL, `setting_value` LONGTEXT NOT NULL, `user_login` VARCHAR(100) NOT NULL DEFAULT '') ENGINE=InnoDB DEFAULT CHARSET=utf8;
ALTER TABLE `plugin_setting` ADD INDEX index_plugin_name_user_login (`plugin_name`, `user_login`);
DELETE FROM `option` WHERE `option_name` like "Plugin_%_Settings";
DROP TABLE IF EXISTS `site_setting`;
CREATE TABLE `site_setting` (`idsite` INTEGER(10) UNSIGNED NOT NULL, `plugin_name` VARCHAR(60) NOT NULL, `setting_name` VARCHAR(255) NOT NULL, `setting_value` LONGTEXT NOT NULL) ENGINE=InnoDB DEFAULT CHARSET=utf8;
ALTER TABLE `site_setting` ADD INDEX(idsite, plugin_name);
ALTER TABLE `log_visit` CHANGE `idvisit` `idvisit` BIGINT(10) UNSIGNED NOT NULL AUTO_INCREMENT;
ALTER TABLE `log_conversion_item` CHANGE `idvisit` `idvisit` BIGINT(10) UNSIGNED NOT NULL;
ALTER TABLE `log_conversion` CHANGE `idvisit` `idvisit` BIGINT(10) UNSIGNED NOT NULL, CHANGE `idlink_va` `idlink_va` BIGINT(10) UNSIGNED default NULL;
ALTER TABLE `log_link_visit_action` CHANGE `idlink_va` `idlink_va` BIGINT(10) UNSIGNED NOT NULL AUTO_INCREMENT, CHANGE `idvisit` `idvisit` BIGINT(10) UNSIGNED NOT NULL, CHANGE `idaction_name_ref` `idaction_name_ref` INTEGER(10) UNSIGNED NULL;
ALTER TABLE `user` CHANGE `password` `password` VARCHAR(255) NOT NULL;
CREATE TABLE `privacy_logdata_anonymizations` (`idlogdata_anonymization` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT, `idsites` TEXT NULL DEFAULT NULL, `date_start` DATETIME NOT NULL, `date_end` DATETIME NOT NULL, `anonymize_ip` TINYINT(1) UNSIGNED NOT NULL DEFAULT 0, `anonymize_location` TINYINT(1) UNSIGNED NOT NULL DEFAULT 0, `anonymize_userid` TINYINT(1) UNSIGNED NOT NULL DEFAULT 0, `unset_visit_columns` TEXT NOT NULL DEFAULT '', `unset_link_visit_action_columns` TEXT NOT NULL DEFAULT '', `output` MEDIUMTEXT NULL DEFAULT NULL, `scheduled_date` DATETIME NULL, `job_start_date` DATETIME NULL, `job_finish_date` DATETIME NULL, `requester` VARCHAR(100) NOT NULL DEFAULT '', PRIMARY KEY ( `idlogdata_anonymization` )) ENGINE=InnoDB DEFAULT CHARSET=utf8;
ALTER TABLE `privacy_logdata_anonymizations` ADD INDEX index_job_start_date (`job_start_date`);
ALTER TABLE `plugin_setting` ADD COLUMN `json_encoded` TINYINT UNSIGNED NOT NULL DEFAULT 0;
ALTER TABLE `site_setting` ADD COLUMN `json_encoded` TINYINT UNSIGNED NOT NULL DEFAULT 0;
ALTER TABLE `site_setting` CHANGE `idsite` `idsite` INTEGER(10) UNSIGNED NOT NULL;
ALTER TABLE `plugin_setting` ADD COLUMN `idplugin_setting` BIGINT UNSIGNED NOT NULL PRIMARY KEY AUTO_INCREMENT;
ALTER TABLE `site_setting` ADD COLUMN `idsite_setting` BIGINT UNSIGNED NOT NULL PRIMARY KEY AUTO_INCREMENT;
ALTER TABLE `log_profiling` ADD COLUMN `idprofiling` BIGINT UNSIGNED NOT NULL PRIMARY KEY AUTO_INCREMENT;
ALTER TABLE `access` CHANGE `access` `access` VARCHAR(50) NULL;
ALTER TABLE `access` DROP PRIMARY KEY;
ALTER TABLE `access` ADD COLUMN `idaccess` INT UNSIGNED NOT NULL PRIMARY KEY AUTO_INCREMENT;
ALTER TABLE `access` ADD INDEX index_loginidsite (`login`, `idsite`);
ALTER TABLE `user` ADD COLUMN `ts_password_modified` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP;
CREATE TABLE `report_subscriptions` (`idreport` INT(11) NOT NULL, `token`  VARCHAR(100) NULL, `email` VARCHAR(100) NOT NULL, `ts_subscribed` TIMESTAMP DEFAULT CURRENT_TIMESTAMP, `ts_unsubscribed` TIMESTAMP NULL, PRIMARY KEY ( `idreport`, `email` )) ENGINE=InnoDB DEFAULT CHARSET=utf8;
ALTER TABLE `report_subscriptions` ADD UNIQUE KEY unique_token (`token`);
ALTER TABLE `user` CHANGE `ts_password_modified` `ts_password_modified` TIMESTAMP NULL;
UPDATE `user` SET ts_password_modified = NULL;
ALTER TABLE `site` ADD COLUMN `creator_login`  VARCHAR(100) NULL;

# These console commands will be run: 
./console plugin:activate "IntranetMeasurable"

# These SQL queries will be executed: 
ALTER TABLE `goal` ADD COLUMN `event_value_as_revenue` tinyint(4) NOT NULL default '0';
ALTER TABLE `report` ADD COLUMN `evolution_graph_within_period` TINYINT(4) NOT NULL DEFAULT 0;
ALTER TABLE `report` ADD COLUMN `evolution_graph_period_n` INT(11) NULL;
ALTER TABLE `user` ADD COLUMN `twofactor_secret` VARCHAR(40) NOT NULL DEFAULT '';
CREATE TABLE `twofactor_recovery_code` (`idrecoverycode` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT, `login` VARCHAR(100) NOT NULL, `recovery_code` VARCHAR(40) NOT NULL, PRIMARY KEY ( `idrecoverycode` )) ENGINE=InnoDB DEFAULT CHARSET=utf8;

# These console commands will be run: 
./console plugin:activate "TwoFactorAuth"
./console plugin:deactivate "GoogleAuthenticator"

# These SQL queries will be executed: 
CREATE TABLE `tracking_failure` (`idsite` BIGINT(20) UNSIGNED NOT NULL, `idfailure` SMALLINT UNSIGNED NOT NULL, `date_first_occurred` DATETIME NOT NULL, `request_url` MEDIUMTEXT NOT NULL, PRIMARY KEY ( `idsite`, `idfailure` )) ENGINE=InnoDB DEFAULT CHARSET=utf8;
CREATE TABLE `brute_force_log` (`id_brute_force_log` bigint(11) NOT NULL AUTO_INCREMENT, `ip_address` VARCHAR(60) DEFAULT NULL, `attempted_at` datetime NOT NULL, PRIMARY KEY ( `id_brute_force_log` )) ENGINE=InnoDB DEFAULT CHARSET=utf8;
ALTER TABLE `brute_force_log` ADD INDEX index_ip_address (`ip_address`);
ALTER TABLE `report` ADD COLUMN `period_param` VARCHAR(10) NULL;

# These console commands will be run: 
./console plugin:activate "Tour"

# These SQL queries will be executed: 
ALTER TABLE `goal` CHANGE `pattern_type` `pattern_type` varchar(25) NOT NULL;
CREATE TABLE `locks` (`key` VARCHAR(70) NOT NULL, `value` VARCHAR(255) NULL DEFAULT NULL, `expiry_time` BIGINT UNSIGNED DEFAULT 9999999999, PRIMARY KEY ( `key` )) ENGINE=InnoDB DEFAULT CHARSET=utf8;

# These console commands will be run: 
./console plugin:deactivate "ExamplePlugin"
./console plugin:deactivate "ExampleAPI"

# These SQL queries will be executed: 
UPDATE `option` SET option_value = 'https://download.db-ip.com/free/dbip-city-lite-2025-12.mmdb.gz' WHERE option_name = 'geoip2.loc_db_url' AND option_value = 'https://geolite.maxmind.com/download/geoip/database/GeoLite2-City.tar.gz';
UPDATE `option` SET option_value = 'https://download.db-ip.com/free/dbip-country-lite-2025-12.mmdb.gz' WHERE option_name = 'geoip2.loc_db_url' AND option_value = 'https://geolite.maxmind.com/download/geoip/database/GeoLite2-Country.tar.gz';

# These console commands will be run: 
./console core:matomo4-migrate-token-auths

# These SQL queries will be executed: 
CREATE TABLE `archive_invalidations` (`idinvalidation` BIGINT UNSIGNED NOT NULL AUTO_INCREMENT, `idarchive` INTEGER UNSIGNED NULL, `name` VARCHAR(255) NOT NULL, `idsite` INTEGER NOT NULL, `date1` DATE NOT NULL, `date2` DATE NOT NULL, `period` TINYINT UNSIGNED NOT NULL, `ts_invalidated` DATETIME NOT NULL, `status` TINYINT(1) UNSIGNED DEFAULT 0, `report` VARCHAR(255) NULL, PRIMARY KEY ( `idinvalidation` )) ENGINE=InnoDB DEFAULT CHARSET=utf8;
ALTER TABLE `archive_invalidations` ADD INDEX index_idsite_dates_period_name (`idsite`, `date1`, `period`);
ALTER TABLE `user` DROP COLUMN `alias`;
DELETE FROM `session` WHERE length(id) > 190;
ALTER TABLE `session` CHANGE `id` `id` VARCHAR(191);
ALTER TABLE `site_url` CHANGE `url` `url` VARCHAR(190);
ALTER TABLE `option` CHANGE `option_name` `option_name` VARCHAR(191);
ALTER TABLE `log_action` CHANGE `name` `name` VARCHAR(4096);
ALTER TABLE `log_conversion` CHANGE `url` `url` VARCHAR(4096);
ALTER TABLE `log_link_visit_action` CHANGE `interaction_position` `pageview_position` MEDIUMINT UNSIGNED DEFAULT NULL;

# These console commands will be run: 
./console plugin:activate "BulkTracking"
./console plugin:deactivate "CustomPiwikJs"
./console plugin:uninstall "CustomPiwikJs"

# These SQL queries will be executed: 
ALTER TABLE `archive_numeric_2010_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2010_11` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2010_12` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_02` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_03` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_04` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_05` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_06` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_07` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_08` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_09` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_10` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_11` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2011_12` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_02` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_03` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_04` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_05` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_06` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_07` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_08` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_09` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_10` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_11` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2012_12` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_02` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_03` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_04` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_05` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_06` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_07` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_08` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_09` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_10` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_11` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2013_12` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2014_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2014_02` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2014_03` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2014_04` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2021_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_numeric_2021_02` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2010_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2010_11` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2010_12` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_02` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_03` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_04` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_05` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_06` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_07` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_08` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_09` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_10` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_11` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2011_12` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_02` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_03` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_04` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_05` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_06` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_07` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_08` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_09` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_10` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_11` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2012_12` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_02` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_03` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_04` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_05` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_06` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_07` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_08` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_09` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_10` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_11` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2013_12` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2014_01` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2014_02` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2014_03` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2014_04` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `archive_blob_2021_02` CHANGE `name` `name` VARCHAR(190);
ALTER TABLE `log_link_visit_action` ADD COLUMN `search_cat` VARCHAR(200) NULL, ADD COLUMN `search_count` INTEGER(10) UNSIGNED NULL, ADD COLUMN `time_dom_completion` MEDIUMINT(10) UNSIGNED NULL, ADD COLUMN `time_dom_processing` MEDIUMINT(10) UNSIGNED NULL, ADD COLUMN `time_network` MEDIUMINT(10) UNSIGNED NULL, ADD COLUMN `time_on_load` MEDIUMINT(10) UNSIGNED NULL, ADD COLUMN `time_server` MEDIUMINT(10) UNSIGNED NULL, ADD COLUMN `time_transfer` MEDIUMINT(10) UNSIGNED NULL;
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_link_visit_action.search_cat', 'VARCHAR(200) NULL');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_link_visit_action.search_count', 'INTEGER(10) UNSIGNED NULL');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_link_visit_action.time_dom_completion', 'MEDIUMINT(10) UNSIGNED NULL');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_link_visit_action.time_dom_processing', 'MEDIUMINT(10) UNSIGNED NULL');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_link_visit_action.time_network', 'MEDIUMINT(10) UNSIGNED NULL');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_link_visit_action.time_on_load', 'MEDIUMINT(10) UNSIGNED NULL');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_link_visit_action.time_server', 'MEDIUMINT(10) UNSIGNED NULL');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_link_visit_action.time_transfer', 'MEDIUMINT(10) UNSIGNED NULL');
ALTER TABLE `log_visit` ADD COLUMN `visitor_seconds_since_first` INT(11) UNSIGNED NULL, ADD COLUMN `visitor_seconds_since_order` INT(11) UNSIGNED NULL, ADD COLUMN `visitor_seconds_since_last` INT(11) UNSIGNED NULL, ADD COLUMN `profilable` TINYINT(1) NULL;
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_visit.visitor_seconds_since_first', 'INT(11) UNSIGNED NULL1');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_visit.visitor_seconds_since_order', 'INT(11) UNSIGNED NULL1');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_visit.visitor_seconds_since_last', 'INT(11) UNSIGNED NULL');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_visit.profilable', 'TINYINT(1) NULL');
ALTER TABLE `log_conversion` ADD COLUMN `visitor_seconds_since_first` INT(11) UNSIGNED NULL, ADD COLUMN `visitor_seconds_since_order` INT(11) UNSIGNED NULL;
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_conversion.visitor_seconds_since_first', 'INT(11) UNSIGNED NULL');
INSERT IGNORE INTO `option` (option_name, option_value) VALUES ('version_log_conversion.visitor_seconds_since_order', 'INT(11) UNSIGNED NULL');
UPDATE log_link_visit_action SET search_cat = if(custom_var_k4 = '_pk_scat', custom_var_v4, search_cat), search_count = if(custom_var_k5 = '_pk_scount', custom_var_v5, search_count) WHERE custom_var_k4 = '_pk_scat' or custom_var_k5 = '_pk_scount';
DELETE FROM `option` WHERE option_name IN ("geoip.updater_period", "geoip.loc_db_url", "geoip.isp_db_url", "geoip.org_db_url");
UPDATE log_visit SET visitor_seconds_since_first = visitor_days_since_first * 86400, 
                    visitor_seconds_since_order = visitor_days_since_order * 86400,
                    visitor_seconds_since_last = visitor_days_since_last * 86400;
UPDATE log_conversion SET visitor_seconds_since_first = visitor_days_since_first * 86400, 
                    visitor_seconds_since_order = visitor_days_since_order * 86400;
ALTER TABLE `log_visit` DROP COLUMN `config_gears`, DROP COLUMN `config_director`, DROP COLUMN `visitor_days_since_first`, DROP COLUMN `visitor_days_since_order`, DROP COLUMN `visitor_days_since_last`;
ALTER TABLE `log_conversion` DROP COLUMN `visitor_days_since_first`, DROP COLUMN `visitor_days_since_order`;

# These console commands will be run: 
./console config:set --section="Tracker" --key="ignore_visits_cookie_name" --value="piwik_ignore"
./console plugin:activate "PagePerformance"
./console plugin:activate "CustomDimensions"
./console config:set --section="General" --key="login_allowlist_apply_to_reporting_api_requests" --value="0"

# These SQL queries will be executed: 
ALTER TABLE `archive_invalidations` ADD COLUMN `ts_started` DATETIME NULL;

# These console commands will be run: 
./console plugin:deactivate "ExampleTheme"

# These SQL queries will be executed: 
UPDATE user_token_auth SET hash_algo = "sha512" where hash_algo is null or hash_algo = "" ;

# These console commands will be run: 
./console plugin:uninstall "ExampleTheme"
./console plugin:deactivate "ExamplePlugin"
./console plugin:deactivate "ExampleLogTables"
./console plugin:deactivate "ExampleUI"
./console plugin:deactivate "ExampleReport"
./console plugin:deactivate "ExampleAPI"
./console plugin:deactivate "ExampleCommand"
./console plugin:deactivate "ExampleSettingsPlugin"
./console plugin:deactivate "ExampleTracker"
./console plugin:deactivate "ExampleVisualization"
./console plugin:uninstall "ExamplePlugin"
./console plugin:uninstall "ExampleLogTables"
./console plugin:uninstall "ExampleUI"
./console plugin:uninstall "ExampleReport"
./console plugin:uninstall "ExampleAPI"
./console plugin:uninstall "ExampleCommand"
./console plugin:uninstall "ExampleSettingsPlugin"
./console plugin:uninstall "ExampleTracker"
./console plugin:uninstall "ExampleVisualization"

# These SQL queries will be executed: 
UPDATE `archive_numeric_2010_01` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2010_11` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2010_12` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_01` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_02` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_03` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_04` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_05` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_06` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_07` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_08` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_09` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_10` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_11` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2011_12` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_01` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_02` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_03` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_04` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_05` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_06` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_07` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_08` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_09` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_10` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_11` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2012_12` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_01` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_02` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_03` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_04` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_05` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_06` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_07` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_08` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_09` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_10` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_11` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2013_12` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2014_01` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2014_02` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2014_03` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2014_04` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2021_01` SET `name` = 'done' WHERE `name` = 'done.';
UPDATE `archive_numeric_2021_02` SET `name` = 'done' WHERE `name` = 'done.';
ALTER TABLE `user_language` ADD COLUMN `use_12_hour_clock` TINYINT(1) NOT NULL DEFAULT 0 AFTER `language`;
ALTER TABLE `goal` ADD COLUMN `description` VARCHAR(255) NOT NULL DEFAULT '' AFTER `name`;
ALTER TABLE `log_visit` CHANGE `location_provider` `location_provider` VARCHAR(200) NULL;
ALTER TABLE `log_visit` ADD COLUMN `profilable` TINYINT(1) NULL, ADD COLUMN `user_id` VARCHAR(200) NULL, MODIFY COLUMN `visit_goal_buyer` TINYINT(1) NULL, MODIFY COLUMN `visit_goal_converted` TINYINT(1) NULL, MODIFY COLUMN `visitor_returning` TINYINT(1) NULL, ADD COLUMN `visitor_seconds_since_first` INT(11) UNSIGNED NULL, ADD COLUMN `visitor_seconds_since_order` INT(11) UNSIGNED NULL, MODIFY COLUMN `visitor_count_visits` INT(11) UNSIGNED NOT NULL DEFAULT 0, MODIFY COLUMN `visit_entry_idaction_name` INTEGER(10) UNSIGNED NULL, MODIFY COLUMN `visit_entry_idaction_url` INTEGER(11) UNSIGNED NULL  DEFAULT NULL, MODIFY COLUMN `visit_exit_idaction_name` INTEGER(10) UNSIGNED NULL, MODIFY COLUMN `visit_exit_idaction_url` INTEGER(10) UNSIGNED NULL DEFAULT 0, MODIFY COLUMN `visit_total_actions` INT(11) UNSIGNED NULL, ADD COLUMN `visit_total_interactions` MEDIUMINT UNSIGNED DEFAULT 0, MODIFY COLUMN `visit_total_searches` SMALLINT(5) UNSIGNED NULL, MODIFY COLUMN `referer_name` VARCHAR(255) NULL, MODIFY COLUMN `referer_url` VARCHAR(1500) NULL, MODIFY COLUMN `location_browser_lang` VARCHAR(20) NULL, MODIFY COLUMN `config_browser_engine` VARCHAR(10) NULL, MODIFY COLUMN `config_browser_name` VARCHAR(40) NULL, MODIFY COLUMN `config_browser_version` VARCHAR(20) NULL, ADD COLUMN `config_client_type` TINYINT( 1 ) NULL DEFAULT NULL, ADD COLUMN `config_device_brand` VARCHAR( 100 ) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, ADD COLUMN `config_device_model` VARCHAR( 100 ) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, ADD COLUMN `config_device_type` TINYINT( 100 ) NULL DEFAULT NULL, MODIFY COLUMN `config_os` CHAR(3) NULL, ADD COLUMN `config_os_version` VARCHAR( 100 ) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, MODIFY COLUMN `visit_total_events` INT(11) UNSIGNED NULL, MODIFY COLUMN `visitor_localtime` TIME NULL, ADD COLUMN `visitor_seconds_since_last` INT(11) UNSIGNED NULL, MODIFY COLUMN `config_resolution` VARCHAR(18) NULL, MODIFY COLUMN `config_cookie` TINYINT(1) NULL, MODIFY COLUMN `config_flash` TINYINT(1) NULL, MODIFY COLUMN `config_java` TINYINT(1) NULL, MODIFY COLUMN `config_pdf` TINYINT(1) NULL, MODIFY COLUMN `config_quicktime` TINYINT(1) NULL, MODIFY COLUMN `config_realplayer` TINYINT(1) NULL, MODIFY COLUMN `config_silverlight` TINYINT(1) NULL, MODIFY COLUMN `config_windowsmedia` TINYINT(1) NULL, MODIFY COLUMN `visit_total_time` INT(11) UNSIGNED NOT NULL, MODIFY COLUMN `location_country` CHAR(3) NULL, MODIFY COLUMN `location_latitude` decimal(9, 6) DEFAULT NULL, MODIFY COLUMN `location_longitude` decimal(9, 6) DEFAULT NULL, MODIFY COLUMN `location_region` char(3) DEFAULT NULL;
ALTER TABLE `log_conversion` MODIFY COLUMN `visitor_returning` TINYINT(1) NULL, ADD COLUMN `visitor_seconds_since_first` INT(11) UNSIGNED NULL, ADD COLUMN `visitor_seconds_since_order` INT(11) UNSIGNED NULL, MODIFY COLUMN `visitor_count_visits` INT(11) UNSIGNED NOT NULL DEFAULT 0, MODIFY COLUMN `referer_name` VARCHAR(255) NULL, ADD COLUMN `config_browser_name` VARCHAR(40) NULL, ADD COLUMN `config_client_type` TINYINT( 1 ) NULL DEFAULT NULL, ADD COLUMN `config_device_brand` VARCHAR( 100 ) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, ADD COLUMN `config_device_model` VARCHAR( 100 ) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL, ADD COLUMN `config_device_type` TINYINT( 100 ) NULL DEFAULT NULL, MODIFY COLUMN `location_country` CHAR(3) NULL, MODIFY COLUMN `location_latitude` decimal(9, 6) DEFAULT NULL, MODIFY COLUMN `location_longitude` decimal(9, 6) DEFAULT NULL, MODIFY COLUMN `location_region` char(3) DEFAULT NULL, MODIFY COLUMN `revenue` float default NULL;
ALTER TABLE `log_link_visit_action` ADD COLUMN `idpageview` CHAR(6) NULL DEFAULT NULL, ADD COLUMN `search_cat` VARCHAR(200) NULL, ADD COLUMN `search_count` INTEGER(10) UNSIGNED NULL, MODIFY COLUMN `time_spent_ref_action` INTEGER(10) UNSIGNED NULL, ADD COLUMN `idaction_product_cat` INT(10) UNSIGNED NULL, ADD COLUMN `idaction_product_cat2` INT(10) UNSIGNED NULL, ADD COLUMN `idaction_product_cat3` INT(10) UNSIGNED NULL, ADD COLUMN `idaction_product_cat4` INT(10) UNSIGNED NULL, ADD COLUMN `idaction_product_cat5` INT(10) UNSIGNED NULL, ADD COLUMN `idaction_product_name` INT(10) UNSIGNED NULL, ADD COLUMN `product_price` DOUBLE NULL, ADD COLUMN `idaction_product_sku` INT(10) UNSIGNED NULL, ADD COLUMN `idaction_content_interaction` INTEGER(10) UNSIGNED DEFAULT NULL, ADD COLUMN `idaction_content_name` INTEGER(10) UNSIGNED DEFAULT NULL, ADD COLUMN `idaction_content_piece` INTEGER(10) UNSIGNED DEFAULT NULL, ADD COLUMN `idaction_content_target` INTEGER(10) UNSIGNED DEFAULT NULL;

Need help upgrading Matomo?

If you need support to upgrade your Matomo, the creators of Matomo are here to help you make the Matomo upgrade a success and provide all instructions, best practises and ongoing support. Contact the Matomo experts to get started upgrading your Matomo safely.

Ready to go?

The database upgrade process may take a while, so please be patient.

File integrity check failed and reported some errors. You should fix this issue and then refresh this page until it shows no error.

Database Upgrade Required

Important notes for large Matomo installations

Need help upgrading Matomo?

Ready to go?