]> git.saurik.com Git - redis.git/blame - 00-RELEASENOTES
Fix compilation on Linux kernels or glibc versions lacking sync_file_range().
[redis.git] / 00-RELEASENOTES
CommitLineData
c2513ecb 1Redis 2.6 release notes
69396249 2=======================
c2513ecb 3
69396249 4** IMPORTANT ** Check the 'Migrating from 2.4 to 2.6' section at the end of
5 this file for information about what changed between 2.4 and
6 2.6 and how this may affect your application.
c2513ecb 7
1a3e9d95 8--------------------------------------------------------------------------------
9Upgrade urgency levels:
10
11LOW: No need to upgrade unless there are new features you want to use.
12MODERATE: Program an upgrade of the server, but it's not urgent.
44038626 13HIGH: There is a critical bug that may affect a subset of users. Upgrade!
1a3e9d95 14CRITICAL: There is a critical bug affecting MOST USERS. Upgrade ASAP.
15--------------------------------------------------------------------------------
16
5eec376c 17---[ Redis 2.6.0 ]
18
19* [BUGFIX] Allow AUTH when server is in -BUSY state because of a slow script.
20* [BUGFIX] MULTI/EXEC flow now makes sense when observed in MONITOR
21* [BUGFIX] SCRIPT KILL now uses different error prefixes for different errors.
22* [BUGFIX] Default memory limit for 32bit archs lowered from 3.5 to 3 GB.
23* [BUGFIX] redis-check-dump is now compatible with RDB files generated by 2.6.
24* [IMPROVED] New field in INFO: slave_read_only.
25
500dddc2 26---[ Redis 2.5.14 (2.6 Release Candidate 8) ]
27
28* [BUGFIX] Fixed compilation on FreeBSD.
29* [IMPROVED] SRANDMEMBER <count> that returns multiple random elements.
30* [IMPROVED] Sentinel backported to 2.6. It will be taken in sync with 2.8.
31* [IMPROVED] Helper function for scripting to return errors and status replies.
32* [IMPROVED] SORT by nosort [ASC|DESC] uses sorted set elements ordering.
33* [BUGFIX] Better resistence to system clock skew.
34* [IMPROVED] Warn the user when the configured maxmemory seems odd.
35* [BUGFIX] Hashing function is now murmurhash2 for security purposes.
36* [IMPROVED] Install script no longer uses a template but redis.conf itself.
37
44038626 38---[ Redis 2.5.13 (2.6 Release Candidate 7) ]
39
40UPGRADE URGENCY: HIGH
41
42* [BUGFIX] Theoretical bug in ziplist fixed.
43* [BUGFIX] Better out of memory handling (Log produced in log file).
44* [BUGFIX] Incrementally flush RDB file on slave side while performing the
45 first synchronization with the master. This makes Redis less
46 blocking in environments where disk I/O is slow.
47* [BUGFIX] Don't crash with Lua's redis.call() without arguments.
48* [BUGFIX] Don't crash after a big number of Lua calls on 32 bit systems
49 because of a failed assertion.
50* [BUGFIX] Fix SORT behaviour when called from scripting.
51* [BUGFIX] Adjust slave PING period accordingly to REDIS_HZ define.
52* [BUGFIX] BITCOUNT: fix crash on overflowing arguments.
53* [BUGFIX] Return an error when SELECT argument is not an integer.
54* [BUGFIX] Blocking operations on lists were completely reimplemented for
55 correctness. Now blocking list ops and pushes originated from
56 Lua scripts will play well together and will be replicated
57 and transmitted to the AOF correctly.
58* [IMPROVED] Send async PING before starting replication to avoid blocking if
59 master allows us to connect but it is actually not able to reply.
60* [IMPROVED] Support slave-priority for Redis Sentinel.
61* [IMPROVED] Hiredis library updated.
62
73d3e875 63---[ Redis 2.5.12 (2.6 Release Candidate 6) ]
64
65UPGRADE URGENCY: MODERATE.
66
67* [BUGFIX] Fixed a timing attack on AUTH (Issue #560).
68* [BUGFIX] Don't assume that "char" is signed.
69* [BUGFIX] Check that we have connection before enabling pipe mode.
70* [BUGFIX] Use the optimized version of the function to convert a double to
71 its string representation. Compilation was disabled because of
72 a typo in the #if statement.
73* [IMPROVED} REPLCONF internal command introduced, now INFO shows slaves with
74 correct port numbers. This makes 2.5.12 Redis Sentinel compatible.
75* [IMPROVED] Truncate short write from the AOF for a cleaner restart. On short
76 writes (for instance out of space) Redis will now try to remove
77 the half-written data so that the next restart will work without
78 the need for the "redis-check-aof" utility.
79* [IMPROVED] New in INFO: aof_last_bgrewrite_status
80* [IMPROVED] Allow Pub/Sub in contexts where other commands are blocked.
81* [BUGFIX] mark fd as writable when EPOLLERR or EPOLLHUP is returned by
82 epoll_wait.
83
0c9cf452 84---[ Redis 2.5.11 (2.6 Release Candidate 5) ]
85
86UPGRADE URGENCY: HIGH.
87
88* [BUGFIX] Fixed Hash corruption when loading an RDB file generated by
89 previous versions of Redis that encoded hashes using
90 a different ziplist encoding format for small integers.
91 All the fileds that are integers in the range 0-255 may not
92 be recognized, or duplicated un updates, causing a crash
93 when the ziplist is converted to a real hash. (Issue #547).
94* [BUGFIX] Fixed the count of memory used by output buffers in the
95 setDeferredMultiBulkLength() function.
96
1a3e9d95 97---[ Redis 2.5.10 (2.6 Release Candidate 4) ]
98
99UPGRADE URGENCY: HIGH.
100
101* [BUGFIX] Allow PREFIX to be overwritten on "make install".
102* [BUGFIX] Run the test with just one client if the computer is slow.
103* [BUGFIX] Event port support in our event driven libray.
104* [BUGFIX] Jemalloc updated to 3.0.0. This fixes a possibly AOF rewrite issue.
105 See https://github.com/antirez/redis/issues/504 for info.
106* [BUGFIX] Fixed issue #516: ZINTERSTORE / ZUNIONSTORE with mixed sets/zsets.
107* [BUGFIX] Set fd to writable when poll(2) detects POLLERR or POLLHUP event.
108* [BUGFIX] Fixed RESTORE hash failure (Issue #532).
109* [IMPROVED] Allow an AOF rewrite buffer > 2GB (Related to issue #504).
110* [IMPROVED] Server cron function frequency is now configurable (REDIS_HZ).
111* [IMPROVED] Better, less blocking expired keys collection algorithm.
112* [FEATURE] New commands: BITOP and BITCOUNT.
113* [FEATURE] redis-cli --pipe for mass import.
114
184b8e78 115What's new in Redis 2.5.9 (aka 2.6 Release Candidate 3)
116=======================================================
117
118UPGRADE URGENCY: critical, upgrade ASAP.
119
120* [BUGFIX] Fix for issue #500 (https://github.com/antirez/redis/pull/500).
121 Redis 2.6-RC1 and RC2 may corrupt ziplist-encoded sorted sets
122 produced by Redis 2.4.x.
af2455be 123* [BUGFIX] Fixed several bugs in init.d script.
124* [BUGFIX] syncio.c functions modified for speed and correctness. On osx
125 (and possibly other BSD-based systems) the slave would block on
126 replication to send the SYNC command when the master was not
127 available. This is fixed now, but was not affecting Linux installs.
8afa5b70 128* Now when slave-serve-stale-data is set to yes and the master is down, instead
af2455be 129 of reporting a generic error Redis replies with -MASTERDOWN.
184b8e78 130
0f077815 131What's new in Redis 2.5.8 (aka 2.6 Release Candidate 2)
132=======================================================
133
134UPGRADE URGENCY: high for all the users of the KEYS command, otherwise low.
135
136* [BUGFIX] Fix for KEYS command: if the DB contains keys with expires the KEYS
137 command may return the wrong output, having duplicated or missing
138 keys. See issue #487 and #488 on github for details.
139
7c5d96d9 140What's new in Redis 2.5.7 (aka 2.6 Release Candidate 1)
141=======================================================
142
143UPGRADE URGENCY: upgrade not recommended because this is an RC release.
144
145* This is the first release candidate for Redis 2.6. We are not aware of
146 bugs, but part of this code is young and was never tested in production
147 environments, so handle with care.
c2513ecb 148
7c5d96d9 149An overview of new features and changes in Redis 2.6.x
150======================================================
c2513ecb 151
152* Server side Lua scripting, see http://redis.io/commands/eval
153* Virtual Memory removed (was deprecated in 2.4)
154* Hardcoded limits about max number of clients removed.
155* AOF low level semantics is generally more sane, and especially when used
156 in slaves.
157* Milliseconds resolution expires, also added new commands with milliseconds
158 precision (PEXPIRE, PTTL, ...).
748f206e 159* Better memory usage for "small" lists, ziplists and hashes when fields or
160 values contain small integers.
b330de57 161* Read only slaves.
9a8d51ad 162* New bit opeations: BITCOUNT and BITOP commands.
518e7202 163* Clients max output buffer soft and hard limits. You can specifiy different
c2513ecb 164 limits for different classes of clients (normal,pubsub,slave).
9a8d51ad 165* More incremental (less blocking) expired keys collection algorithm, in
166 practical terms this means that Redis is more responsive when a very
167 big number of keys expire about at the same time.
c2513ecb 168* AOF is now able to rewrite aggregate data types using variadic commands,
169 often producing an AOF that is faster to save, load, and is smaller in size.
170* Every redis.conf directive is now accepted as a command line option for the
171 redis-server binary, with the same name and number of arguments.
172* Hash table seed randomization for protection against collisions attacks.
173* Performances improved when writing large objects to Redis.
748f206e 174* Integrated memory test, see redis-server --test-memory.
175* INCRBYFLOAT and HINCRBYFLOAT commands.
176* New DUMP, RESTORE, MIGRATE commands (back ported from Redis Cluster to 2.6).
177* CRC64 checksump in RDB files.
178* Better MONITOR output and behavior (now commands are logged before execution).
179* "Software Watchdog" feature to debug latency issues.
c2513ecb 180* Significant parts of the core refactored or rewritten. New internal APIs
181 and core changes allowed to develop Redis Cluster on top of the new code,
182 however for 2.6 all the cluster code was removed, and will be released with
183 Redis 3.0 when it is more complete and stable.
184* Redis ASCII art logo added at startup.
185* Crash report on memory violation or failed asserts improved significantly
186 to make debugging of hard to catch bugs simpler.
187* redis-benchmark improvements: ability to run selected tests,
188 CSV output, faster, better help.
189* redis-cli improvements: --eval for comfortable development of Lua scripts.
190* SHUTDOWN now supports two optional arguments: "SAVE" and "NOSAVE".
191* INFO output split into sections, the command is now able to just show
192 pecific sections.
193* New statistics about how many time a command was called, and how much
194 execution time it used (INFO commandstats).
195* More predictable SORT behavior in edge cases.
748f206e 196* Better support for big endian and *BSD systems.
197* Build system improved.
c2513ecb 198
69396249 199Migrating from 2.4 to 2.6
200=========================
201
202Redis 2.4 is mostly a strict subset of 2.6. However there are a few things
203that you should be aware of:
204
205* You can't use .rdb and AOF files generated with 2.6 into a 2.4 instance.
013189e7 206* 2.6 slaves can be attached to 2.4 masters, but not the contrary, and only
69396249 207 for the time needed to perform the version upgrade.
208
209There are also a few API differences, that are unlikely to cause problems,
210but it is better to keep them in mind:
211
212* SORT now will refuse to sort in numerical mode elements that can't be parsed
213 as numbers.
214* EXPIREs now all have millisecond resolution (but this is very unlikely to
215 break code that was not conceived exploting the previous resolution error
216 in some way.)
217* INFO output is a bit different now, and contains empty lines and comments
218 starting with '#'. All the major clients should be already fixed to work
219 with the new INFO format.
220* Slaves are only read-only by default (but you can change this easily
221 setting the "slave-read-only" configuration option to "no" editing your
222 redis.conf or using CONFIG SET.
223
224The following INFO fields were renamed for consistency:
225
226 changes_since_last_save -> rdb_changes_since_last_save
227 bgsave_in_progress -> rdb_bgsave_in_progress
228 last_save_time -> rdb_last_save_time
229 last_bgsave_status -> rdb_last_bgsave_status
230 bgrewriteaof_in_progress -> aof_rewrite_in_progress
231 bgrewriteaof_scheduled -> aof_rewrite_scheduled
232
233The following redis.conf and CONFIG GET / SET parameters changed:
234
235 * hash-max-zipmap-entries, now replaced by hash-max-ziplist-entries
236 * hash-max-zipmap-value, now replaced by hash-max-ziplist-value
237 * glueoutputbuf option was now completely removed (was deprecated)
238
c2513ecb 239--------------------------------------------------------------------------------
240
241Credits: Where not specified the implementation and design are done by
242Salvatore Sanfilippo and Pieter Noordhuis. Thanks to VMware for making all
243this possible. Also many thanks to all the other contributors and the amazing
244community we have.
245
246See commit messages for more credits.
247
248Cheers,
249Salvatore