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
manual:installation:upgrade_notes_240 [2014/07/18 07:41]
martins-v zabbix[proxy,proxy_name,lastaccess] always processed by zabbix server since 2.4.0
manual:installation:upgrade_notes_240 [2017/02/16 10:11]
martins-v note about case-sensitive MySQL database
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 10: Line 8:
  
 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.
 +
 +=== Case-sensitive MySQL database ===
 +
 +A case-sensitive MySQL database is required for proper server work. It is [[:​manual/​appendix/​install/​db_scripts#​mysql|recommended]] to create a case-sensitive MySQL database during new installations. If you created a MySQL database with the utf8 character set previously, in order to support case sensitiveness of stored data, you need to convert the charset to utf8_bin.
  
 === Handling automatically discovered hosts === === Handling automatically discovered hosts ===
  
 Hosts created by a network discovery rule will be deleted automatically if a discovered entity is not in the rule's IP range anymore. Hosts are deleted immediately. Hosts created by a network discovery rule will be deleted automatically if a discovered entity is not in the rule's IP range anymore. Hosts are deleted immediately.
 +
 +=== Internal items always processed ===
 +
 +Internal items previously were not processed if a host went into maintenance with 'no data collection'​. Now internal items are always processed by server or proxy regardless of host maintenance status.
  
 === Item changes === === Item changes ===
Line 22: Line 30:
  
 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.
 +
 +=== Log file handling ===
 +
 +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 ===
 +
 +Disabled hosts, items and triggers are stored in configuration cache now. Adjusting **CacheSize** configuration parameter might be needed due to increased memory usage.
 +
 +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 ===
 +
 +On ''​zabbix_server''​ and ''​zabbix_proxy''​ startup housekeeping is postponed for 30 minutes instead of running at once. This will lower startup load for both these processes.
 +
 +=== Script result changes ===
 +
 +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 === === 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. 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 === === Dropping green status icons in item list ===
Line 32: Line 73:
  
 The same change is applied to the trigger list as well. The same change is applied to the trigger list as well.
-=== 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.+=== Graph palette changes ===
  
-=== Daemon 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.
  
-Disabled hosts, items and triggers ​are stored in configuration cache now. Adjusting **CacheSize** configuration parameter might be needed due to increased memory usage.+=== 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.