Running Pinot locally

Search…
This quick start guide will help you bootstrap a Pinot standalone instance on your local machine.
In this guide, you'll learn how to download and install Apache Pinot as a standalone instance.
Download Apache Pinot
First, let's download the Pinot distribution for this tutorial. You can either download a packaged release or build a distribution from the source code.
Prerequisites
Install JDK11 or higher (JDK16 is not yet supported)
For JDK 8 support use Pinot 0.7.1 or compile from the source code.
You can build from source or download the distribution:
Download the release
Build from source 
Download the latest binary release from Apache Pinot, or use this command
PINOT_VERSION=0.10.0 #set to the Pinot version you decide to use
​
wget https://downloads.apache.org/pinot/apache-pinot-$PINOT_VERSION/apache-pinot-$PINOT_VERSION-bin.tar.gz
Once you have the tar file,
# untar it
tar -zxvf apache-pinot-$PINOT_VERSION-bin.tar.gz
​
# navigate to directory containing the launcher scripts
cd apache-pinot-$PINOT_VERSION-bin
Follow these steps to checkout code from Github and build Pinot locally
Prerequisites
Install Apache Maven 3.6 or higher
# checkout pinot
git clone https://github.com/apache/pinot.git
cd pinot
​
# build pinot
mvn install package -DskipTests -Pbin-dist
​
# navigate to directory containing the setup scripts
cd build
Add maven option -Djdk.version=8 when building with JDK 8
Note that Pinot scripts is located under pinot-distribution/target not target directory under root.
M1 Mac Support
Currently Apache Pinot doesn't provide official binaries for M1 Mac. You can however build from source using the steps provided above. In addition to the steps, you will need to add the following in your ~/.m2/settings.xml prior to the build.
<activeProfiles>
  <activeProfile>
    apple-silicon
  </activeProfile>
</activeProfiles>
<profiles>
  <profile>
    <id>apple-silicon</id>
    <properties>
      <os.detected.classifier>osx-x86_64</os.detected.classifier>
    </properties>
  </profile>
</profiles>
Also make sure to install rosetta
softwareupdate --install-rosetta
Now that we've downloaded Pinot, it's time to set up a cluster. There are two ways to do this:
Quick Start
Pinot comes with quick-start commands that launch instances of Pinot components in the same process and import pre-built datasets.
For example, the following quick-start launches Pinot with a baseball dataset pre-loaded:
./bin/pinot-admin.sh QuickStart -type batch
For a list of all the available quick starts, see the Quick Start Examples.
Manual Cluster
If you want to play with bigger datasets (more than a few MB), you can launch all the components individually.
The video below is a step-by-step walk through for launching the individual components of Pinot and scaling them to multiple instances.
Neha Pawar from the Apache Pinot team shows you how to setup a Pinot cluster
You can find the commands that are shown in this video in the github.com/npawar/pinot-tutorial GitHub repository.
The examples below assume that you are using Java 8.
If you are using Java 11+ users, remove the GC settings insideJAVA_OPTS. So, for example, instead of:
export JAVA_OPTS="-Xms4G -Xmx8G -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -Xloggc:gc-pinot-controller.log"
You'd have:
export JAVA_OPTS="-Xms4G -Xmx8G"
Start Zookeeper
./bin/pinot-admin.sh StartZookeeper \
  -zkPort 2191
You can use Zooinspector to browse the Zookeeper instance.
Start Pinot Controller
export JAVA_OPTS="-Xms4G -Xmx8G -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -Xloggc:gc-pinot-controller.log"
./bin/pinot-admin.sh StartController \
    -zkAddress localhost:2191 \
    -controllerPort 9000
Start Pinot Broker
export JAVA_OPTS="-Xms4G -Xmx4G -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -Xloggc:gc-pinot-broker.log"
./bin/pinot-admin.sh StartBroker \
    -zkAddress localhost:2191
Start Pinot Server
export JAVA_OPTS="-Xms4G -Xmx16G -XX:+UseG1GC -XX:MaxGCPauseMillis=200 -Xloggc:gc-pinot-server.log"
./bin/pinot-admin.sh StartServer \
    -zkAddress localhost:2191
Start Kafka
./bin/pinot-admin.sh  StartKafka \ 
  -zkAddress=localhost:2191/kafka \
  -port 19092
Once your cluster is up and running, you can head over to Exploring Pinot to learn how to run queries against the data.
Basics - Previous
Getting Started
Running Pinot in Docker
Last modified 2mo ago
Copy link
Outline
Download Apache Pinot
Start Pinot Controller
Start Pinot Broker
Start Pinot Server
Start Kafka