List the configuration files in the conf directory:

ls conf

Since this Katacoda environment has limited resources, let's decrease the VM heap memory requirements in file conf/pulsar_env.sh under PULSAR_MEM:

sed -i 's/^PULSAR_MEM=.*$/PULSAR_MEM=${PULSAR_MEM:-"-Xms1g -Xmx1g -XX:MaxDirectMemorySize=1g"}/' conf/pulsar_env.sh

List the command-line tools in the bin directory:

ls bin

This particular scenario uses pulsar, pulsar-admin and pulsar-client.

Start a local cluster using the pulsar command:

bin/pulsar standalone

If Apache Pulsar™ starts successfully, there will be a number of INFO-level log messages displayed.

Navigate to the Pulsar directory in Admin Terminal:

cd apache-pulsar-2.6.2

Display the cluster name:

bin/pulsar-admin clusters list

Display the tenants:

bin/pulsar-admin tenants list

Display the namespaces in the public tenant:

bin/pulsar-admin namespaces list public

Display the topics in the public/default namespace:

bin/pulsar-admin topics list public/default

Since there are no topics in the public/default namespace, let's create one next.

Create topic shakespeare-quotes in the public/default namespace:

bin/pulsar-admin topics create persistent://public/default/shakespeare-quotes

Display the topics in the public/default namespace:

bin/pulsar-admin topics list public/default

Navigate to the Pulsar directory in Consumer Terminal:

cd apache-pulsar-2.6.2

Subscribe a consuming client, consumer, to the new topic public/default/shakespeare-quotes using the pulsar-client tool:

bin/pulsar-client consume public/default/shakespeare-quotes -s "my-shakespeare-subscription"

Let's publish a message into this topic next.

Navigate to the Pulsar directory in Producer Terminal:

cd apache-pulsar-2.6.2

Create a producing client, producer, and send a message to the public/default/shakespeare-quotes topic using the pulsar-client tool:

bin/pulsar-client produce public/default/shakespeare-quotes -m "Brevity is the soul of wit"

The output should read 1 messages successfully produced.

Switch to Consumer Terminal and verify that the message was received by the consumer:

echo "Go to Consumer Terminal ..."

Look for output pieces ----- got message -----, content:Brevity is the soul of wit and 1 messages successfully consumed.

In Producer Terminal, send 60 messages at the rate of 1 message per second:

bin/pulsar-client produce public/default/shakespeare-quotes \
-m \
"All that glitters is not gold"~"Fair is foul, and foul is fair: Hover through the fog and filthy air."~"Hell is empty and all the devils are here."~"By the pricking of my thumbs, Something wicked this way comes. Open, locks, Whoever knocks!"~"The lady doth protest too much, methinks."~"Brevity is the soul of wit."~"These violent delights have violent ends..."~"Now is the winter of our discontent."~"If music be the food of love, play on."~"Good night, good night! parting is such sweet sorrow, That I shall say good night till it be morrow." \
-n 6 -r 1 -s "~"

In Consumer Terminal, receive the 60 messages at the same rate of 1 message per second:

bin/pulsar-client consume public/default/shakespeare-quotes -s "my-shakespeare-subscription" -n 60 -r 1