manual:installation:upgrade_notes_600

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
manual:installation:upgrade_notes_600 [2018/06/13 03:34]
manual:installation:upgrade_notes_600 [2021/11/13 17:01] (current)
Line 1: Line 1:
 +==== 10 Upgrade notes for 6.0.0 ====
 +
 +​<note important>​Zabbix 6.0.0 is not released yet.</​note>​
 +
 +These notes are for upgrading from Zabbix 5.4.x to Zabbix 6.0.0. All notes are grouped into:
 +
 +  * ''​Critical''​ - the most critical information related to the upgrade process and the changes in Zabbix functionality
 +  * ''​Informational''​ - all remaining information describing the changes in Zabbix functionality
 +
 +It is possible to upgrade to Zabbix 6.0.0 from versions before Zabbix 5.4.0. See the [[:​manual/​installation/​upgrade|upgrade procedure]] section for all relevant information about upgrading from previous Zabbix versions.
 +
 +==== Critical ====
 +
 +=== Databases ===
 +
 +To create the optimal user experience and ensure the best Zabbix performance in various production environments,​ the support of some older database releases has been dropped. This primarily applies to the database versions that are nearing their end of service life point and versions with unfixed issues that may interfere with normal performance.
 +
 +Starting from Zabbix 6.0, the following [[:​manual/​installation/​requirements#​Software|database]] versions are officially supported:
 +
 +  * //​MySQL/​Percona//​ 8.0.X
 +  * //MariaDB// 10.5.X - 10.6.X
 +  * //​PostgreSQL//​ 13.X
 +  * //Oracle// 19c - 21c
 +  * //​TimescaleDB//​ 2.0.1-2.3
 +  * //SQLite// 3.3.5-3.34.X
 +
 +By default, Zabbix server and proxy will not start if an unsupported database version is detected. It is now possible, though not recommended,​ to turn off DB version check by modifying AllowUnsupportedDBVersions configuration parameter for the [[:​manual/​appendix/​config/​zabbix_server|server]] or [[:​manual/​appendix/​config/​zabbix_proxy|proxy]].
 +
 +=== Audit log ===
 +
 +In order to improve audit logging in Zabbix and make the Audit log complete and reliable, the previously existing database structure had to be reworked. During an upgrade DB tables ''​auditlog''​ and ''​auditlog_details''​ will be replaced by the new table ''​auditlog''​ with a different format. **Old audit records will not be preserved.**  ​
 +
 +New [[manual/​web_interface/​frontend_sections/​administration/​general#​audit_log|section]] //Audit log// has been added to the //​Administration→General//​ menu allowing to enable (default) or disable audit logging. Housekeeping settings for audit, previously located under the //​Housekeeper//​ menu section, have also been moved to the new //Audit log// section. Existing housekeeping settings will be saved.  ​
 +
 +=== API changes ===
 +
 +See the list of [[manual/​api/​changes_5.4_-_6.0|API changes]] in Zabbix 6.0.0.
 +
 +=== Simple macros replaced by expression macros ===
 +
 +The functionality of simple macros has been [[:​manual/​introduction/​whatsnew600#​simple_macros_replaced_by_expression_macros|transferred]] to expression macros. The existing simple macros will be converted to expression macros during the upgrade. Macros that can not be converted without exceeding the length limit will not be converted with a warning printed in the log file.
 +
 +=== Positional macros no longer supported ===
 +
 +The support for positional macros in item name ($1, $2...$9), deprecated since Zabbix 4.0, has been fully removed.
 +
 +=== Monitoring → Overview removed ===
 +
 +The Overview section in the Monitoring menu has been removed completely. The same functionality can be still accessed by using the //Data overview// and //Trigger overview// dashboard [[:​manual/​web_interface/​frontend_sections/​monitoring/​dashboard/​widgets|widgets]].
 +
 +==== Informational ====
 +
 +=== Zabbix agent 2 plugins ===
 +
 +Each Zabbix agent 2 plugin now has a separate [[manual/​appendix/​config/​zabbix_agent2_plugins|configuration file]]. By default, these files are located in the ''​./​zabbix_agent2.d/​plugins.d/''​ directory. The path is specified in the ''​Include''​ parameter of the agent 2 configuration file and can be relative to the [[manual/​appendix/​config/​zabbix_agent2|zabbix_agent2.conf]] or [[manual/​appendix/​config/​zabbix_agent2_win|zabbix_agent2.win.conf]] file location.
 +
 +
 +
 +=== User passwords ===
 +Previously, spaces in user passwords have been automatically trimmed in both the User configuration form and the Login form. 
 +After the introduction of configurable [[:​manual/​introduction/​whatsnew600#​password_requirements|password complexity requirements]],​ spaces in passwords are no longer trimmed. So users, who thought that they had spaces in their passwords, will not be able to log in as usual and will have to enter their '​old'​ password without spaces. To continue using passwords with spaces, they will need to recreate their passwords.