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:

  1. brew install libpulsar

Deb

  1. Download any one of the Deb packages:

    • client
    • client-devel
    1. wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-3.6.0/deb-x86_64/apache-pulsar-client.deb

    This package contains shared library libpulsar.so.

    1. wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-3.6.0/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:

    1. 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:

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

    This package contains shared library libpulsar.so.

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

    This package contains debug symbols for libpulsar.so.

    1. wget https://archive.apache.org/dist/pulsar/pulsar-client-cpp-3.6.0/rpm-x86_64/x86_64/apache-pulsar-client-devel-3.6.0-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:

    1. rpm -ivh apache-pulsar-client*.rpm

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

Set up - 图1note

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

  1. 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:

  1. pulsar://localhost:6650

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

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

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

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