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: 1 addition & 0 deletions antora.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,7 @@ asciidoc:
pulsar-reg: 'Apache Pulsar(TM)'
pulsar: 'Apache Pulsar'
pulsar-short: 'Pulsar'
astra-stream: 'Astra Streaming'

# Required for include::common partials that are shared with Astra Streaming
web-ui: 'Admin Console'
Expand Down
66 changes: 33 additions & 33 deletions modules/ROOT/pages/faqs.adoc
Original file line number Diff line number Diff line change
@@ -1,77 +1,77 @@
= Luna Streaming FAQs
= {product} FAQs
:navtitle: FAQs

If you are new to {company} Luna Streaming and its {pulsar} enhancements, these FAQs are for you.
If you are new to {company} {product} and its {pulsar} enhancements, these FAQs are for you.

== What is {company} Luna Streaming?
== What is {company} {product}?

{company} Luna Streaming is a new Kubernetes-based distribution of {pulsar}, based on the technology that https://kesque.com/[Kesque] built to run its {pulsar-short}-as-a-service.
{company} {product} is a new Kubernetes-based distribution of {pulsar}, based on the technology that https://kesque.com/[Kesque] built to run its {pulsar-short}-as-a-service.

== What components and features are provided by {company} Luna Streaming?
== What components and features are provided by {company} {product}?

In addition to {pulsar} itself, {company} Luna Streaming provides:
In addition to {pulsar} itself, {company} {product} provides:

* An installer that can stand up a dev or production cluster on bare metal or VMs without a pre-existing Kubernetes environment
* A Helm chart that can deploy and manage {pulsar-short} on your current Kubernetes infrastructure
* Cassandra, Elastic, Kinesis, Kafka, and JDBC connectors
* {cass-short}, Elastic, Kinesis, Kafka, and JDBC connectors
* A management dashboard
* A monitoring and alerting system

== On which version of {pulsar} is {company} Luna Streaming based?
== On which version of {pulsar} is {company} {product} based?

{company} Luna Streaming {luna-version} is based on its distribution of {pulsar} {pulsar-version}, plus features and additional enhancements from {company} contributors.
{company} {product} {luna-version} is based on its distribution of {pulsar} {pulsar-version}, plus features and additional enhancements from {company} contributors.

== What does {company} Luna Streaming provide that I cannot get with open-source {pulsar}?
== What does {company} {product} provide that I cannot get with open-source {pulsar}?

{company} Luna Streaming is a hardened version of {pulsar} that been run through additional testing to ensure it is ready for production use. It also includes additional tooling to help monitor your system, including an enhanced Admin Console and a Heartbeat service to monitor the system health.
{company} {product} is a hardened version of {pulsar} that been run through additional testing to ensure it is ready for production use. It also includes additional tooling to help monitor your system, including an enhanced Admin Console and a Heartbeat service to monitor the system health.

== Is {company} Luna Streaming an open-source project?
== Is {company} {product} an open-source project?

Yes, {company} Luna Streaming is open source. See the <<gitHubRepos,repos FAQ>>.
Yes, {company} {product} is open source. See the <<gitHubRepos,repos FAQ>>.

== Which Kubernetes platforms are supported by {company} Luna Streaming?
== Which Kubernetes platforms are supported by {company} {product}?

They include Minikube, K8d, Kind, Google Kubernetes Engine (GKE), Microsoft Azure Kubernetes Service (AKS), Amazon Elastic Kubernetes Service (EKS), and other commonly used platforms.

[#gitHubRepos]
== Where are the {company} Luna Streaming public GitHub repos?
== Where are the {company} {product} public GitHub repos?

There are several public repos, each with a different purpose. See:

* https://github.com/datastax/pulsar[https://github.com/datastax/pulsar] : This is the distro repo (a fork of apache/pulsar).
* https://github.com/datastax/pulsar-admin-console[https://github.com/datastax/pulsar-admin-console] : This is the repo for the {pulsar-short} admin console, which allows for the configuration and monitoring of {pulsar-short}.
* https://github.com/datastax/pulsar-heartbeat[https://github.com/datastax/pulsar-heartbeat] : This is a monitoring/observability tool for {pulsar-short} that tracks the health of the cluster and can generate alerts in Slack and OpsGenie.
* https://github.com/datastax/pulsar-helm-chart[https://github.com/datastax/pulsar-helm-chart] : This is the Helm chart for deploying the {company} {pulsar-short} Distro in an existing Kubernetes cluster.
* https://github.com/datastax/pulsar-sink[https://github.com/datastax/pulsar-sink] : This is the {company} {pulsar} Connector (`pulsar-sink` for Cassandra) repo.
* https://github.com/datastax/pulsar-sink[https://github.com/datastax/pulsar-sink] : This is the {company} {pulsar} Connector (`pulsar-sink` for {cass-short}) repo.
* https://github.com/datastax/burnell[https://github.com/datastax/burnell] : This is a utility for {pulsar-short} that provides various functions, such as key initialization for authentication, and JWT token creation API.

== Is there a prerequisite version of Java needed for the {company} Luna Streaming installation?
== Is there a prerequisite version of Java needed for the {company} {product} installation?

The {company} Luna Streaming distribution is designed for Java 17. However, because the product releases Docker images, you do not need to install Java 17 in advance. Java 17 is bundled in the Docker image.
The {company} {product} distribution is designed for Java 17. However, because the product releases Docker images, you do not need to install Java 17 in advance. Java 17 is bundled in the Docker image.

== What are the install options for {company} Luna Streaming?
== What are the install options for {company} {product}?

* **KAAP Helm chart (Recommended)**: Use the {company} https://github.com/datastax/kaap/[KAAP operator Helm chart], which provides Kubernetes-native autoscaling and simplified management for {pulsar} clusters. For more information, see the xref:kaap-operator::index.adoc[Kubernetes Autoscaling for {pulsar} (KAAP)] documentation.
* **Luna Streaming Helm chart**: Use the Helm chart provided at https://github.com/apache/pulsar-helm-chart[https://github.com/datastax/pulsar-helm-chart] to install {company} Luna Streaming in an existing Kubernetes cluster on your laptop or hosted by a cloud provider.
* **Tarball**: Use the tarball provided at https://github.com/datastax/pulsar/releases[https://github.com/datastax/pulsar/releases] to install {company} Luna Streaming on a server or VM.
* **Ansible**: Use the {company} Ansible scripts provided at https://github.com/datastax/pulsar-ansible[https://github.com/datastax/pulsar-ansible] to install {company} Luna Streaming on a server or VM with our provided playbooks.
* **{product} Helm chart**: Use the Helm chart provided at https://github.com/apache/pulsar-helm-chart[https://github.com/datastax/pulsar-helm-chart] to install {company} {product} in an existing Kubernetes cluster on your laptop or hosted by a cloud provider.
* **Tarball**: Use the tarball provided at https://github.com/datastax/pulsar/releases[https://github.com/datastax/pulsar/releases] to install {company} {product} on a server or VM.
* **Ansible**: Use the {company} Ansible scripts provided at https://github.com/datastax/pulsar-ansible[https://github.com/datastax/pulsar-ansible] to install {company} {product} on a server or VM with our provided playbooks.

== How do I install {company} Luna Streaming in my Kubernetes cluster?
== How do I install {company} {product} in my Kubernetes cluster?

Follow the full instructions in xref:install-upgrade:quickstart-helm-installs.adoc[Quick Start for Helm Chart installs].

== How do I install {company} Luna Streaming on my server or VM?
== How do I install {company} {product} on my server or VM?

Follow the full instructions in xref:install-upgrade:quickstart-server-installs.adoc[Quick Start for Server/VM installs].

== What task can I perform in the {company} Luna Streaming Admin Console?
== What task can I perform in the {company} {product} Admin Console?

From the Admin Console, you can:

* Add and run {pulsar-short} clients
* Establish credentials for secure connections
* Define topics that can be published for streaming apps
* Set up {pulsar-short} sinks that publish topics and make them available to subscribers, such as for a Cassandra database table
* Set up {pulsar-short} sinks that publish topics and make them available to subscribers, such as for a {cass-short} database table
* Control namespaces used by {pulsar-short}
* Use the Admin API

Expand All @@ -81,7 +81,7 @@ https://github.com/datastax/pulsar-heartbeat[{pulsar-short} Heartbeat] monitors

== What are the features provided by {company} {pulsar} Connector (`pulsar-sink`) that are not supported in `kafka-sink`?

The https://pulsar.apache.org/docs/en/io-overview/[{pulsar-short} IO framework] provides many features that are not possible in Kafka, and has different compression formats and auth/security features. The features are handled by {pulsar-short}. For more, see xref:connectors:index.adoc[Luna Streaming IO Connectors].
The https://pulsar.apache.org/docs/en/io-overview/[{pulsar-short} IO framework] provides many features that are not possible in Kafka, and has different compression formats and auth/security features. The features are handled by {pulsar-short}. For more, see xref:connectors:index.adoc[{product} IO Connectors].

The {company} {pulsar} Connector allows single-record acknowledgement and negative acknowledgements.

Expand All @@ -96,17 +96,17 @@ The {company} {pulsar} Connector allows single-record acknowledgement and negati

There are two packages:

* The `pulsar-sink` functionality of {company} {pulsar} Connector is included with {company} Luna Streaming. It's built in!
* The `pulsar-sink` functionality of {company} {pulsar} Connector is included with {company} {product}. It's built in!
* You can optionally download the {company} {pulsar} Connector tarball from the https://downloads.datastax.com/#pulsar-sink[{company} Downloads] site, and then use it as its own product with your open-source {pulsar} install.

If you're using open-source software (OSS) {pulsar}, you can use {company} {pulsar} Connector with the OSS to take advantage of this `pulsar-sink` for Cassandra.
If you're using open-source software (OSS) {pulsar}, you can use {company} {pulsar} Connector with the OSS to take advantage of this `pulsar-sink` for {cass-short}.
See the xref:pulsar-connector:ROOT:index.adoc[{company} {pulsar} Connector documentation].

== What is the {company} Change Data Capture (CDC) for Cassandra connector?
== What is the {company} Change Data Capture (CDC) for {cass-short} connector?

This source connector streams data changes from Cassandra tables to Pulsar topics.
For more information, see the xref:cdc-for-cassandra:ROOT:index.adoc[{company} CDC for Cassandra connector documentation].
This source connector streams data changes from {cass-short} tables to {pulsar-short} topics.
For more information, see the xref:cdc-for-cassandra:ROOT:index.adoc[{company} CDC for {cass-short} connector documentation].

== What client APIs does {company} Luna Streaming provide?
== What client APIs does {company} {product} provide?

The same as for {pulsar}. See https://pulsar.apache.org/docs/en/client-libraries/.
20 changes: 10 additions & 10 deletions modules/ROOT/pages/index.adoc
Original file line number Diff line number Diff line change
@@ -1,23 +1,23 @@
= Welcome to {company} Luna Streaming
:navtitle: Luna Streaming
= Welcome to {company} {product}
:navtitle: {product}

{company} Luna Streaming is a production-ready distribution of {pulsar} built to run seamlessly on any CNCF conformant version of Kubernetes. {company} Luna Streaming provides all of the core capabilities included in the Apache Community version of {pulsar}, plus a number of additional tools and features to facilitate administration and operational tasks associated with running {pulsar} in production.
{company} {product} is a production-ready distribution of {pulsar} built to run seamlessly on any CNCF conformant version of Kubernetes. {company} {product} provides all of the core capabilities included in the Apache Community version of {pulsar}, plus a number of additional tools and features to facilitate administration and operational tasks associated with running {pulsar} in production.

== Release notes

The latest release of {company} Luna Streaming is {luna-version}, which matches the supported, distributed {pulsar-short} version numbers.
The latest release of {company} {product} is {luna-version}, which matches the supported, distributed {pulsar-short} version numbers.

The prior Luna Streaming release (2.10.x) provided the {pulsar-short} 2.10.x distribution.
The prior {product} release (2.10.x) provided the {pulsar-short} 2.10.x distribution.

Refer to the {company} Luna Streaming https://github.com/datastax/release-notes/blob/master/Luna_Streaming_3.1_Release_Notes.md[release notes], which are hosted in our public GitHub repo, for information &amp; linked commit IDs that were implemented in the latest Luna Streaming {luna-version} release.
Refer to the {company} {product} https://github.com/datastax/release-notes/blob/master/Luna_Streaming_3.1_Release_Notes.md[release notes], which are hosted in our public GitHub repo, for information &amp; linked commit IDs that were implemented in the latest {product} {luna-version} release.

== Components

In addition to the distribution of https://pulsar.apache.org/en/versions/[{pulsar} {pulsar-version}], {company} Luna Streaming provides:
In addition to the distribution of https://pulsar.apache.org/en/versions/[{pulsar} {pulsar-version}], {company} {product} provides:

* A xref:install-upgrade:quickstart-helm-installs.adoc[Helm chart] that deploys and manages {pulsar-short} on your current CNCF-conformant Kubernetes infrastructure

* Cassandra, Elastic, Kinesis, Kafka, and JDBC xref:connectors:index.adoc[connectors]
* {cass-short}, Elastic, Kinesis, Kafka, and JDBC xref:connectors:index.adoc[connectors]

* The xref:components:starlight.adoc[Starlight suite of {pulsar-short} protocol handlers for Kafka, RabbitMQ, and JMS]

Expand Down Expand Up @@ -57,7 +57,7 @@ In addition to the distribution of https://pulsar.apache.org/en/versions/[{pulsa

== Next steps

* If you have an existing Kubernetes environment, deploy Luna Streaming with a xref:install-upgrade:quickstart-helm-installs.adoc[Helm Installation].
* If you have an existing Kubernetes environment, deploy {product} with a xref:install-upgrade:quickstart-helm-installs.adoc[Helm Installation].
* If you have a bare metal or a cloud environment, see xref:install-upgrade:quickstart-server-installs.adoc[Server/VM Installation].
* If you want to learn about monitoring with {pulsar-short} Heartbeat, see xref:components:pulsar-monitor.adoc[{pulsar-short} Heartbeat].
* If you have questions about Luna Streaming, see xref::faqs.adoc[Luna Streaming FAQs].
* If you have questions about {product}, see xref::faqs.adoc[{product} FAQs].
4 changes: 2 additions & 2 deletions modules/components/pages/admin-console-tutorial.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ The *{company} Admin Console for {pulsar-reg}* is a web-based UI from {company}
[#getting-started]
== Getting Started in {pulsar-short} Admin Console

In the *Luna Streaming {pulsar-short} Admin Console*, you can use {pulsar-short} clients to send and receive pub/sub messages.
In the *{product} {pulsar-short} Admin Console*, you can use {pulsar-short} clients to send and receive pub/sub messages.

If you installed the Admin console with the xref:install-upgrade:quickstart-helm-installs.adoc[{company} Helm chart], access the Admin console via the `pulsar-adminconsole` external load balancer endpoint in your cloud provider:

Expand All @@ -26,7 +26,7 @@ image::luna-streaming-select-namespace.png[Select Namespace]

Messages published to namespaces are automatically replicated to all node(s) in the cluster.

image::luna-streaming-admin-console.png[Luna Streaming Admin Console]
image::luna-streaming-admin-console.png[{product} Admin Console]

For interactive code samples, go to *Code Samples*.

Expand Down
8 changes: 4 additions & 4 deletions modules/components/pages/pulsar-beam.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
= {pulsar-short} Beam with Luna Streaming
= {pulsar-short} Beam with {product}
:navtitle: {pulsar-short} Beam
:description: Install a minimal Luna Streaming Helm chart that includes {pulsar-short} Beam
:description: Install a minimal {product} Helm chart that includes {pulsar-short} Beam
:helmValuesPath: https://raw.githubusercontent.com/datastaxdevs/luna-streaming-examples/main/beam/values.yaml

The https://github.com/kafkaesque-io/pulsar-beam[{pulsar-short} Beam] project is an HTTP-based streaming and queueing system for use with {pulsar}.
Expand All @@ -15,7 +15,7 @@ In this guide, you'll install a minimal {company} {pulsar-short} Helm chart that
* Enough access to a K8s cluster to create a namespace, deployments, and pods
* https://kubernetes.io/docs/tasks/tools/[Kubectl CLI] (this example uses version 1.23.4)

== Install Luna Streaming Helm chart
== Install {product} Helm chart

include::partial$install-helm.adoc[]

Expand All @@ -40,7 +40,7 @@ Forwarding from [::1]:8085 -> 8085
== Start a message consumer

In a new terminal window, run the following curl command to begin streaming server-sent events.
See xref:astra-streaming:developing:configure-pulsar-env.adoc[configuring your local environment for Astra Streaming].
See xref:astra-streaming:developing:configure-pulsar-env.adoc[configuring your local environment for {astra-stream}].

[source,shell]
----
Expand Down
6 changes: 3 additions & 3 deletions modules/components/pages/pulsar-sql.adoc
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
= Using {pulsar-short} SQL with Luna Streaming
= Using {pulsar-short} SQL with {product}
:navtitle: {pulsar-short} SQL
:description: This guide installs the Luna Streaming Helm chart using minimum values for a working {pulsar-short} cluster that includes SQL workers
:description: This guide installs the {product} Helm chart using minimum values for a working {pulsar-short} cluster that includes SQL workers
:helmValuesPath: https://raw.githubusercontent.com/datastaxdevs/luna-streaming-examples/main/pulsar-sql/values.yaml

{pulsar-short} SQL allows enterprises to query {pulsar} topic data with SQL.
Expand All @@ -26,7 +26,7 @@ PrestoDB has been replaced by Trino, and {pulsar} is using Trino's version.
The Trino CLI uses the "X-TRINO-USER" header for authentications.
====

== Install Luna Streaming Helm chart
== Install {product} Helm chart

include::partial$install-helm.adoc[]

Expand Down
10 changes: 5 additions & 5 deletions modules/connectors/pages/index.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@

[TIP]
====
There are three versions of the {company} Luna Streaming distribution.
There are three versions of the {company} {product} distribution.
The `lunastreaming-all` version includes all connectors.
====

Expand All @@ -30,8 +30,8 @@ The following sink connectors are included in {product}:

Experimental sink connectors::
The following sink connectors are experimental.
They are available in the `luna-streaming-all` version of {product}, and you can use them in your Luna Streaming cluster.
They are considered experimental because they aren't fully supported or tested with Astra Streaming.
They are available in the `luna-streaming-all` version of {product}, and you can use them in your {product} cluster.
They are considered experimental because they aren't fully supported or tested with {astra-stream}.
+
* Aerospike
* Apache Geode
Expand Down Expand Up @@ -90,8 +90,8 @@ The following source connectors are included in {product}:

Experimental source connectors::
The following source connectors are experimental.
They are available in the `luna-streaming-all` version of {product}, and you can use them in your Luna Streaming cluster.
They are considered experimental because they aren't fully supported or tested with Astra Streaming.
They are available in the `luna-streaming-all` version of {product}, and you can use them in your {product} cluster.
They are considered experimental because they aren't fully supported or tested with {astra-stream}.
+
* {cass}
* Apache Geode
Expand Down
Loading