Single Kafka Cluster

This tutorial is helpful for users who are running a single kafka cluster.

Assumptions

1. Your kafka cluster is up and running (and zookeeper as well)
2. Cruise Control is setup correctly and running
3. Cruise Control is configured to listen on port 9090 (any configured port)
4. Cruise Control REST API is available under /kafkacruisecontrol path (Modern CC has this set in cruise-control/config/cruisecontrol.properties with variable webserver.api.urlprefix)
5. Cruise Control UI webapp directory is configured under ./cruise-control-ui/dist (relative to cruise-control folder). Modern CC has this variable controlled via webserver.ui.diskpath property in the cruise-control/config/cruise-control.properties file.

Setting up Cruise Control Frontend

1. Download the latest compiled artifacts from https://github.com/linkedin/cruise-control-ui/releases page

This will have the following files once extracted

/home/user/Downloads $ tar zxvf cruise-control-ui.tar.gz 
cruise-control-ui/
cruise-control-ui/dist/
cruise-control-ui/README.txt
cruise-control-ui/dist/index.html
cruise-control-ui/dist/static/
cruise-control-ui/dist/static/cc-logo.png
cruise-control-ui/dist/static/css/
cruise-control-ui/dist/static/js/
cruise-control-ui/dist/static/config.csv
cruise-control-ui/dist/static/js/manifest.js
cruise-control-ui/dist/static/js/vendor.js
cruise-control-ui/dist/static/js/app.js
cruise-control-ui/dist/static/css/app.css
cruise-control-ui/dist/static/css/app.css.map

2. Copy the cruise-control-ui.tar.gz to the server where your Cruise Control is running

scp cruise-control-ui.tar.gz [email protected]:/tmp/

3. Extract the cruise-control-ui.tar.gz inside the cruise-control runtime

ssh [email protected]
cd /opt/cruise-control/
sudo tar zxvf /tmp/cruise-control-ui.tar.gz

4. Update the config.csv so that webapp can reach the Cruise Control Server

ssh [email protected]
cd /opt/cruise-control/cruise-control-ui/static/
cat config.csv
dev,dev,/kafkacruisecontrol

NOTE: /kafkacruisecontrol is relative to CC which is listening on 0.0.0.0 & port 9090. So all requests made by CCFE will go to http://0.0.0.0:9090/kafkacruisecontrol end point

5. Hit the Cruise Control host & port in the browser to access CCFE

http://cc-host.example.com:9090/

Few Notes

URL portion in the config.csv (third value in CSV row) is relative to the webserver in which the CCFE is deployed. So, please take some extra caution understanding how the URL routing happens.