pre-requisites.adoc

Pre-requisites for KSQL Workshop

Note	Successfully tested on: Host OS Docker Docker Compose Mac 10.13.6 18.09.2 1.24.0-rc1, build 0f3d4dda Fedora 28 18.06.1-ce, build e68fc7a 1.22.0, build f46880fe Ubuntu 18.04 18.06.1-ce, build e68fc7a 1.22.0, build f46880fe Windows 10 ? ?

• Docker

• Docker Compose

• 8GB+ RAM

• Clone github repository

• Pull required docker images

Important

THIS MUST BE DONE BEFORE THE WORKSHOP - The docker images are large and will take time to download. Please don’t wait until the workshop as the wi-fi will not cope!

1. Install Docker Compose on your system. There are Mac, Windows, and Linux options available at the link.

2. Mac/Windows only:

   In Docker’s advanced settings, increase the memory dedicated to Docker to at least 8GB.

3. Confirm that Docker has at least 8GB of memory available to it:

   docker system info | grep Memory

   Should return a value greater than 8GB - if not, the Kafka stack will probably not work.

4. Clone the workshop repo to your local machine:

   git clone https://github.com/confluentinc/demo-scene.git

5. Change to the KSQL workshop folder

   cd demo-scene/ksql-workshop

6. Pull all required docker images—this will take a while!

   docker-compose pull

7. Did you check that Docker has at least 8GB of memory available?

   • You really do need to do this

8. You may find it useful to have jq installed

   • Mac: brew install jq

   • RHEL-based: sudo yum install -y jq

   • Debian-based: sudo apt install -y jq

   • Windows: two options:

     • Install choco and then run choco install jq

     • Download from the official jq website and add to Path

9. Linux only:

   If you want to use the Elasticsearch part of the workshop then make sure the virtual memory mmap count limit is set appropriately.

   sudo sysctl -w vm.max_map_count=262144

   See the Elasticsearch docs for more info.