-
Notifications
You must be signed in to change notification settings - Fork 56
Building Cruise Control
The instructions provided below specify the steps to build Cruise Control 2.5.141 on Linux on IBM Z for following distributions:
- RHEL (8.8, 8.10, 9.2, 9.4)
- SLES (15 SP5, 15 SP6)
- Ubuntu (20.04, 22.04, 24.04, 24.10)
General Notes:
-
When following the steps below please use a standard permission user unless otherwise specified.
-
A directory
/<source_root>/
will be referred to in these instructions, this is a temporary writable directory anywhere you'd like to place it.
If you want to build Cruise Control using manual steps, go to STEP 2.
Use the following commands to build Cruise Control using the build script. Please make sure you have wget
installed.
wget -q https://raw.githubusercontent.com/linux-on-ibm-z/scripts/master/CruiseControl/2.5.141/build_cruise_control.sh
# Build Cruise Control
bash build_cruise_control.sh [Provide -j (Temurin11|Semeru11|OpenJDK11) option for building with specific java, Provide -t option for executing build with tests ]
If the build completes successfully, go to STEP 6 for test execution. In case of error, check logs
for more details or go to STEP 2 to follow manual build steps.
export SOURCE_ROOT=/<source_root>/
-
RHEL (8.8, 8.10)
sudo yum install -y wget tar git curl gzip procps-ng
-
RHEL (9.2, 9.4)
sudo yum install -y --allowerasing wget tar git curl gzip procps-ng
-
SLES (15 SP5, 15 SP6)
sudo zypper install -y wget tar git-core curl gzip gawk
-
Ubuntu (20.04, 22.04, 24.04, 24.10)
sudo apt-get update sudo apt-get install -y wget tar git curl gzip
Note: If you are building Apache Kafka from source, it is recommended to choose the same JDK variant for building Cruise Control.
-
With IBM Semeru Runtime
- Download and install IBM Semeru Runtime (Java 11) from here.
-
With Eclipse Adoptium Temurin Runtime
- Download and install Eclipse Adoptium Temurin Runtime (Java 11) from here.
-
With OpenJDK 11
- RHEL (8.8, 8.10, 9.2, 9.4)
sudo yum install -y java-11-openjdk java-11-openjdk-devel
- SLES (15 SP5, 15 SP6)
sudo zypper install -y java-11-openjdk java-11-openjdk-devel
- Ubuntu (20.04, 22.04, 24.04, 24.10)
sudo apt-get install -y openjdk-11-jdk
- RHEL (8.8, 8.10, 9.2, 9.4)
Note: At the time of creation of these build instructions, Cruise Control was verified with Semeru and Temurin runtime version 11.0.23.0 (build 11.0.23+9).
export JAVA_HOME=<path to java>
export PATH=$JAVA_HOME/bin:$PATH
cd $SOURCE_ROOT
git clone -b 2.5.141 https://github.com/linkedin/cruise-control.git
cd cruise-control
./gradlew jar
cd $SOURCE_ROOT/cruise-control
./gradlew test --continue
Notes:
-
When using the distribution's openjdk-11 packages on RHEL 9.x and SLES 15.x, the following tests will fail if the DEFAULT system wide crypto-policy mode is in effect:
The tests will pass if the LEGACY crypto-policy mode is in effect or if the crypto-policy package is not installed. The same tests also fail on x86_64 RHEL 9.x and SLES 15.x.
com.linkedin.kafka.cruisecontrol.metricsreporter.CruiseControlMetricsReporterSslTest > testUpdatingMetricsTopicConfig com.linkedin.kafka.cruisecontrol.metricsreporter.CruiseControlMetricsReporterSslTest > testReportingMetrics com.linkedin.kafka.cruisecontrol.metricsreporter.CruiseControlMetricsReporterSslTest > testGetKafkaBootstrapServersConfigure
Follow official quickstart guide given here to verify the installation. The Cruise Control server requires connection to one or more Apache Kafka servers, Apache Kafka can be downloaded from here
Notes:
- The default capacity configuration file (
config/capacityJBOD.json
) assumes that at least two Kafka brokers should be present, so you might need to modify the Kafka server configuration accordingly. Please check the wiki page for more configuration options.
The information provided in this article is accurate at the time of writing, but on-going development in the open-source projects involved may make the information incorrect or obsolete. Please open issue or contact us on IBM Z Community if you have any questions or feedback.