============================================================
Kafka Essentials

Lesson 1.3 Running Kafka on the LHM Virtual Machine 
Date: 2023-06
Kafka Version: 2.12
Python Version: 3.7.4
OS: Linux, Platform: CentOS 7.7
Virtual Machine: LHM V2-beta8
============================================================


# The following steps explain how load and start the Linux Hadoop Minimal Virtual Machine 
# (LHM-VM) and download the course example files. A full explanation of how to install
# the LHM-VM (with videos) is provided at the following location:

  https://www.clustermonkey.net/scalable-analytics/doku.php?id=linux_hadoop_minimal_installation_instructions_version_2

# If you are using Linux or Mac, a terminal application is available that includes 
# an "ssh client."
  
# If you are using Windows, you will need an "ssh client." Either of the following
# will work. They are both freely available at no cost. (MobaXterm is recommended)
# Note: Use MobaXterm if you want to use the Kafkaesque graphical tool.
  
#   - Putty (http://www.putty.org) - provides terminal for ssh session.
#   - MobaXterm (http://mobaxterm.mobatek.net) - provides terminal for ssh sessions 
#     and allows remote X Windows session.
  
# See Linux Hadoop Minimal Installation Instructions (link above) for the installation
# instructions and how to start the Linux Hadoop Minimal Virtual Machine (LHM-VM)

When the LHM-VM is Started 
==========================

# Open a terminal (Terminal Application on Mac, on Windows use Putty or MobaXterm)
# and enter the following to log into the LHM-VM as user "hands-on" (password="minimal")

  ssh hands-on@127.0.0.1 -p 2222

# Once you are logged in to the LHM-VM, you should see the following prompt string:

  [hands-on@localhost ~]$

# The "[hands-on@localhost ~]" will not be shown in the rest of the Lesson documentation.
# A "$" will indicate the prompt string for input.

# To download the examples and NOTES.txt files used in these LiveLessons into
# the LHM-VM, pull down and extract the course files (from inside the LHM-VM) 
# as shown below:

  $ wget https://www.clustermonkey.net/download/LiveLessons/Kafka_Essentials/Kafka_Essentials.tgz

# NOTE: It may be necessary to include the "--no-check-certificate" if there is an issue
# with downloading the archive.

# Extract the archive in the hands-on directory.

  $ tar xvzf Kafka_Essentials.tgz

# Once extracted, there should be a new directory called "Kafka_Essentials-V1"
# NOTE: it is possible the version tag ("V1") may be different.
# A listing of the directory will show the following:

  $ ls Kafka_Essentials-V1/
  Lesson-01-Background                        Lesson-05-Image-Streaming README.contact
  Lesson-02-Viewing-Kafka                     Lesson-06-Kafka-Connect   README.copyright
  Lesson-03-Streaming-Data-with-Kafka-Python  Lesson-07-Installation    README.python-libs
  Lesson-04-Moving-Data-to-External-Storage   Lesson-08-Administration