|author||Pawas Chhokra <email@example.com>||Thu Dec 24 11:20:54 2020 -0800|
|committer||GitHub <firstname.lastname@example.org>||Thu Dec 24 11:20:54 2020 -0800|
SAMZA-2605: Make Standby Container Requests Rack Aware (#1446) Feature: The aim of this feature is to make all standby container requests rack aware such that all active containers and their corresponding standby containers are always on different racks. This helps with decreased downtime of applications during rack failures. One of the requirements of this feature is that the value of job.standbytasks.replication.factor is at max 2 for the rack awareness functionality to be honored. Changes: This PR uses the FaultDomainManager interface for Yarn to request for rack aware nodes while making standby container requests. Usage Instructions: For a job with host affinity and standby containers, set the config cluster-manager.fault-domain-aware.standby.enabled to true to enable this feature.
Apache Samza is a distributed stream processing framework. It uses Apache Kafka for messaging, and Apache Hadoop YARN to provide fault tolerance, processor isolation, security, and resource management.
Samza's key features include:
To build Samza from a git checkout, run:
./gradlew clean build
To build Samza from a source release, it is first necessary to download the gradle wrapper script above. This bootstrapping process requires Gradle to be installed on the source machine. Gradle is available through most package managers or directly from its website. To bootstrap the wrapper, run:
gradle -b bootstrap.gradle
After the bootstrap script has completed, the regular gradlew instructions below are available.
./gradlew -PscalaSuffix=2.11 clean build
To run all tests:
./gradlew clean test
To run a single test:
./gradlew clean :samza-test:test -Dtest.single=TestStatefulTask
To run key-value performance tests:
./gradlew samza-shell:kvPerformanceTest -PconfigPath=file://$PWD/samza-test/src/main/config/perf/kv-perf.properties
To run yarn integration tests:
./bin/integration-tests.sh <dir> yarn-integration-tests
To run standalone integration tests:
./bin/integration-tests.sh <dir> standalone-integration-tests
./gradlew checkstyleMain checkstyleTest
To run a job (defined in a properties file):
./gradlew samza-shell:runJob -PconfigPath=/path/to/job/config.properties
To inspect a job's latest checkpoint:
./gradlew samza-shell:checkpointTool -PconfigPath=/path/to/job/config.properties
To modify a job's checkpoint (assumes that the job is not currently running), give it a file with the new offset for each partition, in the format
./gradlew samza-shell:checkpointTool -PconfigPath=/path/to/job/config.properties \ -PnewOffsets=file:///path/to/new/offsets.properties
To get Eclipse projects, run:
For IntelliJ, run:
Apache Samza is a top level project of the Apache Software Foundation.