opendev/gerrit
Code Issues Proposed changes

2.9 release notes: Add warning about download commands

Browse Source 
Add a warning that reminds administrators that the download-commands
plugin must be installed for getting download-commands on the new
change screen. This warning was already included in the 2.8 release
notes but it makes sense to add this information to the 2.9 release
notes as well. Some people may not have been interested in the beta
version of the new change screen in 2.8 and hence they may have
ignored the need for installing the download commands plugin.

In addition provide more detailed instructions about how the
download-commands plugin can be installed.

Also add a warning about upgrading the plugin, since the 2.8 version
of the download-commands plugin doesn't work with Gerrit 2.9. Explain
that interactive init must be used to upgrade the plugin.

Change-Id: I2101e0a3974ddb8d1fdf198941edc99305351650
Signed-off-by: Edwin Kempin <edwin.kempin@sap.com>
This commit is contained in:
Edwin Kempin
2014-07-18 10:12:09 +02:00
committed by David Pursehouse
parent 1065a871cc
commit 8d5bbcd221
1 changed files with 49 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

50
ReleaseNotes/ReleaseNotes-2.9.txt
View File

@@ -30,9 +30,57 @@ Schema Change
java -jar gerrit.war reindex --recheck-mergeable -d site_path
----
*WARNING* Support for query via the SQL index is removed. The usage of
*WARNING:* Support for query via the SQL index is removed. The usage of
a secondary index is now mandatory.
*WARNING:* The new change screen only displays download commands if the
`download-commands` core plugin or any other plugin providing download
commands is installed. The `download-commands` plugin provides the
standard download schemes and commands. It is packaged together with
Gerrit and can be installed during the
link:https://gerrit-review.googlesource.com/Documentation/pgm-init.html[
site initialization]:
- Batch init:
+
By default the batch init does *not* install any core plugin. To
install the `download-commands` plugin during batch init, specify the
'--install-plugin download-commands' option:
+
----
$ java -jar gerrit-2.9.war init -d site --batch --install-plugin download-commands
----
- Interactive init:
+
There is a question whether the `download-commands` plugin should be
installed. To install the plugin the question must be answered with `y`:
+
----
Install plugin download-commands version v2.9 [y/N]? y
----
Pay attention that the 2.8 version of the `download-commands` plugin is
*not* compatible with Gerrit 2.9 and must be upgraded:
- Batch init:
+
With the batch init it is *not* possible to upgrade core plugins.
- Interactive init:
+
The interactive init asks whether the plugin should be upgraded:
+
----
Install plugin download-commands version v2.9 [y/N]? y
version v2.8.6.1 is already installed, overwrite it [y/N]? y
----
- Manual upgrade:
+
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.