.. _systemd-rhel-centos-install:

===============================================
Manual Install using Systemd on RHEL and CentOS
===============================================

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

The YUM repositories provide packages for RHEL, CentOS, and Fedora-based distributions.

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

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

The YUM repositories provide packages for RHEL, CentOS, and Fedora-based distributions. 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 (``yum search <package-name>``).

#. Install the ``curl`` and ``which`` tools.

   .. codewithvars:: bash

    sudo yum install curl which

#. Install the |cp| public key. This key is used to sign packages in the YUM repository.

   .. codewithvars:: bash

       sudo rpm --import https://packages.confluent.io/rpm/|version|/archive.key

#. Navigate to ``/etc/yum.repos.d/`` and create a file named ``confluent.repo`` with these contents. This adds the Confluent
   repository.

   .. codewithvars:: ini

        [Confluent.dist]
        name=Confluent repository (dist)
        baseurl=https://packages.confluent.io/rpm/|version|/7
        gpgcheck=1
        gpgkey=https://packages.confluent.io/rpm/|version|/archive.key
        enabled=1

        [Confluent]
        name=Confluent repository
        baseurl=https://packages.confluent.io/rpm/|version|
        gpgcheck=1
        gpgkey=https://packages.confluent.io/rpm/|version|/archive.key
        enabled=1

#. Clear the `YUM caches <https://access.redhat.com/documentation/en-US/Red_Hat_Enterprise_Linux/6/html/Deployment_Guide/sec-Working_with_Yum_Cache.html>`_
   and install |cp|.

   - |cp|:

     .. codewithvars:: bash

            sudo yum clean all && sudo yum install confluent-platform-|scala_version|

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

     .. codewithvars:: bash

            sudo yum clean all && sudo yum install confluent-platform-|scala_version| && \
            sudo yum remove confluent-kafka-2.11 && sudo yum install confluent-server

   - |cc-components|:

     .. codewithvars:: bash

          sudo yum clean all &&  sudo yum install confluent-community-|scala_version|

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

   For |cp| your output should resemble:

   .. codewithvars:: bash

    Dependency Installed:
      confluent-camus.noarch 0:|release|-1
      confluent-common.noarch 0:|release|-1
      confluent-control-center.noarch 0:|release|-1
      confluent-control-center-fe.noarch 0:|release|-1
      confluent-kafka-|scala_version|.noarch 0:|release|-1
      confluent-kafka-connect-elasticsearch.noarch 0:|release|-1
      confluent-kafka-connect-jdbc.noarch 0:|release|-1
      confluent-kafka-connect-jms.noarch 0:|release|-1
      confluent-kafka-connect-replicator.noarch 0:|release|-1
      confluent-kafka-connect-s3.noarch 0:|release|-1
      confluent-kafka-connect-storage-common.noarch 0:|release|-1
      confluent-kafka-rest.noarch 0:|release|-1
      confluent-ksql.noarch 0:|release|-1
      confluent-rebalancer.noarch 0:|release|-1
      confluent-rest-utils.noarch 0:|release|-1
      confluent-schema-registry.noarch 0:|release|-1

    Complete!


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

------------
|crest-long|
------------

.. include:: ../includes/configuring-kafka-rest.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 yum autoremove <component-name>


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

.. codewithvars:: bash

    sudo yum autoremove confluent-platform-|scala_version|

Your output should resemble:

.. codewithvars:: bash

    Loaded plugins: fastestmirror, langpacks
    Resolving Dependencies
    --> Running transaction check
    ---> Package confluent-platform-|scala_version|.noarch 0:|release|-0.1.cp2 will be erased
    ...
    Removed:
    confluent-platform-|scala_version|.noarch 0:|release|-0.1.cp2

    Dependency Removed:
    confluent-common.noarch 0:|release|-0.1.cp2 confluent-control-center.noarch 0:|release|-0.1.cp2
    confluent-control-center-fe.noarch 0:|release|-0.1.cp2 confluent-hub-client.noarch 0:|release|-0.1.cp2
    confluent-kafka-|scala_version|.noarch 0:|release|-0.1.cp2 confluent-kafka-connect-elasticsearch.noarch 0:|release|-0.1.cp2
    confluent-kafka-connect-jdbc.noarch 0:|release|-0.1.cp2 confluent-kafka-connect-jms.noarch 0:|release|-0.1.cp2
    confluent-kafka-connect-replicator.noarch 0:|release|-0.1.cp2 confluent-kafka-connect-s3.noarch 0:|release|-0.1.cp2
    confluent-kafka-connect-storage-common.noarch 0:|release|-0.1.cp2 confluent-kafka-mqtt.noarch 0:|release|-0.1.cp2
    confluent-kafka-rest.noarch 0:|release|-0.1.cp2 confluent-ksql.noarch 0:|release|-0.1.cp2
    confluent-rebalancer.noarch 0:|release|-0.1.cp2 confluent-rest-utils.noarch 0:|release|-0.1.cp2
    confluent-schema-registry.noarch 0:|release|-0.1.cp2

    Complete!


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

Try out the :ref:`quickstart`.