.. _ansible-requirements:

-------------------------
Installation Requirements
-------------------------

General Requirements
^^^^^^^^^^^^^^^^^^^^

* |cp| 5.3 or later
* Ansible 2.7 or later (on the control node)
* `Confluent Platform Ansible playbooks <https://github.com/confluentinc/cp-ansible>`__
* SSH access between Ansible hosts and all other hosts

Supported Operating Systems
^^^^^^^^^^^^^^^^^^^^^^^^^^^

* RHEL 7 or later
* Ubuntu 16.04 or later
* Debian 8 or later

Hardware Requirements
^^^^^^^^^^^^^^^^^^^^^

Refer to the |cp| component :ref:`on-premises system requirements <system-requirements>`.

Ports
^^^^^

Ansible configures |cp| components to use the following ports.

.. important::
   
   Make sure the ports identified below are open..

+-------------------------------------------+-----------------------+
| Component                                 | Port                  |
+===========================================+=======================+
| |ak| brokers: inter-broker communication  | 9091                  |
+-------------------------------------------+-----------------------+
| |ak| brokers: client communication        | 9092                  |
+-------------------------------------------+-----------------------+
| |c3|                                      | 9021                  |
+-------------------------------------------+-----------------------+
| |kconnect| REST API                       | 8083                  |
+-------------------------------------------+-----------------------+
| KSQL REST API                             | 8088                  |
+-------------------------------------------+-----------------------+
| REST Proxy                                | 8082                  |
+-------------------------------------------+-----------------------+
| |sr| REST API                             | 8081                  |
+-------------------------------------------+-----------------------+
| |zk|                                      | 2181, 2888, 3888      |
+-------------------------------------------+-----------------------+

Users
^^^^^

Each |cp| component runs under its own user set up during installation. The
usernames are prefixed with ``cp-`` followed by the component name. For example,
``cp-kafka`` and ``cp-schema-registry``. The one exception is that |zk| runs as
the ``cp-kafka`` user. 

Time synchronization
^^^^^^^^^^^^^^^^^^^^

Clock synchronization on each |ak| broker is required to ensure the full system
functions correctly. See :ref:`Time synchronization requirement
<time-sync>` for details.