Sidebar

manual:installation:upgrade_notes_500

This is an old revision of the document!


9 Upgrade notes for 5.0.0

Zabbix 5.0.0 is not released yet.

These notes are for upgrading from Zabbix 4.4.x to Zabbix 5.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 5.0.0 from versions before Zabbix 4.4.0. See the upgrade procedure section for all relevant information about upgrading from previous Zabbix versions.

Critical

Minimum required PHP version

The minimum required PHP version has been upped to 7.2.0 from 5.4.0.

This change also affects the ability to install Zabbix frontend from packages in some distributions. See detailed instructions for installing Zabbix frontend from packages on RHEL/CentOS 7 and the affected Debian/Ubuntu versions.

Support of IBM DB2 dropped

The IBM DB2 database is no longer supported by Zabbix.

Support of Internet Explorer 11 dropped

Microsoft Internet Explorer 11 is no longer supported by Zabbix.

Support of mbedTLS (PolarSSL) crypto library dropped

mbedTLS (PolarSSL) crypto library is no longer supported by Zabbix. Supported crypto libraries are GnuTLS and OpenSSL.

Minimum required database versions

Minimum database versions required for Zabbix 5.0.0 have been upped to:

  • MySQL 5.5.62
  • MariaDB 10.0.37
  • PostgreSQL 9.2.24
  • Oracle 11.2

Enable extended range of numeric (float) values

Numeric (float) data type now supports precision of approximately 15 digits and range from approximately -1.79E+308 to 1.79E+308 (with exception of PostgreSQL 11 and earlier versions). This is by default for new installations. However, when upgrading existing installations, a manual database upgrade patch must be applied.

The patch will alter data columns of history and trends tables, which usually contain lots of data, therefore it is expected to take some time to complete. Since the exact estimate depends on server performance,​ database management system configuration and version, and it cannot be predicted, it is recommended to first test the patch outside the production environment.

Please execute the appropriate patch (SQL file) for your database:

  • database/mysql/double.sql
  • database/postgresql/double.sql
  • database/oracle/double.sql

Note that with TimescaleDB the compression support must only be turned on after applying this patch.

After upgrading database tables, please also set or update $DB['DOUBLE_IEEE754'] value to true in /frontends/php/conf/zabbix.conf.php.

Informational

No data triggers sensitive to proxy availability

No data triggers are now, by default, sensitive to proxy availability.

Fullscreen mode replaced by hiding menu

The fullscreen mode has been removed from the Monitoring sections of the frontend. The same effect (showing only page title and content) now can be achieved by hiding the new vertical menu. The kiosk mode (page content only, no page title at all) remains.

Option for dropdown first entry removed

The screen for configuring frontend defaults no longer has a Dropdown first entry option, because dropdowns for host group and host selection have been replaced with multiselect fields in the frontend.

Configuration parameters

The EnableRemoteCommands parameter is now deprecated. Remote commands are still disabled by default, but in the new configuration files that is expressed by using the new DenyKey parameter (DenyKey=system.run[*]). Remote commands can be enabled by removing (or commenting out) DenyKey=system.run[*] parameter.

Item key limit

The maximum allowed length of an item key has been raised from 256 to 2048 characters.

Minimum Net-SNMP version

It is now possible to manually clear the SNMP cache on Zabbix server and proxy. Due to adding a new runtime control option, Net-SNMP version 5.3.0 or higher is now required for SNMP support.

Redis plugin update

Configuration parameter Plugins.Redis.Password was removed and an opportunity to pass a password as a key parameter has now been added. See Redis plugin metrics for details.

Supported Elasticsearch versions changed

Elasticsearch version 7.X is now supported. Support of the older versions has been dropped.