Set up Pulsar C++ client

To set up C++ client library in Pulsar, complete the following steps.

Step 1: Install C++ client library

Use one of the following methods to install a Pulsar C++ client.

Brew

Use Homebrew to install the latest tagged version with the library and headers:

brew install libpulsar

Deb

1. Download any one of the Deb packages:

   wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-3.5.1/deb-x86_64/apache-pulsar-client.deb

   This package contains shared libraries libpulsar.so and libpulsarnossl.so.

   wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-3.5.1/deb-x86_64/apache-pulsar-client-dev.deb

   This package contains static libraries: libpulsar.a, libpulsarwithdeps.a, and C/C++ headers.

2. Install the package using the following command:

   apt install ./apache-pulsar-client*.deb

Now, you can see Pulsar C++ client libraries installed under the /usr/lib directory.

RPM

1. Download any one of the RPM packages:

   wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-3.5.1/rpm-x86_64/x86_64/apache-pulsar-client-3.5.1-1.x86_64.rpm

   This package contains shared libraries: libpulsar.so and libpulsarnossl.so.

   wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-3.5.1/rpm-x86_64/x86_64/apache-pulsar-client-debuginfo-3.5.1-1.x86_64.rpm

   This package contains debug symbols for libpulsar.so.

   wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-3.5.1/rpm-x86_64/x86_64/apache-pulsar-client-devel-3.5.1-1.x86_64.rpm

   This package contains static libraries: libpulsar.a, libpulsarwithdeps.a and C/C++ headers.

2. Install the package using the following command:

   rpm -ivh apache-pulsar-client*.rpm

Now, you can see Pulsar C++ client libraries installed under the /usr/lib directory.

note

If you get an error like "libpulsar.so: cannot open shared object file: No such file or directory" when starting a Pulsar client, you need to run ldconfig first.

APK

apk add --allow-untrusted ./apache-pulsar-client-*.apk

Step 2: Connect to Pulsar cluster

To connect to Pulsar using client libraries, you need to specify a Pulsar protocol URL.

You can assign Pulsar protocol URLs to specific clusters and use the pulsar scheme. The following is an example of localhost with the default port 6650:

pulsar://localhost:6650

If you have multiple brokers, separate IP:port by commas:

pulsar://localhost:6550,localhost:6651,localhost:6652

If you use mTLS authentication, add +ssl in the scheme:

pulsar+ssl://pulsar.us-west.example.com:6651