2.9 release notes: Add warning about download commands
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>
diff --git a/ReleaseNotes/ReleaseNotes-2.9.txt b/ReleaseNotes/ReleaseNotes-2.9.txt
index 64195a5..9f2c920 100644
--- a/ReleaseNotes/ReleaseNotes-2.9.txt
+++ b/ReleaseNotes/ReleaseNotes-2.9.txt
@@ -30,9 +30,57 @@
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.
