You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@pulsar.apache.org by mm...@apache.org on 2022/05/13 04:39:48 UTC
[pulsar] branch master updated: [improve][doc] Clarify documentation regarding M1 JDK and Managed Ledger (#15531)
This is an automated email from the ASF dual-hosted git repository.
mmerli pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/pulsar.git
The following commit(s) were added to refs/heads/master by this push:
new 6864b0ae552 [improve][doc] Clarify documentation regarding M1 JDK and Managed Ledger (#15531)
6864b0ae552 is described below
commit 6864b0ae5520e06b9d0fc5dcfa5a0a0a44feee87
Author: Asaf Mesika <as...@gmail.com>
AuthorDate: Fri May 13 07:39:41 2022 +0300
[improve][doc] Clarify documentation regarding M1 JDK and Managed Ledger (#15531)
* Reset to apache/master and applied my changes again
* Update site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md
Co-authored-by: Anonymitaet <50...@users.noreply.github.com>
* Update site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md
Co-authored-by: Anonymitaet <50...@users.noreply.github.com>
* Update site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md
Co-authored-by: Anonymitaet <50...@users.noreply.github.com>
* Update site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md
Co-authored-by: Anonymitaet <50...@users.noreply.github.com>
* Update site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md
Co-authored-by: Anonymitaet <50...@users.noreply.github.com>
* Update site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md
Co-authored-by: Anonymitaet <50...@users.noreply.github.com>
* Update site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md
Co-authored-by: Anonymitaet <50...@users.noreply.github.com>
Co-authored-by: Matteo Merli <mm...@apache.org>
Co-authored-by: Anonymitaet <50...@users.noreply.github.com>
---
site2/docs/concepts-messaging.md | 4 +--
.../version-2.10.0/getting-started-standalone.md | 38 ++++++++++++++++++++++
2 files changed, 40 insertions(+), 2 deletions(-)
diff --git a/site2/docs/concepts-messaging.md b/site2/docs/concepts-messaging.md
index 19464fec10c..4b7e0ed623e 100644
--- a/site2/docs/concepts-messaging.md
+++ b/site2/docs/concepts-messaging.md
@@ -113,13 +113,13 @@ With message chunking enabled, when the size of a message exceeds the allowed ma
#### Handle consecutive chunked messages with one ordered consumer
-The following figure shows a topic with one producer which publishes a large message payload in chunked messages along with regular non-chunked messages. The producer publishes message M1 in three chunks labeled M1-C1, M1-C2 and M1-C3. The broker stores all the three chunked messages in the managed-ledger and dispatches them to the ordered (exclusive/failover) consumer in the same order. The consumer buffers all the chunked messages in memory until it receives all the chunked messages, a [...]
+The following figure shows a topic with one producer which publishes a large message payload in chunked messages along with regular non-chunked messages. The producer publishes message M1 in three chunks labeled M1-C1, M1-C2 and M1-C3. The broker stores all the three chunked messages in the [managed-ledger](concepts-architecture-overview.md#managed-ledgers) and dispatches them to the ordered (exclusive/failover) consumer in the same order. The consumer buffers all the chunked messages in [...]
#### Handle interwoven chunked messages with one ordered consumer
-When multiple producers publish chunked messages into a single topic, the broker stores all the chunked messages coming from different producers in the same managed-ledger. The chunked messages in the managed-ledger can be interwoven with each other. As shown below, Producer 1 publishes message M1 in three chunks M1-C1, M1-C2 and M1-C3. Producer 2 publishes message M2 in three chunks M2-C1, M2-C2 and M2-C3. All chunked messages of the specific message are still in order but might not be [...]
+When multiple producers publish chunked messages into a single topic, the broker stores all the chunked messages coming from different producers in the same [managed-ledger](concepts-architecture-overview.md#managed-ledgers). The chunked messages in the managed-ledger can be interwoven with each other. As shown below, Producer 1 publishes message M1 in three chunks M1-C1, M1-C2 and M1-C3. Producer 2 publishes message M2 in three chunks M2-C1, M2-C2 and M2-C3. All chunked messages of the [...]
diff --git a/site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md b/site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md
index 925a64b1a93..97f6ee0f50b 100644
--- a/site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md
+++ b/site2/website/versioned_docs/version-2.10.0/getting-started-standalone.md
@@ -24,6 +24,44 @@ Currently, Pulsar is available for 64-bit **macOS**, **Linux**, and **Windows**.
> **Note**
> Broker is only supported on 64-bit JVM.
+#### Install JDK on M1
+In the current version, Pulsar uses a BookKeeper version which in turn uses RocksDB. RocksDB is compiled to work on x86 architecture and not ARM. Therefore, Pulsar can only work with x86 JDK. This is planned to be fixed in future versions of Pulsar.
+
+One of the ways to easily install an x86 JDK is to use [SDKMan](http://sdkman.io) as outlined in the following steps:
+
+1. Install [SDKMan](http://sdkman.io).
+
+ * Method 1: follow instructions on the SDKMan website.
+
+ * Method 2: if you have [Homebrew](https://brew.sh) installed, enter the following command.
+```shell
+brew install sdkman
+```
+2. Turn on Rosetta2 compatibility for SDKMan by editing `~/.sdkman/etc/config` and changing the following property from `false` to `true`.
+```properties
+sdkman_rosetta2_compatible=true
+```
+3. Close the current shell / terminal window and open a new one.
+4. Make sure you don't have any previously installed JVM of the same version by listing existing installed versions.
+```shell
+sdk list java|grep installed
+```
+
+Example output:
+```text
+ | >>> | 17.0.3.6.1 | amzn | installed | 17.0.3.6.1-amzn
+```
+
+If you have any Java 17 version installed, uninstall it.
+```shell
+sdk uinstall java 17.0.3.6.1
+```
+
+5. Install any Java versions greater than Java 8.
+```shell
+ sdk install java 17.0.3.6.1-amzn
+```
+
### Install Pulsar using binary release
To get started with Pulsar, download a binary tarball release in one of the following ways: