manual:installation:upgrade_notes_240

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Last revision Both sides next revision
manual:installation:upgrade_notes_240 [2014/08/26 07:36]
arturs.galapovs [Script result changes] Added previous behavior description
manual:installation:upgrade_notes_240 [2016/03/01 11:28]
asaveljevs [Converting triggers to the new syntax] unary minus non-associative
Line 1: Line 1:
-<note warning>​Zabbix 2.4.0 is not released yet.</​note>​ +==== Upgrade notes for 2.4.0 ====
- +
-==== -#7 Upgrade notes for 2.4.0 ====+
  
 === Node-based distributed monitoring removed === === Node-based distributed monitoring removed ===
Line 11: Line 9:
 To maintain uniqueness of data from non-local nodes, all the fields will be prefixes with N<​nodeid>​_. If the length of the new value exceeds max field size, it will be trimmed. Highly unlikely, but if the new value already exists in the database, the situation will be caught by a check on duplicates. Global macros will be processed in a special way by adding N<​nodeid>​_ after the dollar sign, for example, {$N123_MACRO}. To maintain uniqueness of data from non-local nodes, all the fields will be prefixes with N<​nodeid>​_. If the length of the new value exceeds max field size, it will be trimmed. Highly unlikely, but if the new value already exists in the database, the situation will be caught by a check on duplicates. Global macros will be processed in a special way by adding N<​nodeid>​_ after the dollar sign, for example, {$N123_MACRO}.
  
 +Support of the "node watcher"​ second parameter has been removed from the ''​zabbix[process]''​ internal item. This item has also been removed from //Template App Zabbix Server//. In order to fix it, either manually delete the item or import the new template and mark //Delete missing// option for items.
 === Handling automatically discovered hosts === === Handling automatically discovered hosts ===
  
Line 27: Line 26:
 The formatting of JSON objects (with tabs and new lines) has been removed, which allows the traffic to be reduced by 20-30% when data is sent between Zabbix services. Additionally,​ the escaping of forward slash or solidus (/) has also been removed. JSON, formatted as in the previous versions of Zabbix, would still be accepted as valid. The formatting of JSON objects (with tabs and new lines) has been removed, which allows the traffic to be reduced by 20-30% when data is sent between Zabbix services. Additionally,​ the escaping of forward slash or solidus (/) has also been removed. JSON, formatted as in the previous versions of Zabbix, would still be accepted as valid.
  
-=== Changes regarding multibyte string support === 
- 
-Zabbix frontend now displays fatal error if mbstring PHP functions are not enabled. There are no string wrapper functions anymore; they have been replaced by string and/or mbstring functions accordingly. Additionally,​ the ''​mbstring.func_overload''​ option from php.ini is required to be off, and a warning will be displayed in //Status of Zabbix// if it is enabled. 
- 
-=== Dropping green status icons in item list === 
- 
-Previously, green status icons were displayed in the last //Error// column of the item list, for error-free items, which could be misunderstood as if, on the contrary, the items had errors. Now the green icons are displayed no more and, additionally,​ the column is renamed to //Info//. For items with problems, as before, a red square icon is displayed in this column. 
- 
-The same change is applied to the trigger list as well. 
 === Log file handling === === Log file handling ===
  
-Zabbix agent start up log level was changed in order to log information about started agent processes at DebugLevel set to 0. Now, at DebugLevel=0 only basic information is printed to the logfile/​syslog. For agents it is Zabbix version, used config file, started/​stopped Zabbix processes. For proxy and server - Zabbix version, enabled features, used config file, DB version, started/​stopped Zabbix processes. The logging for Zabbix agent is also consistent on Linux and Windows machines now.+Now, at DebugLevel=0 only basic information is printed to the logfile/​syslog. For agents it is Zabbix version, used config file, started/​stopped Zabbix processes. For proxy and server - Zabbix version, enabled features, used config file, DB version, started/​stopped Zabbix processes. The logging for Zabbix agent is also consistent on Unix and Windows machines now.
  
 === Daemon changes === === Daemon changes ===
Line 46: Line 36:
 Server and proxy now refuse to start if **StartPollersUnreachable** configuration parameter is 0, but regular, IPMI or Java pollers are started. Otherwise, hosts that become unreachable would never be checked again. Server and proxy now refuse to start if **StartPollersUnreachable** configuration parameter is 0, but regular, IPMI or Java pollers are started. Otherwise, hosts that become unreachable would never be checked again.
  
 +Proxy now refuses to start with a server database. In some older versions a proxy could be started with a server database (e.g. by mistake) and somehow it worked. After upgrading to Zabbix 2.4 this is not the case anymore. Follow [[manual:​appendix:​install:​db_scripts|instructions]] to create a new, valid proxy database, if necessary. A similar check has been added to server to prevent starting it with a proxy database.
 +
 +Support for PHP mutexes has been removed on the server side due to licensing issues. While it was not recommended to use Zabbix server and frontend with SQLite3 database before, this change makes it even less recommended,​ because simultaneous database access with Zabbix server and frontend may now corrupt the database. Note that using Zabbix proxy with SQLite3 database is still a perfectly valid solution.
 +
 +Carriage return symbols (CR) are not stripped from notification messages anymore. Any custom scripts used to process action messages must be updated to support the new newline format (CRLF).
 === Housekeeper changes === === Housekeeper changes ===
  
Line 52: Line 47:
 === Script result changes === === Script result changes ===
  
-User parameters, global scripts, system.run[] items and external checks return standard ​script output ​along with error output. ​Previously only standard ​output was returned. \\ //Note//: Windows ​agents had this functionality since 1.8.5+User parameters, global scripts, system.run[] items and external checks ​will now return standard ​error along with standard ​output. ​In the corner case of standard ​error as numeric value a numeric item will change state from NOTSUPPORTED to normal.\\ //Note//: Windows ​agent has this functionality since 1.8.5 
 + 
 +Empty result is now allowed for ''​system.run[]''​. ''​system.run''​ item configured with textual value type (character, log or text) will change state from unsupported to normal if the command returns empty result. 
 + 
 +=== Changes regarding multibyte string support === 
 + 
 +Zabbix frontend now displays fatal error if mbstring PHP functions are not enabled. There are no string wrapper functions anymore; they have been replaced by string and/or mbstring functions accordingly. Additionally,​ the ''​mbstring.func_overload''​ option from php.ini is required to be off, and a warning will be displayed in //Status of Zabbix// if it is enabled. 
 + 
 +=== Unified date and time format === 
 + 
 +Date and time format has been unified across Zabbix frontend according to the ISO 8601 standard of **YYYY-MM-DD hh:mm:ss**. The new format is implemented everywhere except graphs. 
 + 
 +=== Changes in latest data page === 
 + 
 +The latest data section no longer has the host and host group selection dropdowns. Instead, those two choices can be made within an expanded filter section, which can be used flexibly for displaying the exact set of items you want. 
 + 
 +=== Dropping green status icons in item list === 
 + 
 +Previously, green status icons were displayed in the last //Error// column of the item list, for error-free items, which could be misunderstood as if, on the contrary, the items had errors. Now the green icons are displayed no more and, additionally,​ the column is renamed to //Info//. For items with problems, as before, a red square icon is displayed in this column. 
 + 
 +The same change is applied to the trigger list as well. 
 + 
 +=== Graph palette changes === 
 + 
 +The default colour palette for graphs has been changed to use green colour first instead of red. Red will be used second. The bar report palette nr. 4 has also been slightly changed. This won't change existing custom graphs, but the colours will be different when creating new custom graphs. 
 + 
 +=== Converting triggers to the new syntax === 
 + 
 +The database upgrade patches will automatically convert the existing triggers to the [[manual:​introduction:​whatsnew240#​support_of_new_trigger_operators|new syntax]]. 
 + 
 +Note that along with the syntax change, unary **-** operator associativity has changed from right-associative to non-associative,​ meaning that **-(-1)** should now be used instead of **<​nowiki>​--</​nowiki>​1**. 
 +=== Dropped support of round-off constants === 
 + 
 +The descriptions of ZBX_UNITS_ROUNDOFF_THRESHOLD,​ ZBX_UNITS_ROUNDOFF_UPPER_LIMIT,​ ZBX_UNITS_ROUNDOFF_MIDDLE_LIMIT and ZBX_UNITS_ROUNDOFF_LOWER_LIMIT definitions have been removed from the documentation since their functionality no longer matches their intended purpose. They are still present in the code and any changes made to them will remain, but their modification may cause unexpected results.