Available Cluster Configs

defaults

Sets the Java heap to 1 GB (heap_size=1g). This is the baseline configuration that all other heap-size configs extend.

heap_size: 1g

Usage:

solr-benchmark run --cluster-config defaults ...

---

1gheap

Sets the Solr JVM heap to 1 GB. Suitable for small workloads and testing.

heap_size: 1g

Usage:

solr-benchmark run --cluster-config 1gheap ...

---

2gheap

Sets the Solr JVM heap to 2 GB.

heap_size: 2g

Usage:

solr-benchmark run --cluster-config 2gheap ...

---

4gheap

Sets the Solr JVM heap to 4 GB. Suitable for larger workloads.

heap_size: 4g

Usage:

solr-benchmark run --cluster-config 4gheap ...

---

8gheap

Sets the Solr JVM heap to 8 GB.

heap_size: 8g

Usage:

solr-benchmark run --cluster-config 8gheap ...

---

16gheap

Sets the Solr JVM heap to 16 GB.

heap_size: 16g

Usage:

solr-benchmark run --cluster-config 16gheap ...

---

24gheap

Sets the Solr JVM heap to 24 GB.

heap_size: 24g

Usage:

solr-benchmark run --cluster-config 24gheap ...

---

g1gc

Enables the G1 garbage collector. Recommended for latency-sensitive benchmarks.

use_g1_gc: true

Usage:

solr-benchmark run --cluster-config g1gc ...

---

parallelgc

Enables the Parallel (throughput-optimized) garbage collector.

use_cms_gc: false
use_g1_gc: false

Usage:

solr-benchmark run --cluster-config parallelgc ...

Note: parallelgc is available in the main cluster config bundle but not in 1.0.

---

vanilla

The base cluster configuration. All other heap and GC configs extend vanilla. Use this when you want to run Solr with no heap or GC overrides beyond ASB defaults.

Usage:

solr-benchmark run --cluster-config vanilla ...

---

ea

Mixin that enables Java assertions (-ea). Useful for debugging workload runs.

Usage:

solr-benchmark run --cluster-config ea ...

---

fp

Mixin that preserves JVM frame pointers. Required for accurate async-profiler CPU profiles.

Usage:

solr-benchmark run --cluster-config fp ...

---

debug-non-safepoints

Mixin that enables more accurate CPU profiling by recording non-safepoint debug information.

Usage:

solr-benchmark run --cluster-config debug-non-safepoints ...

---

Comparing configs

To compare G1GC vs Parallel GC on the same workload:

# Run 1: G1GC
solr-benchmark run \
  --pipeline docker \
  --distribution-version 9.10.1 \
  --workload nyc_taxis \
  --cluster-config g1gc

# Run 2: Parallel GC
solr-benchmark run \
  --pipeline docker \
  --distribution-version 9.10.1 \
  --workload nyc_taxis \
  --cluster-config parallelgc

# Compare results
solr-benchmark compare \
  --baseline <g1gc-run-id> \
  --contender <parallelgc-run-id>