(pulsar-site) branch main updated: [improve][doc] Improve the Pulsar release verify doc (#740)

[ti...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

tison pushed a commit to branch main
in repository https://gitbox.apache.org/repos/asf/pulsar-site.git


The following commit(s) were added to refs/heads/main by this push:
     new 2fd134960506 [improve][doc] Improve the Pulsar release verify doc (#740)
2fd134960506 is described below

commit 2fd134960506e51b53a508bfcea09ec1c9da2d78
Author: Penghui Li <pe...@apache.org>
AuthorDate: Mon Nov 27 16:33:50 2023 +0800

    [improve][doc] Improve the Pulsar release verify doc (#740)
---
 contribute/validate-release-candidate.md | 47 ++++++++++++++++++++++++++------
 1 file changed, 38 insertions(+), 9 deletions(-)

diff --git a/contribute/validate-release-candidate.md b/contribute/validate-release-candidate.md
index 8a2ef6a8502d..c6108e976d28 100644
--- a/contribute/validate-release-candidate.md
+++ b/contribute/validate-release-candidate.md
@@ -13,21 +13,30 @@ Download the server distribution `apache-pulsar-<release>-bin.tar.gz` and extrac
 
 ```shell
 cd apache-pulsar-<release>
-mkdir connectors
 ```
 
-Download the Pulsar IO Connector files:
+Check the bookkeeper libs are complied on Linux:
 
+```shell
+unzip -t ./org.apache.bookkeeper-circe-checksum-*.jar | grep lib
+unzip -t ./org.apache.bookkeeper-cpu-affinity-*.jar | grep lib
 ```
-pulsar-io-aerospike-<release>.nar
-pulsar-io-cassandra-<release>.nar
-pulsar-io-kafka-<release>.nar
-pulsar-io-kinesis-<release>.nar
-pulsar-io-rabbitmq-<release>.nar
-pulsar-io-twitter-<release>.nar
+
+The output should look like:
+
+```shell
+testing: lib/                     OK
+testing: lib/libcirce-checksum.so   OK
+testing: lib/                     OK
+testing: lib/libcpu-affinity.so   OK
 ```
 
-and place them in the `connectors` directory.
+Download the Cassandra connector:
+
+```shell
+mkdir connectors
+mv pulsar-io-cassandra-<release>.nar connectors
+```
 
 Download the `*.asc` file and verify the GPG signature:
 
@@ -35,6 +44,20 @@ Download the `*.asc` file and verify the GPG signature:
 gpg --verify apache-pulsar-<release>-bin.tar.gz.asc
 ```
 
+### Download And Verify the source tarball
+
+Before you start to validate the source tarball, make sure you have installed these software:
+
+- JDK 17 (for Pulsar version >= 2.11) or JDK 11 (for earlier versions)
+- Maven 3.8.6 or later
+
+Download the source tarball and extract it. The extracted files are in a directory called `apache-pulsar-<release>-src`
+
+```shell
+cd apache-pulsar-<release>-src
+mvn clean install -DskipTests
+```
+
 ### Validate Pub/Sub and Java Functions
 
 #### Standalone service
@@ -508,6 +531,12 @@ bin/pulsar-admin sink delete --tenant public --namespace default --name cassandr
 # "Deleted successfully"
 ```
 
+9. Stop the Cassandra container
+
+```shell
+docker stop cassandra
+```
+
 ### Validate Stateful Functions
 
 Since Pulsar 2.1 release, Pulsar enables bookkeeper table service for stateful Pulsar functions (as a developer preview).