opendev/gerrit
Code Issues Proposed changes

Add warning about Bouncy Castle Crypto library update in release notes

Browse Source 
Bouncy Castle was upgraded in Ie2b22328 which was first included in
Gerrit version 2.8.5

The new library versions are downloaded during site init, but if the
old library versions are still present in the `lib` folder, it causes
a startup failure (see issue linked below).

The failure can be resolved by removing the old library versions from
the `lib` folder. Add a warning about this in all the release notes
from version 2.9 onwards.

Bug: Issue 3084
Change-Id: Ib6152de9978c57bb7a1d5e147e14ab0ceb464418
This commit is contained in:
David Pursehouse 2015-02-27 16:37:38 +09:00
parent 0e0cc1732f
commit 610f597531
7 changed files with 47 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
ReleaseNotes/ReleaseNotes-2.10.txt
View File

@ -37,6 +37,12 @@ later, you may ignore this warning and upgrade directly to 2.10.x.
*WARNING:* The `auth.allowGoogleAccountUpgrade` setting is no longer supported.
*WARNING:* When upgrading from version 2.8.4 or older with a site that uses
Bouncy Castle Crypto, new versions of the libraries will be downloaded. The old
libraries should be manually removed from site's `lib` folder to prevent the
startup failure described in
link:https://code.google.com/p/gerrit/issues/detail?id=3084[Issue 3084].
Release Highlights
------------------

6
ReleaseNotes/ReleaseNotes-2.11.txt
View File

@ -21,6 +21,12 @@ Important Notes
2.9) and then to 2.11.x. If you are upgrading from 2.8.x or later, you may ignore
this warning and upgrade directly to 2.11.x.
*WARNING:* When upgrading from version 2.8.4 or older with a site that uses
Bouncy Castle Crypto, new versions of the libraries will be downloaded. The old
libraries should be manually removed from site's `lib` folder to prevent the
startup failure described in
link:https://code.google.com/p/gerrit/issues/detail?id=3084[Issue 3084].
*WARNING:* The 'Generate HTTP Password' capability has been
link:#remove-generate-http-password-capability[removed].

6
ReleaseNotes/ReleaseNotes-2.9.1.txt
View File

@ -7,6 +7,12 @@ Download:
link:https://gerrit-releases.storage.googleapis.com/gerrit-2.9.1.war[
https://gerrit-releases.storage.googleapis.com/gerrit-2.9.1.war]
*WARNING:* When upgrading from version 2.8.4 or older with a site that uses
Bouncy Castle Crypto, new versions of the libraries will be downloaded. The old
libraries should be manually removed from site's `lib` folder to prevent the
startup failure described in
link:https://code.google.com/p/gerrit/issues/detail?id=3084[Issue 3084].
Bug Fixes
---------

6
ReleaseNotes/ReleaseNotes-2.9.2.txt
View File

@ -22,6 +22,12 @@ be suppressed in batch mode.
java -jar gerrit.war init -d site_path
----
*WARNING:* When upgrading from version 2.8.4 or older with a site that uses
Bouncy Castle Crypto, new versions of the libraries will be downloaded. The old
libraries should be manually removed from site's `lib` folder to prevent the
startup failure described in
link:https://code.google.com/p/gerrit/issues/detail?id=3084[Issue 3084].
Bug Fixes
---------

6
ReleaseNotes/ReleaseNotes-2.9.3.txt
View File

@ -22,6 +22,12 @@ be suppressed in batch mode.
java -jar gerrit.war init -d site_path
----
*WARNING:* When upgrading from version 2.8.4 or older with a site that uses
Bouncy Castle Crypto, new versions of the libraries will be downloaded. The old
libraries should be manually removed from site's `lib` folder to prevent the
startup failure described in
link:https://code.google.com/p/gerrit/issues/detail?id=3084[Issue 3084].
Bug Fixes
---------

6
ReleaseNotes/ReleaseNotes-2.9.4.txt
View File

@ -22,6 +22,12 @@ be suppressed in batch mode.
java -jar gerrit.war init -d site_path
----
*WARNING:* When upgrading from version 2.8.4 or older with a site that uses
Bouncy Castle Crypto, new versions of the libraries will be downloaded. The old
libraries should be manually removed from site's `lib` folder to prevent the
startup failure described in
link:https://code.google.com/p/gerrit/issues/detail?id=3084[Issue 3084].
Bug Fixes
---------

15
ReleaseNotes/ReleaseNotes-2.9.txt
View File

@ -30,6 +30,17 @@ Important Notes
java -jar gerrit.war reindex --recheck-mergeable -d site_path
----
*WARNING:* Upgrading to 2.9.x requires the server be first upgraded to 2.1.7 (or
a later 2.1.x version), and then to 2.9.x. If you are upgrading from 2.2.x.x or
later, you may ignore this warning and upgrade directly to 2.9.x.
*WARNING:* When upgrading from version 2.8.4 or older with a site that uses
Bouncy Castle Crypto, new versions of the libraries will be downloaded. The old
libraries should be manually removed from site's `lib` folder to prevent the
startup failure described in
link:https://code.google.com/p/gerrit/issues/detail?id=3084[Issue 3084].
*WARNING:* Support for query via the SQL index is removed. The usage of
a secondary index is now mandatory.
@ -86,10 +97,6 @@ The interactive init asks whether the plugin should be upgraded:
The plugin can be upgraded manually by copying the new plugin jar into
the site's `plugins` folder.
*WARNING:* Upgrading to 2.9.x requires the server be first upgraded to 2.1.7 (or
a later 2.1.x version), and then to 2.9.x. If you are upgrading from 2.2.x.x or
later, you may ignore this warning and upgrade directly to 2.9.x.
Release Highlights
------------------