xref: /redis-3.2.3/00-RELEASENOTES (revision 8a8fe56c)
1Redis 3.2 release notes
2=======================
3
4--------------------------------------------------------------------------------
5Upgrade urgency levels:
6
7LOW:      No need to upgrade unless there are new features you want to use.
8MODERATE: Program an upgrade of the server, but it's not urgent.
9HIGH:     There is a critical bug that may affect a subset of users. Upgrade!
10CRITICAL: There is a critical bug affecting MOST USERS. Upgrade ASAP.
11--------------------------------------------------------------------------------
12
13--[ Redis 3.2.0 RC2 (version 3.1.102) ] Release date: 25 jan 2016
14
15Upgrade urgency MODERATE: this release fixes important Redis Cluster bugs.
16
17* [FIX] Many fixes to MIGRATE multiple keys implementation. The command
18        could handle errors in a faulty way leading to crashes or other
19        unexpected behaviors. MIGRATE command refactoring.
20        (The analysis of the faulty conditions was conducted by
21         Kevin McGehee. The fix was developed by Salvatore Sanfilippo)
22* [FIX] A Redis Cluster node crash was fixed because of wrong handling of
23        node->slaveof pointers.
24        (Reported by JackyWoo, fixed by Salvatore Sanfilippo)
25* [FIX] Fix redis-trib rebalance when nodes need to be left empty because
26        the specified weight is zero.
27        (Reported by Shahar Mor, fixed by Salvatore Sanfilippo)
28* [FIX] MIGRATE: Never send -ASK redirections for MIGRATE when there are
29        open slots. Redis-trib and other cluster management utility must
30        always be free to move keys between nodes about open slots, in order
31        to reshard, fix the cluster configuration, and so forth.
32        (Salvatore Sanfilippo)
33* [FIX] Lua debugger crash when printing too deeply nested objects.
34        (Reported by Paul Kulchenko, fixed by Salvatore Sanfilippo)
35* [FIX] Redis-cli implementation of Lua debugging now allows to use the
36        SCRIPT DEBUG command directly, switching to debugging mode as needed.
37        (Reported by Paul Kulchenko, fixed by Salvatore Sanfilippo)
38* [FIX] Redis-trib is now able to fix more errors. A new CLUSTER subcommand
39        called BUMPEPOCH was introduced in order to support new modes
40        for the "fix" subcommand. (Salvatore Sanfilippo)
41* [NEW] Redis proctected mode: this feature improves Redis security and makes
42        harder to run Redis in a configuration that is unsecure because no
43        firewalling was used in order to protect Redis from external accesses.
44        See this Reddit post for more info: https://www.reddit.com/r/redis/comments/3zv85m/new_security_feature_redis_protected_mode/ (Salvatore Sanfilippo)
45* [NEW] Cluster/Sentinel tests now use OSX leak to perform leak detection
46        at the end of every unit. (Salvatore Sanfilippo)
47* [NEW] Detect and show server crashes during Cluster/Sentinel tests.
48        (Salvatore Sanfilippo)
49* [NEW] More reliable Cluster/Sentinel test becuase of timing errors and
50        -LOADING errors. (Salvatore Sanfilippo)
51
52--[ Redis 3.2.0 RC1 (version 3.1.101) ] Release date: 23 dec 2015
53
54This is the first release candidate of Redis 3.2. The changelog above shows
55what's new in this release. In the next of the following weeks we'll test
56in depth every feature and we'll release new RCs as bugs are discovered
57and fixed. Note that while 3.2 looks solid already, it contains many changes
58to its internals. It's still fresh code compared to 3.0.
59
60General changes:
61
62* [NEW] Lua scripts "effect replication". Makes possible to write scripts
63        with side effects, use of random commands, and so forth.
64        (Salvatore Sanfilippo)
65* [NEW] Lua scripts selective replication. Makes possible to replicate to
66        slaves and AOF only selected parts of a script. (Design by
67        Yossi Gottlieb and Salvatore Sanfilippo, implemented by Salvatore)
68* [NEW] Geo indexing support via GEOADD, GEORADIUS and other commands.
69        See http://redis.io/commands/geoadd for more information.
70        (Initially implemented in a fork of Redis called "Ardb".
71         Matt Stancliff "imported back" the work to Redis and created the
72         initial API and implementation. Salvatore Sanfilippo modified
73         the API and the implementation, fixed bugs, improved performances
74         and unified the duplicated code with t_zset.c)
75* [NEW] Lua debugger. A complete stepping, remote debugger for Lua scripts.
76        Video here: https://www.youtube.com/watch?v=IMvRfStaoyM
77        (Salvatore Sanfilippo with many feedbacks and testing from
78         Itamar Haber)
79* [NEW] SDS improvements for speed and maximum string length.
80        This makes Redis more memory efficient in different use cases.
81        (Design and implementation by Oran Agra, some additional work
82         by Salvatore Sanfilippo)
83* [NEW] Modify Jemalloc size classes to make certain Redis objects fit
84        better, improving memory efficiency. (Oran Agra)
85* [NEW] Better consistency behavior between masters and slaves for expired
86        keys. The slaves are only able to logically consider a key expired
87        even before receiving the `DEL` command from the master. This avoids
88        the delay there is sometimes between the natural expire of the key
89        and the moment the slave is notified. (Salvatore Sanfilippo)
90* [NEW] Support daemon supervision by upstart or systemd (Pierre-Yves Ritschard)
91* [NEW] New encoding for the List type: Quicklists. Very important memory
92        savings and storage space in RDB gains (up to 10x sometimes).
93        (Design and implementation by Matt Stancliff. RDB storage reworked
94         by Salvatore Sanfilippo)
95* [NEW] SPOP with optional count argument. (Initial implementation by
96        Alon Diamant, mostly reimplemented by Salvatore Sanfilippo for speed
97        and in order to make the replication of a this class of commands,
98        having as logical effect the execution of multiple commands, possible).
99* [NEW] Support for RDB AUX fields. Now RDB files contain additional info
100        like the creation date, version of Redis generating it and so forth.
101        (Salvatore Sanfilippo)
102* [NEW] Faster RDB loading via the RESIZEDB opcode to avoid useless hash tables
103        rehashings. (Salvatore Sanfilippo)
104* [NEW] HSTRLEN command. (@landmime and Salvatore Sanfilippo)
105* [NEW] CONFIG SET/GET implementations refactored, partially rewritten,
106        now exposing more config options. (Salvatore Sanfilippo)
107* [NEW] CLUSTER NODES major speedup. (Salvatore Sanfilippo)
108* [NEW] CLIENT KILL TYPE MASTER, to kill (disconnect) masters from slaves.
109        (Salvatore Sanfilippo)
110* [NEW] Jemalloc updated to 4.0.3 (Salvatore Sanfilippo)
111* [NEW] DEBUG RESTART/CRASH-AND-RECOVER [delay] (Salvatore Sanfilippo)
112* [NEW] CLIENT REPLY command implemented: ON, OFF and SKIP modes.
113        (Salvatore Sanfilippo)
114* [NEW] Crash report produced by Redis on crash improved. (Salvatore Sanfilippo)
115* [NEW] Better memory test on crash. (Salvatore Sanfilippo)
116
117Redis Cluster changes:
118
119All the Redis Cluster changes in 3.2 were backported to 3.0, so there is
120technically nothing new for now in this release. The most important things
121are:
122
123* Cluster rebalancing.
124* A pipelined MIGRATE command which is 10x faster and makes resharding
125  and rebalancing faster.
126* Improved replicas migration.
127* As a side effect of quicklists encoding (see above items), moving big
128  lists between nodes is now a lot faster.
129
130Redis Sentinel changes:
131
132* [NEW] Sentinel connection sharing. Makes Sentinels able to scale to
133        monitor many masters. (Salvatore Sanfilippo)
134* [NEW] New SENTINEL INFO-CACHE command. (Matt Stancliff)
135* More things backported to Redis 3.0 in the past, so no longer news of 3.2.
136
137Migrating from 3.0 to 3.2
138=========================
139
140Redis 3.0 is mostly a strict subset of 3.2, you should not have any problem
141upgrading your application from 3.0 to 3.2. However this is a list of small
142non-backward compatible changes introduced in the 3.2 release:
143
144* The default configuration file now binds to 127.0.0.1.
145* Slaves try to no longer expose stale data about already expired keys.
146* The RDB format changed. Redis 3.2 is still able to read 3.0 (and all the
147  past versions) files, but not the other way around.
148* Behavior on crash may be different. The crash log format changed and
149  the memory test executed is now different.
150
151--------------------------------------------------------------------------------
152
153Credits: For each release, a list of changes with the relative author is
154provided. Where not specified the implementation and design is done by
155Salvatore Sanfilippo. Thanks to Redis Labs for making all this possible.
156Also many thanks to all the other contributors and the amazing community
157we have.
158
159Commit messages may contain additional credits.
160
161Cheers,
162Salvatore
163