diff --git a/antora.yml b/antora.yml index 2a71f5f..4250c3f 100644 --- a/antora.yml +++ b/antora.yml @@ -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' diff --git a/local-preview-playbook.yml b/local-preview-playbook.yml index 664cc64..cb4feac 100644 --- a/local-preview-playbook.yml +++ b/local-preview-playbook.yml @@ -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)' @@ -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' @@ -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 diff --git a/modules/install-upgrade/pages/production-cluster-sizing.adoc b/modules/install-upgrade/pages/production-cluster-sizing.adoc index 05313af..486b3c1 100644 --- a/modules/install-upgrade/pages/production-cluster-sizing.adoc +++ b/modules/install-upgrade/pages/production-cluster-sizing.adoc @@ -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. diff --git a/modules/install-upgrade/pages/quickstart-helm-installs.adoc b/modules/install-upgrade/pages/quickstart-helm-installs.adoc index 2ffca39..0af9968 100644 --- a/modules/install-upgrade/pages/quickstart-helm-installs.adoc +++ b/modules/install-upgrade/pages/quickstart-helm-installs.adoc @@ -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] ----