MapR 5.1 is at End of Life (EOL) and no longer supported. Please see the latest documentation. This documentation is not being updated.

Home
5.1 DB & Streams
This section covers the MapR-DB, MapR-Streams, and MapR-Gateways features. Each feature may contain both administrator and developer topics.
MapR Streams
MapR Streams brings integrated publish/subscribe messaging to the MapR Converged Data Platform.
MapR Streams in Detail
If you understand the basics about the components of MapR Streams, the flow of messages from producers to consumers, and how producers and consumers are coded, it's time to cover them in more detail.
Compiling and Launching Producers and Consumers
You can compile producers and consumers by using the required JAR file from the MapR Maven repository or from the MapR installation. Launch producers and consumers with the mapr command.

MapR 5.1 Documentation

5.1 DB & Streams
This section covers the MapR-DB, MapR-Streams, and MapR-Gateways features. Each feature may contain both administrator and developer topics.
- MapR-DB
- MapR Streams
  MapR Streams brings integrated publish/subscribe messaging to the MapR Converged Data Platform.
  - MapR Streams Concepts
  - Life of a Message
    To show how the MapR Streams concepts fit together, here is an example of the flow of one message from a producer to a consumer.
  - Getting Started with MapR Streams
    If you have a basic understanding of MapR Streams's components and the typical flow of messages from producers to consumers, you can give MapR Streams a try.
  - MapR Streams in Detail
    If you understand the basics about the components of MapR Streams, the flow of messages from producers to consumers, and how producers and consumers are coded, it's time to cover them in more detail.
    - Creating Topics
      There are two methods by which topics can be created in a stream.
    - Default Number of Partitions in New Topics
      When you create or edit a stream, the -defaultpartitions parameter determines how many partitions are created in each new topic in the stream. If you do not explicitly set this value, each new topic is created with one partition.
    - Security
      The topics that are in a stream are all protected by a single set of security permissions.
    - Time-to-Live for Messages
      Messages can persist in the partitions of a stream for as long as you need them to, and can be read or reread by consumers during that time. However, if you know that after a certain period of time the messages in a stream will no longer be needed, you can specify a length of time for messages to persist until they expire.
    - Encrypting Streams
      Apply an additional layer of security to streams by encrypting them.
    - Deciding Which Streams to Create
      Your decision about what streams to create should take into account whatever topics you want to replicate. Replication is between streams, not individual topics.
    - Producers
      Producers are data-generating applications, such as sensors in automobiles or activity loggers in servers.
    - Consumers
      Consumers are applications that you create, such as analytics applications, reporting tools, or enterprise dashboards.
    - Compiling and Launching Producers and Consumers
      You can compile producers and consumers by using the required JAR file from the MapR Maven repository or from the MapR installation. Launch producers and consumers with the mapr command.
  - Monitoring the Flow of Messages
    The speed at which messages flow from producers to partitions and from partitions to consumers depends on the performance of your producers, cluster nodes hosting partitions, and your consumers.
  - Replicating MapR Streams
    You can replicate streams to other MapR clusters worldwide or to other streams within a MapR cluster.
  - Querying Messages in MapR Streams
    You can develop Java applications or modify existing Java applications to query messages that are in MapR streams by using the methods in the Streams class.
  - Migrating Apache Kafka 0.9.0 Applications to MapR Streams
    There are only two steps that you need to follow to migrate applications written with the Apache Kafka 0.9.0 Java API to MapR Streams.
  - Mirroring Topics with Apache Kafka's MirrorMaker
    Use Apache Kafka's MirrorMaker utility either to mirror topics that are in Apache Kafka clusters to streams that are in MapR clusters or to Mirror topics that are in MapR clusters to Apache Kafka clusters.
  - Utilities for MapR Streams
    MapR Streams provides the following utilities.
- MapR Gateways
  A MapR gateway mediates one-way communication between a source MapR cluster and a destination cluster. MapR-DB binary tables and MapR Streams streams can be replicated.

Compiling and Launching Producers and Consumers

You can compile producers and consumers by using the required JAR file from the MapR Maven repository or from the MapR installation. Launch producers and consumers with the mapr command.

Using the JAR File from the MapR Maven Repository

NOTE: This method works only if your MapR cluster is not secure.

Add MapR's Maven repository to your pom.xml file, if it is not already added:

    <repositories>
    <repository>
      <id>mapr-releases</id>
      <url>http://repository.mapr.com/nexus/content/repositories/releases</url>
      <snapshots><enabled>true</enabled></snapshots>
      <releases><enabled>true</enabled></releases>
    </repository>
  </repositories>

Add a dependency to the kafka-clients project:

    <dependency>
      <groupId>org.apache.kafka</groupId>
      <artifactId>kafka-clients</artifactId>
      <version>0.9.0.0-mapr-1602-streams-5.1.0</version>
    </dependency>

Using JARs from the MapR Installation

Use the following command to compile applications:

javac -cp `mapr classpath` <Application jars>

Launching Applications

Use the following command to launch applications:

mapr <Main class jar> <commandline arguments>

NOTE: If you want to add JAR files to the classpath that the mapr command uses, add them with the environment variable MAPR_CLASSPATH.

Example:

export MAPR_CLASSPATH=/home/apps/awesome-1.0.jar
mapr com.company.MyAwesomeApp