blob: 1b732cbf19368f650a174be4e0084c37e010a565 [file] [log] [blame]
Yuxuan 'fishy' Wang4f5ad9d2016-05-03 16:18:58 -07001= Release notes for Gerrit 2.9.3
David Pursehouse312d4252014-12-08 09:49:43 +09002
3Download:
Shawn Pearce6d7ebc62015-06-12 16:34:42 -07004link:https://www.gerritcodereview.com/download/gerrit-2.9.3.war[
5https://www.gerritcodereview.com/download/gerrit-2.9.3.war]
David Pursehouse312d4252014-12-08 09:49:43 +09006
Yuxuan 'fishy' Wang4f5ad9d2016-05-03 16:18:58 -07007== Important Notes
David Pursehouse312d4252014-12-08 09:49:43 +09008
9*WARNING:* There are no schema changes from
10link:ReleaseNotes-2.9.2.html[2.9.2], but when upgrading from an existing site
11that was initialized with Gerrit version 2.6 to version 2.9.1 the primary key
12column order will be updated for some tables. It is therefore important to
13upgrade the site with the `init` program, rather than only copying the .war file
14over the existing one.
15
16It is recommended to run the `init` program in interactive mode. Warnings will
17be suppressed in batch mode.
18
19----
20 java -jar gerrit.war init -d site_path
21----
22
David Pursehouse610f5972015-02-27 16:37:38 +090023*WARNING:* When upgrading from version 2.8.4 or older with a site that uses
24Bouncy Castle Crypto, new versions of the libraries will be downloaded. The old
25libraries should be manually removed from site's `lib` folder to prevent the
26startup failure described in
27link:https://code.google.com/p/gerrit/issues/detail?id=3084[Issue 3084].
28
Yuxuan 'fishy' Wang4f5ad9d2016-05-03 16:18:58 -070029== Bug Fixes
David Pursehouse312d4252014-12-08 09:49:43 +090030
31*Downgrade SSHD to 0.9.0-4-g5967cfd*
32
33In Gerrit version 2.9.2 SSHD was upgraded to 0.13.0 which included a fix for
34link:https://issues.apache.org/jira/browse/SSHD-348[SSHD-348 (SSH thread pool
35exhaustion)].
36
37It turned out that SSHD 0.13.0 still suffers from this issue, which causes
38problems for users of the stream-events in Gerrit 2.9.2.
39
40SSHD 0.9.0 is known to be free from this particular issue, but we cannot
41downgrade to that version because it includes some other known issues:
42
43* link:https://issues.apache.org/jira/browse/SSHD-254[SSHD-254 ('authenticated
44with partial success' error)]
45* link:https://issues.apache.org/jira/browse/SSHD-330[SSHD-330 (sporadic
46handshake failures)].
47
48SSHD version 0.9.0-4-g5967cfd is based on 0.9.0 and includes fixes for SSHD-254
49and SSHD-330.
50
51Due to the downgrade of SSHD, the following libraries are also downgraded:
52
53* Bouncycastle from 1.51 to 1.49
54* Mina Core from 2.0.8 to 2.0.7