Documentation
Table of Contents
7 ???? ?????
Overview
This section provides upgrade information for Áú»¢¶Ä²© 6.4:
- using packages:
- using sources
See also upgrade instructions for servers in a high-availability (HA) cluster.
Upgrading Áú»¢¶Ä²© agents is recommended but not mandatory.
Upgrading Áú»¢¶Ä²© proxies is highly recommended. Áú»¢¶Ä²© server fully supports proxies that are of the same major version as the server. Áú»¢¶Ä²© server also supports proxies that are no older than Áú»¢¶Ä²© server previous LTS release version, but with limited functionality (data collection, execution of remote commands, immediate item value checks). Configuration update is also disabled, and outdated proxies will only work with old configuration.
Proxies that are older than Áú»¢¶Ä²© server previous LTS release version or newer than Áú»¢¶Ä²© server major version are not supported. Áú»¢¶Ä²© server will ignore data from unsupported proxies and all communication with Áú»¢¶Ä²© server will fail with a warning. For more information, see Version compatibility.
To minimize downtime and data loss during the upgrade, it is recommended to stop, upgrade, and start Áú»¢¶Ä²© server and then stop, upgrade, and start Áú»¢¶Ä²© proxies one after another. During server downtime, running proxies will continue data collection. Once the server is up and running, outdated proxies will send the data to the newer server (proxy configuration will not be updated though) and will remain partly functional. Any notifications for problems during Áú»¢¶Ä²© server downtime will be generated only after the upgraded server is started.
If Áú»¢¶Ä²© proxy is started for the first time and the SQLite database file is missing, proxy creates it automatically. Note that starting with Áú»¢¶Ä²© 6.4.0, if Áú»¢¶Ä²© proxy uses SQLite3 and on startup detects that existing database file version is older than required, it will delete the database file automatically and create a new one. Therefore, history data stored in the SQLite database file will be lost. If Áú»¢¶Ä²© proxy's version is older than the database file version, Áú»¢¶Ä²© will log an error and exit.
Depending on the database size, the database upgrade to version 6.4 may take a long time.
Direct upgrade to Áú»¢¶Ä²© 6.4.x is possible from Áú»¢¶Ä²© 6.2.x, 6.0.x, 5.4.x, 5.2.x, 5.0.x, 4.4.x, 4.2.x, 4.0.x, 3.4.x, 3.2.x, 3.0.x, 2.4.x, 2.2.x and 2.0.x. For upgrading from earlier versions consult Áú»¢¶Ä²© documentation for 2.0 and earlier.
Please be aware that after upgrading some third-party software integrations in Áú»¢¶Ä²© might be affected, if the external software is not compatible with the upgraded Áú»¢¶Ä²© version.
The following upgrade notes are available:
| Upgrade from | Read full upgrade notes | Most important changes between versions |
|---|---|---|
| 6.2.x | For: Áú»¢¶Ä²© 6.4 |
Minimum required MySQL version raised from 8.0.0 to 8.0.30. 'libevent_pthreads' library is required for Áú»¢¶Ä²© server/proxy. Upon the first launch after an upgrade, Áú»¢¶Ä²© proxy with SQLite3 automatically dumps the old version of the database (with all the history) and creates a new one. |
| 6.0.x LTS | For: Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Minimum required PHP version upped from 7.2.5 to 7.4.0. Deterministic triggers need to be created during the upgrade. If binary logging is enabled for MySQL/MariaDB, this requires superuser privileges or setting the variable/configuration parameter log_bin_trust_function_creators = 1. See Database creation scripts for instructions how to set the variable. |
| 5.4.x | For: Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Minimum required database versions upped. Server/proxy will not start if outdated database. Audit log records lost because of database structure change. |
| 5.2.x | For: Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Minimum required database versions upped. Aggregate items removed as a separate type. |
| 5.0.x LTS | For: Áú»¢¶Ä²© 5.2 Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Minimum required PHP version upped from 7.2.0 to 7.2.5. Password hashing algorithm changed from MD5 to bcrypt. |
| 4.4.x | For: Áú»¢¶Ä²© 5.0 Áú»¢¶Ä²© 5.2 Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Support of IBM DB2 dropped. Minimum required PHP version upped from 5.4.0 to 7.2.0. Minimum required database versions upped. Changed Áú»¢¶Ä²© PHP file directory. |
| 4.2.x | For: Áú»¢¶Ä²© 4.4 Áú»¢¶Ä²© 5.0 Áú»¢¶Ä²© 5.2 Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Jabber, Ez Texting media types removed. |
| 4.0.x LTS | For: Áú»¢¶Ä²© 4.2 Áú»¢¶Ä²© 4.4 Áú»¢¶Ä²© 5.0 Áú»¢¶Ä²© 5.2 Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Older proxies no longer can report data to an upgraded server. Newer agents no longer will be able to work with an older Áú»¢¶Ä²© server. |
| 3.4.x | For: Áú»¢¶Ä²© 4.0 Áú»¢¶Ä²© 4.2 Áú»¢¶Ä²© 4.4 Áú»¢¶Ä²© 5.0 Áú»¢¶Ä²© 5.2 Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
'libpthread' and 'zlib' libraries now mandatory. Support for plain text protocol dropped and header is mandatory. Pre-1.4 version Áú»¢¶Ä²© agents are no longer supported. The Server parameter in passive proxy configuration now mandatory. |
| 3.2.x | For: Áú»¢¶Ä²© 3.4 Áú»¢¶Ä²© 4.0 Áú»¢¶Ä²© 4.2 Áú»¢¶Ä²© 4.4 Áú»¢¶Ä²© 5.0 Áú»¢¶Ä²© 5.2 Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
SQLite support as backend database dropped for Áú»¢¶Ä²© server/frontend. Perl Compatible Regular Expressions (PCRE) supported instead of POSIX extended. 'libpcre' and 'libevent' libraries mandatory for Áú»¢¶Ä²© server. Exit code checks added for user parameters, remote commands and system.run[] items without the 'nowait' flag as well as Áú»¢¶Ä²© server executed scripts. Áú»¢¶Ä²© Java gateway has to be upgraded to support new functionality. |
| 3.0.x LTS | For: Áú»¢¶Ä²© 3.2 Áú»¢¶Ä²© 3.4 Áú»¢¶Ä²© 4.0 Áú»¢¶Ä²© 4.2 Áú»¢¶Ä²© 4.4 Áú»¢¶Ä²© 5.0 Áú»¢¶Ä²© 5.2 Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Database upgrade may be slow, depending on the history table size. |
| 2.4.x | For: Áú»¢¶Ä²© 3.0 Áú»¢¶Ä²© 3.2 Áú»¢¶Ä²© 3.4 Áú»¢¶Ä²© 4.0 Áú»¢¶Ä²© 4.2 Áú»¢¶Ä²© 4.4 Áú»¢¶Ä²© 5.0 Áú»¢¶Ä²© 5.2 Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Minimum required PHP version upped from 5.3.0 to 5.4.0. LogFile agent parameter must be specified. |
| 2.2.x LTS | For: Áú»¢¶Ä²© 2.4 Áú»¢¶Ä²© 3.0 Áú»¢¶Ä²© 3.2 Áú»¢¶Ä²© 3.4 Áú»¢¶Ä²© 4.0 Áú»¢¶Ä²© 4.2 Áú»¢¶Ä²© 4.4 Áú»¢¶Ä²© 5.0 Áú»¢¶Ä²© 5.2 Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Node-based distributed monitoring removed. |
| 2.0.x | For: Áú»¢¶Ä²© 2.2 Áú»¢¶Ä²© 2.4 Áú»¢¶Ä²© 3.0 Áú»¢¶Ä²© 3.2 Áú»¢¶Ä²© 3.4 Áú»¢¶Ä²© 4.0 Áú»¢¶Ä²© 4.2 Áú»¢¶Ä²© 4.4 Áú»¢¶Ä²© 5.0 Áú»¢¶Ä²© 5.2 Áú»¢¶Ä²© 5.4 Áú»¢¶Ä²© 6.0 Áú»¢¶Ä²© 6.2 Áú»¢¶Ä²© 6.4 |
Minimum required PHP version upped from 5.1.6 to 5.3.0. Case-sensitive MySQL database required for proper server work; character set utf8 and utf8_bin collation is required for Áú»¢¶Ä²© server to work properly with MySQL database. See database creation scripts. 'mysqli' PHP extension required instead of 'mysql'. |