Update documentation to use RabbitMQ 3.9 RC

Author: acogoluegnes

README.adoc

@@ -65,7 +65,15 @@ To build the JAR file:
 Launch the broker:
 
 ----
-docker run -it --rm --name rabbitmq --network host pivotalrabbitmq/rabbitmq-stream
+docker run -it --rm --name rabbitmq -p 5552:5552 -p 5672:5672 \
+    -e RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS='-rabbitmq_stream advertised_host localhost -rabbit loopback_users "none"' \
+    rabbitmq:3.9-rc
+----
+
+Enable the stream plugin:
+
+----
+docker exec rabbitmq rabbitmq-plugins enable rabbitmq_stream
 ----
 
 Launch the tests:
@@ -74,7 +82,7 @@ Launch the tests:
 ./mvnw test -Drabbitmqctl.bin=DOCKER:rabbitmq
 ----
 
-=== Running Tests
+=== Running Tests with a Local Broker
 
 To launch the test suite (requires a local RabbitMQ node with stream plugin enabled):
 

src/docs/asciidoc/index.adoc

@@ -6,7 +6,7 @@ ifndef::sourcedir[:sourcedir: ../../main/java]
 :source-highlighter: prettify
 
 The RabbitMQ Stream Java Client is a Java library to communicate with
-the https://github.com/rabbitmq/rabbitmq-stream[RabbitMQ Stream Plugin].
+the https://rabbitmq.com/stream.html[RabbitMQ Stream Plugin].
 It allows creating and deleting streams, as well as publishing to and consuming from
 these streams. Learn more in the <<overview.adoc#stream-client-overview,the client overview>>.
 

src/docs/asciidoc/performance-tool.adoc

@@ -47,8 +47,10 @@ this is perfect for experimenting locally.
 .Running the broker and performance tool with the host network driver
 ----
 # run the broker
-docker run -it --rm --network host pivotalrabbitmq/rabbitmq-stream
-# open another terminal and run the performance tool
+docker run -it --rm --name rabbitmq --network host rabbitmq:3.9-rc
+# open another terminal and enable the stream plugin
+docker exec rabbitmq rabbitmq-plugins enable rabbitmq_stream
+# run the performance tool
 docker run -it --rm --network host pivotalrabbitmq/stream-perf-test
 ----
 
@@ -70,15 +72,21 @@ can be done by defining a network and running the containers in this network.
 # create a network
 docker network create stream-perf-test
 # run the broker
-docker run -it --rm --network stream-perf-test --name rabbitmq pivotalrabbitmq/rabbitmq-stream
-# open another terminal and run the performance tool
+docker run -it --rm --network stream-perf-test --name rabbitmq \
+    -e RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS='-rabbit loopback_users "none"' \
+    rabbitmq:3.9-rc
+# open another terminal and enable the stream plugin
+docker exec rabbitmq rabbitmq-plugins enable rabbitmq_stream
+# run the performance tool
 docker run -it --rm --network stream-perf-test pivotalrabbitmq/stream-perf-test \
     --uris rabbitmq-stream://rabbitmq:5552
 ----
 
 ==== With the Java Binary
 
-The Java binary is https://github.com/rabbitmq/rabbitmq-java-tools-binaries-dev/releases[on GitHub Release]:
+The Java binary is available on
+https://github.com/rabbitmq/rabbitmq-stream-java-client/releases[GitHub Release].
+https://github.com/rabbitmq/rabbitmq-java-tools-binaries-dev/releases[Snaphots] are available as well. To use the latest snapshot:
 
 ----
 wget https://github.com/rabbitmq/rabbitmq-java-tools-binaries-dev/releases/download/v-stream-perf-test-latest/stream-perf-test-latest.jar

src/docs/asciidoc/setup.adoc

@@ -1,8 +1,7 @@
 === Setting up RabbitMQ
 
-A RabbitMQ node with the stream plugin enabled is required. The easiest way
-to get up and running is to use Docker. It is also possible to use the
-generic Unix package.
+A RabbitMQ 3.9+ node with the stream plugin enabled is required. The easiest way
+to get up and running is to use Docker.
 
 ==== With Docker
 
@@ -22,14 +21,13 @@ This section shows how to start a broker instance for local development
 (the broker Docker container and the client application are assumed to run on the
 same host).
 
-The following command creates a one-time Docker container to run RabbitMQ
-with the stream plugin enabled:
+The following command creates a one-time Docker container to run RabbitMQ:
 
 .Running the stream plugin with Docker
 ----
 docker run -it --rm --name rabbitmq -p 5552:5552 \
-    -e RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS="-rabbitmq_stream advertised_host localhost" \
-    pivotalrabbitmq/rabbitmq-stream
+    -e RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS='-rabbitmq_stream advertised_host localhost -rabbit loopback_users "none"' \
+    rabbitmq:3.9-rc
 ----
 
 The previous command exposes only the stream port (5552), you can expose
@@ -38,16 +36,19 @@ ports for other protocols:
 .Exposing the AMQP 0.9.1 and management ports:
 ----
 docker run -it --rm --name rabbitmq -p 5552:5552 -p 5672:5672 -p 15672:15672 \
-    -e RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS="-rabbitmq_stream advertised_host localhost" \
-    pivotalrabbitmq/rabbitmq-stream
+    -e RABBITMQ_SERVER_ADDITIONAL_ERL_ARGS='-rabbitmq_stream advertised_host localhost -rabbit loopback_users "none"' \
+    rabbitmq:3.9-rc-management
 ----
 
 Refer to the official https://hub.docker.com/_/rabbitmq[RabbitMQ Docker image web page]
-to find out more about its usage. Make sure to use the `pivotalrabbitmq/rabbitmq-stream`
-image in the command line.
+to find out more about its usage.
 
-The `pivotalrabbitmq/rabbitmq-stream` Docker image is meant for development usage only. It does not
-support all the features of the official Docker image, like TLS.
+Once the container is started, **the stream plugin must be enabled**:
+
+.Enabling the stream plugin:
+----
+docker exec rabbitmq rabbitmq-plugins enable rabbitmq_stream
+----
 
 ===== With Docker Host Network Driver
 
@@ -57,26 +58,35 @@ this is perfect for experimenting locally.
 
 .Running RabbitMQ Stream with the host network driver
 ----
-docker run -it --rm --network host pivotalrabbitmq/rabbitmq-stream
+docker run -it --rm --name rabbitmq --network host rabbitmq:3.9-rc
+----
+
+Once the container is started, **the stream plugin must be enabled**:
+
+.Enabling the stream plugin:
+----
+docker exec rabbitmq rabbitmq-plugins enable rabbitmq_stream
 ----
 
-The command above will use the following ports: 5552 (for stream), 5672 (for AMQP),
-15672 (for management plugin).
+The container will use the following ports: 5552 (for stream) and 5672 (for AMQP.)
 
 [NOTE]
 .Docker Host Network Driver Support
 ====
 The host networking driver *only works on Linux hosts*.
 ====
 
-==== With the Generic Unix Package
+==== With a RabbitMQ Package Running on the Host
+
+Using a package implies installing Erlang.
 
-The generic Unix package requires https://www.rabbitmq.com/which-erlang.html[Erlang] to be installed.
+* Make sure to use https://github.com/rabbitmq/rabbitmq-server/releases[RabbitMQ 3.9 or more].
+* Follow the steps to
+https://rabbitmq.com/download.html[install Erlang and the appropriate package]
+* Enable the plugin `rabbitmq-plugins enable rabbitmq_stream`.
+* The stream plugin listens on port 5552.
 
-* Download the https://github.com/rabbitmq/rabbitmq-server-binaries-dev/releases[latest generic Unix `alpha-stream` archive].
-* Follow the https://www.rabbitmq.com/install-generic-unix.html[instructions to install the generic Unix package].
-* Enable the plugin `./rabbitmq-plugins enable rabbitmq_stream`.
-* Start the broker `./rabbitmq-server -detached`. This starts the stream listener on port 5552.
+Refer to the https://rabbitmq.com/stream.html[stream plugin documentation] for more information on configuration.
 
 === Dependencies