Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
1 change: 0 additions & 1 deletion antora.yml
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,6 @@ asciidoc:
bookkeeper-short: 'BookKeeper'
zookeeper-reg: 'Apache ZooKeeper(TM)'
zookeeper-short: 'ZooKeeper'
crd: 'custom resource definition (CRD)'

# Required for include::common partials that are shared with Astra Streaming
web-ui: 'Admin Console'
Expand Down
7 changes: 1 addition & 6 deletions local-preview-playbook.yml
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ asciidoc:
astra-ui: 'Astra Portal'
astra-url: 'https://astra.datastax.com'
astra-ui-link: '{astra-url}[{astra-ui}^]'
db-classic: 'Managed Cluster'
db-classic: 'Astra Managed Clusters'
db-serverless: 'Serverless (non-vector)'
db-serverless-vector: 'Serverless (vector)'
scb: 'Secure Connect Bundle (SCB)'
Expand All @@ -78,7 +78,6 @@ asciidoc:
astra-stream: 'Astra Streaming'
starlight-kafka: 'Starlight for Kafka'
starlight-rabbitmq: 'Starlight for RabbitMQ'
astra-streaming-examples-repo: 'https://github.com/datastax/astra-streaming-examples'
sstable-sideloader: '{astra-db} Sideloader'
zdm: 'Zero Downtime Migration'
zdm-short: 'ZDM'
Expand Down Expand Up @@ -217,10 +216,6 @@ asciidoc:
capacity-service: 'Capacity Service'
lcm: 'Lifecycle Manager (LCM)'
lcm-short: 'LCM'
cr: 'custom resource (CR)'
cr-short: 'CR'
crd: 'custom resource definition (CRD)'
crd-short: 'CRD'
# Antora Atlas
primary-site-url: https://docs.datastax.com/en
primary-site-manifest-url: https://docs.datastax.com/en/site-manifest.json
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -66,7 +66,7 @@ image::pulsar-components.png[]
[#message-retention]
== Message retention

The broker ensures messages are received and delivered appropriately, but it is a stateless process so it doesn't use its memory to track this. Instead, the broker uses {bookkeeper-short}s (bookies) to store message data and the message's acknowledgement state.
The broker ensures messages are received and delivered appropriately, but it is a stateless process so it doesn't use its memory to track this. Instead, the broker uses the {bookkeeper-short} instances, known as bookies, to store message data and the message's acknowledgement state.
A great benefit of {bookkeeper-short} is its quorum policies. These policies make each bookie aware of the other bookies to form a {bookkeeper-short} cluster. With a cluster established, the cluster can have acknowledgement rules that form a data replication factor. For example, if you had 3 bookies in a {bookkeeper-short} cluster with an acknowledgement rule that at least 2 of the 3 bookies must have a copy of the data, then the cluster has a replication factor of 2. A {pulsar-short} broker uses the `managedLedgerDefaultAckQuorum` and `managedLedgerDefaultWriteQuorum` configurations to set the bounds of this rule. For more about {bookkeeper-short} persistence, see https://pulsar.apache.org/docs/administration-zk-bk/#bookkeeper-persistence-policies[here].

When a client produces a message, the broker will not acknowledge receipt until the replication factor has been achieved. Continuing from the above example, if the replication factor is 2, a broker's acknowledgment means a minimum of 2 bookies have confirmed storage of message data. If the broker times out waiting for at least 2 responses from the bookies, then the broker will not acknowledge receipt with the client. The client will need to handle the exception by attempting to resend or fail. This process forms one of {pulsar-short}'s core values - guaranteed message receipt.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -338,7 +338,7 @@ TIP: With message/state persistence disabled, the cluster will not survive a res
+
`helm install pulsar -f dev-values-auth.yaml datastax-pulsar/pulsar`

* `dev-values-tls.yaml`. Development environment with self-signed certificate created by cert-manager. You need to install the cert-manager {crd} before installing the Helm chart. The chart will install the cert-manager application.
* `dev-values-tls.yaml`. Development environment with self-signed certificate created by cert-manager. You need to install the cert-manager custom resource definition (CRD) before installing the Helm chart. The chart will install the cert-manager application.
+
[source,shell]
----
Expand Down