.. _ce-quickstart:

|cpe| Quick Start (Local)
=========================

This quick start shows you how to get up and running with |cpe| and its main components.
This quick start demonstrates both the basic and most powerful capabilities of |cpe|, including using |c3-short| for topic management and event stream processing using KSQL.
In this quick start you create Kafka topics, use Kafka Connect to generate mock data to those topics, and create KSQL streaming queries on those topics.
You then go to |c3-short| to monitor and analyze the streaming queries.

You can also run an `automated version of this quick start <https://github.com/confluentinc/examples/tree/master/pageviews>`_ designed for |cp| local installs.

.. important::
                .. include:: ../includes/java-snippet.rst

.. include:: includes/non-docker-prereqs.rst
   :start-line: 2
   :end-line: 4

.. _download-start-cp:

Step 1: Download and Start |cp|
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

#. Go to the `downloads page <https://www.confluent.io/download/>`_ and choose **Confluent Platform Enterprise**.

   .. tip:: Download a previous version from `Previous Versions <https://www.confluent.io/previous-versions/>`_.

#. Decompress the file. You should have these directories:

   .. include:: ../includes/tarball-contents.rst

#.  Add the install location of the Confluent bin directory to your `PATH <https://askubuntu.com/questions/720678/what-does-export-path-somethingpath-mean>`_: ``export PATH=<path-to-confluent>/bin:$PATH``


#.  .. include:: includes/quickstart-step3.rst
        :start-after: step-3-mid
        :end-before: step-3-run-instance-start

    .. include:: includes/cos-quickstart-datagen.rst
        :start-after: non-docker-confluenthub-start
        :end-before: non-docker-confluenthub-end

#.  Start |cp| using the :ref:`Confluent CLI <cli>` ``start`` command. 

    .. codewithvars:: bash

        <path-to-confluent>/bin/|confluent_start|

    The Confluent CLI ``start`` command starts all of the |cp| components; including Kafka,
    |zk|, |sr|, HTTP REST Proxy for Apache Kafka, Kafka Connect, KSQL, and |c3-short|. 

    .. include:: ../includes/cli.rst
       :start-after: cli_limitations_start
       :end-before: cli_limitations_end


    Your output should resemble:

    .. include:: ../includes/cli.rst
        :start-after: CE_CLI_startup_output
        :end-before: COS_CP_CLI_startup_output

.. step 2

.. include:: includes/ce-quickstart-step2.rst

.. step 3

.. include:: includes/quickstart-step3.rst
   :start-after: step-3-start
   :end-before: step-3-mid

#.  .. include:: includes/quickstart-step3.rst
       :start-after: step-3-run-instance-start
       :end-before: step-3-run-instance-end

    .. include:: includes/ce-quickstart-datagen-pageviews.rst

#.  .. include:: includes/quickstart-step3.rst
        :start-after: step-3-run-instance-end
        :end-before: step-3-run-another-instance-end

    .. include:: includes/ce-quickstart-datagen-users.rst

.. _ce-ksql-quickstart:

.. step 4

.. include:: includes/ce-quickstart-step4.rst
    :start-after: intro_start
    :end-before: intro_end

.. tip:: You can also run these commands using the :ref:`KSQL CLI <install_ksql>` from your terminal
         with this command: ``<path-to-confluent>/bin/ksql http://localhost:8088``.

.. include:: includes/ce-quickstart-step4.rst
    :start-after: intro_end

.. step 5

.. include:: includes/ce-quickstart-step5.rst

.. include:: includes/ce-quickstart-next-steps.rst