.. _systemd-ubuntu-debian-install:

=================================================
Manual Install using Systemd on Ubuntu and Debian
=================================================

This topic provides instructions for installing a production-ready |cp| configuration in a multi-node Ubuntu or Debian environment
with a replicated |zk| ensemble.

With this installation method, you connect to every node manually to run the |cp| installation commands. 

.. include:: ../includes/installing-cp.rst
    :start-after: all-nodes-start
    :end-before: all-nodes-end

Get the Software
================

The APT repositories provide packages for Debian-based Linux distributions such as Debian and Ubuntu. You can install
individual |cp| packages or the entire platform. For a list of available packages, see the :ref:`documentation <available_packages>`
or you can search the repository (``apt-cache search <package-name>``).

.. include:: ../includes/installing-cp.rst
    :start-after: tip-for-available-packages-start
    :end-before: tip-for-available-packages-end

#.  Install the Confluent public key. This key is used to sign the packages in the APT repository.

    .. codewithvars:: bash

          wget -qO - https://packages.confluent.io/deb/|version|/archive.key | sudo apt-key add -

    Your output should resemble:

    .. codewithvars:: bash

      OK

#.  Add the repository to your ``/etc/apt/sources.list`` by running this command:

    .. codewithvars:: bash

          sudo add-apt-repository "deb [arch=amd64] https://packages.confluent.io/deb/|version| stable main"

#.  Update apt-get and install the entire |cp| platform.

    - |cp|:

      .. codewithvars:: bash

          sudo apt-get update && sudo apt-get install confluent-platform-|scala_version|

    - |cp| with :ref:`RBAC <rbac-overview>`:

      .. codewithvars:: bash

          sudo apt-get update && sudo apt-get install confluent-platform-|scala_version| && \
          sudo apt-get install confluent-server

    - |cc-components|:

      .. codewithvars:: bash

          sudo apt-get update && sudo apt-get install confluent-community-|scala_version|

    .. include:: ../includes/installing-cp.rst
        :start-after: tip_for_installation
        :end-before: tip-for-available-packages-start

    Your output should resemble:

    .. codewithvars:: bash

        ...
        Setting up confluent-schema-registry (|release|-1) ...
        Notice: Not creating existing directory /var/log/confluent, ensure proper permissions for user cp-schema-registry group confluent
        Notice: If you are planning to use the provided systemd service units for
        Notice: confluent-schema-registry, make sure that read-write permissions
        Notice: for user cp-schema-registry and group confluent are set up according to the
        Notice: following commands:
        chown cp-schema-registry:confluent /var/log/confluent && chmod u+wx,g+wx,o= /var/log/confluent

        Setting up confluent-platform-|scala_version| (|release|-1) ...


Configure |cp|
==============

.. include:: ../../includes/secret-tip.rst

.. include:: ../includes/installing-cp.rst
    :start-after: config-options-start
    :end-before: config-options-end

----
|zk|
----

.. include:: ../../zookeeper/includes/multi-node.rst

-----
|ak|
-----

.. include:: ../../kafka/includes/multi-node.rst

----------
|c3-short|
----------

.. include:: ../includes/configuring-control-center.rst

----
|sr|
----

.. include:: ../includes/configuring-schema-registry.rst

Start |cp|
==========

.. include:: ../includes/installing-systemd.rst

Uninstall
=========

Run this command to remove |cp|, where ``<component-name>`` is either :litwithvars:`confluent-platform-|scala_version|`
(|cp|) or :litwithvars:`confluent-community-|scala_version|` (|cc-components|).

.. codewithvars:: bash

    sudo apt-get remove <component-name>


For example, run this command to remove |cp|:

.. codewithvars:: bash

    sudo apt-get remove confluent-platform-|scala_version|

Your output should resemble:

.. codewithvars:: bash

    (Reading database ... 79286 files and directories currently installed.)
    Removing confluent-platform-|scala_version| (|release|-1) ...


Next Steps
==========

Try out the :ref:`quickstart`.