This is an automated email from the ASF dual-hosted git repository.
lhotari 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 19a98625af5e Recommend ZK for Pulsar standalone (#871)
19a98625af5e is described below
commit 19a98625af5ef0bafaffe6f8ea60a9a9c7417819
Author: Kiryl Valkovich <visorte...@gmail.com>
AuthorDate: Tue Apr 2 15:34:48 2024 +0400
Recommend ZK for Pulsar standalone (#871)
---
docs/getting-started-docker-compose.md | 1 +
docs/getting-started-docker.md | 16 ++++++++++++++++
versioned_docs/version-3.0.x/getting-started-docker.md | 16 ++++++++++++++++
.../version-3.2.x/getting-started-docker-compose.md | 1 +
versioned_docs/version-3.2.x/getting-started-docker.md | 16 ++++++++++++++++
5 files changed, 50 insertions(+)
diff --git a/docs/getting-started-docker-compose.md
b/docs/getting-started-docker-compose.md
index 3f06c5d844fe..b3048013c5dd 100644
--- a/docs/getting-started-docker-compose.md
+++ b/docs/getting-started-docker-compose.md
@@ -114,6 +114,7 @@ services:
## Step 2: Create a Pulsar cluster
As preparation, create data directories and change the data directory
ownership to uid(10000) which is the default user id used in the Pulsar Docker
container.
+
```bash
sudo mkdir -p ./data/zookeeper ./data/bookkeeper
# this step might not be necessary on other than Linux platforms
diff --git a/docs/getting-started-docker.md b/docs/getting-started-docker.md
index 785fb8f9037e..302ebbf007eb 100644
--- a/docs/getting-started-docker.md
+++ b/docs/getting-started-docker.md
@@ -56,6 +56,22 @@ bin/pulsar standalone
</Tabs>
````
+:::tip
+
+You may encounter issues with the default RocksDB metadata store.
+
+We recommend you consider using the following environment variable to use
ZooKeeper as the metadata store:
+
+```
+...
+-e PULSAR_STANDALONE_USE_ZOOKEEPER=1 \
+...
+```
+
+Don't apply this fix for existing Pulsar standalone instances if you don't
want to loose your data.
+
+:::
+
If you want to change Pulsar configurations and start Pulsar, run the
following command by passing environment variables with the `PULSAR_PREFIX_`
prefix. See [default configuration
file](https://github.com/apache/pulsar/blob/e6b12c64b043903eb5ff2dc5186fe8030f157cfc/conf/standalone.conf)
for more details.
````mdx-code-block
diff --git a/versioned_docs/version-3.0.x/getting-started-docker.md
b/versioned_docs/version-3.0.x/getting-started-docker.md
index e8d706f0f7ca..361746f08988 100644
--- a/versioned_docs/version-3.0.x/getting-started-docker.md
+++ b/versioned_docs/version-3.0.x/getting-started-docker.md
@@ -16,6 +16,22 @@ For macOS, Linux, and Windows, run the following command to
start Pulsar within
docker run -it -p 6650:6650 -p 8080:8080 --mount
source=pulsardata,target=/pulsar/data --mount
source=pulsarconf,target=/pulsar/conf apachepulsar/pulsar:@pulsar:version@
bin/pulsar standalone
```
+:::tip
+
+You may encounter issues with the default RocksDB metadata store.
+
+We recommend you consider using the following environment variable to use
ZooKeeper as the metadata store:
+
+```
+...
+-e PULSAR_STANDALONE_USE_ZOOKEEPER=1 \
+...
+```
+
+Don't apply this fix for existing Pulsar standalone instances if you don't
want to loose your data.
+
+:::
+
If you want to change Pulsar configurations and start Pulsar, run the
following command by passing environment variables with the `PULSAR_PREFIX_`
prefix. See [default configuration
file](https://github.com/apache/pulsar/blob/e6b12c64b043903eb5ff2dc5186fe8030f157cfc/conf/standalone.conf)
for more details.
```shell
diff --git a/versioned_docs/version-3.2.x/getting-started-docker-compose.md
b/versioned_docs/version-3.2.x/getting-started-docker-compose.md
index 3f06c5d844fe..b3048013c5dd 100644
--- a/versioned_docs/version-3.2.x/getting-started-docker-compose.md
+++ b/versioned_docs/version-3.2.x/getting-started-docker-compose.md
@@ -114,6 +114,7 @@ services:
## Step 2: Create a Pulsar cluster
As preparation, create data directories and change the data directory
ownership to uid(10000) which is the default user id used in the Pulsar Docker
container.
+
```bash
sudo mkdir -p ./data/zookeeper ./data/bookkeeper
# this step might not be necessary on other than Linux platforms
diff --git a/versioned_docs/version-3.2.x/getting-started-docker.md
b/versioned_docs/version-3.2.x/getting-started-docker.md
index 785fb8f9037e..302ebbf007eb 100644
--- a/versioned_docs/version-3.2.x/getting-started-docker.md
+++ b/versioned_docs/version-3.2.x/getting-started-docker.md
@@ -56,6 +56,22 @@ bin/pulsar standalone
</Tabs>
````
+:::tip
+
+You may encounter issues with the default RocksDB metadata store.
+
+We recommend you consider using the following environment variable to use
ZooKeeper as the metadata store:
+
+```
+...
+-e PULSAR_STANDALONE_USE_ZOOKEEPER=1 \
+...
+```
+
+Don't apply this fix for existing Pulsar standalone instances if you don't
want to loose your data.
+
+:::
+
If you want to change Pulsar configurations and start Pulsar, run the
following command by passing environment variables with the `PULSAR_PREFIX_`
prefix. See [default configuration
file](https://github.com/apache/pulsar/blob/e6b12c64b043903eb5ff2dc5186fe8030f157cfc/conf/standalone.conf)
for more details.
````mdx-code-block
