Installing DataStax Apache® Pulsar Connector

Install DataStax Apache® Pulsar Connector from the DataStax distribution tar file using an account that has write access to the Pulsar configuration directory.

The supported operating systems are Linux and macOS.

Supported Apache® Pulsar versions

Install the DataStax Apache® Pulsar Connector on Apache Pulsar 2.7.0.

Apache-2.0 license agreement. By downloading this DataStax product, you agree to the terms of the open-source Apache-2.0 license agreement.

Perform the following steps on a Pulsar Connect node:

  1. Download the tar file from the DataStax downloads site. If you agree, enable the Terms checkbox and click the download icon.

  2. Extract the files:

    tar zxf cassandra-enhanced-pulsar-sink-1.4.0.tar.gz

    The following files are unpacked into a directory such as cassandra-enhanced-pulsar-sink-1.4.0:

    LICENSE.txt
    README.md
    THIRD-PARTY.txt
    conf/example.yml
    cassandra-enhanced-pulsar-sink-1.4.0.nar
  3. Create a connectors directory in the Pulsar home directory if it doesn’t exist.

  4. Move the DataStax connector NAR to the Pulsar connectors directory:

    mv installation_location/cassandra-enhanced-pulsar-sink-1.4.0.nar pulsar_home/connectors
  5. Copy the sample example.yml configuration file from cassandra-enhanced-pulsar-sink-1.4.0/conf/ to the Pulsar configuration directory, which is typically the config or etc directory.

  6. Update the settings as necessary.

    If you are using the cloud.secureConnectBundle, ALL subproperties under ssl: must be empty.
  7. Ensure that the user running Pulsar has permission to access the configuration and NAR files.