로컬 설치

로컬 설치 (Local)

컨테이너 없이 로컬 머신에서 Pinot 클러스터를 직접 실행하는 방법이에요. 개발이나 디버깅 목적으로 ZooKeeper, Controller, Broker, Server, Minion을 각각 따로 띄워 보며 구조를 익히기 좋아요.

출처: Local

본문

이 페이지를 마치면 알게 되는 것 (Outcome)

컨테이너 없이 멀티 컴포넌트 Pinot 클러스터를 자신의 머신에서 직접 시작할 수 있어요.

사전 요구 사항 (Prerequisites)

  • JDK 25 이상 (Pinot 서비스 빌드 및 실행에 필요)
  • Apache Maven 3.6+ (소스에서 빌드할 때만 필요)

💡 참고: SPI 및 Java/JDBC 클라이언트 모듈(pinot-spi, pinot-java-client, pinot-jdbc-client)은 외부 JVM 소비자를 위해 Java 11과의 호환성을 유지해요.

단계 (Steps)

1. Apache Pinot 다운로드 또는 빌드

릴리스 다운로드:

export PINOT_VERSION=1.5.1

wget https://downloads.apache.org/pinot/apache-pinot-${PINOT_VERSION}/apache-pinot-${PINOT_VERSION}-bin.tar.gz

현재 안정 릴리스 버전은 버전 레퍼런스 페이지에서 확인할 수 있어요.

압축을 풀고 디렉터리로 들어갑니다:

tar -zxvf apache-pinot-${PINOT_VERSION}-bin.tar.gz
cd apache-pinot-${PINOT_VERSION}-bin

소스에서 빌드:

💡 사전 요구 사항: Apache Maven 3.6 이상을 설치하세요.

git clone https://github.com/apache/pinot.git
cd pinot
mvn install package -DskipTests -Pbin-dist
cd build

Homebrew:

brew install pinot

2. ZooKeeper 시작

./bin/pinot-admin.sh StartZookeeper \
  -zkPort 2181

3. Pinot Controller 시작

export JAVA_OPTS="-Xms4G -Xmx8G"
./bin/pinot-admin.sh StartController \
    -zkAddress localhost:2181 \
    -controllerPort 9000

4. Pinot Broker 시작

export JAVA_OPTS="-Xms4G -Xmx4G"
./bin/pinot-admin.sh StartBroker \
    -zkAddress localhost:2181

5. Pinot Server 시작

export JAVA_OPTS="-Xms4G -Xmx16G"
./bin/pinot-admin.sh StartServer \
    -zkAddress localhost:2181

6. Pinot Minion 시작 (선택)

export JAVA_OPTS="-Xms4G -Xmx4G"
./bin/pinot-admin.sh StartMinion \
    -zkAddress localhost:2181

7. Kafka 시작 (선택)

실시간 스트리밍 데이터를 수집할 계획일 때만 필요해요.

./bin/pinot-admin.sh StartKafka \
  -zkAddress=localhost:2181/kafka \
  -port 19092

확인 (Verify)

Controller가 정상인지 확인합니다:

curl localhost:9000/health

응답은 OK를 반환해야 해요. http://localhost:9000에서 Pinot Query Console을 열 수도 있어요.

다음 단계 (Next step)

클러스터가 실행 중이에요. 데이터를 로드하려면 첫 테이블과 스키마로 계속 진행하세요.

더 알아보기 (Learn more)