.. _enterprise_migration:

Migrate to |cp|
^^^^^^^^^^^^^^^

Migrating from |cc-components|
----------------------------------------------

The migration path to |cp| depends on how you originally installed Confluent Open Source download (5.0.x and earlier) or |cc| download
(5.0.x and later).

DEB Packages via apt or RPM Packages via yum
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

The |cp| packages are umbrella packages that contain everything in |cc-components| plus additional enterprise
packages. You can install the additional enterprise packages in your existing community deployment by running:

.. codewithvars:: bash

      sudo yum install confluent-platform-|scala_version|

or

.. codewithvars:: bash

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


TAR or ZIP archives
~~~~~~~~~~~~~~~~~~~

If you installed |cc-components| from TAR or ZIP archives, you must download and install a new |cp| archive that contains the entire platform.

* Download the |cp| TAR or ZIP archive from https://www.confluent.io/download/.
* Extract the contents of the archive into a new |cp| install directory. For ZIP files, use a GUI to extract the contents or run this command in a terminal:

.. codewithvars:: bash

        unzip confluent-|release|-|scala_version|.zip

.. codewithvars:: bash

        tar xzf confluent-|release|-|scala_version|.tar.gz

* Copy all configuration files from ./etc, including ``./etc/kafka``, ``./etc/kafka-rest``, ``./etc/schema-registry``, and ``./etc/confluent-control-center`` into the new directory you created in previous step.
* Stop all |ak-tm| services running in the |cc-components| directory. Depending on what was running, this will include kafka-rest, schema-registry, connect-distributed, kafka-server and zookeeper-server.
* Start the corresponding services in the |cp| directory, and in addition start any new Enterprise services you wish you use - for example confluent-control-center.
* Repeat these steps on all Confluent servers, one server at a time, to perform rolling migration.
* If at any time you want to move back to |cc-components|, simply stop the services in the |cp| installation directory and start them in the |cc-components| directory.



Migrating from |ak|
---------------------------

Download and install a new |cp| archive that contains the entire platform.

* Download the |cp| TAR or ZIP archive from https://www.confluent.io/download/.
* Extract the contents of the archive into a new |cp| install directory. For ZIP files, use a GUI to extract the contents or run this command in a terminal:

.. codewithvars:: bash

        unzip confluent-|release|-|scala_version|.zip

For TAR files run this command:

.. codewithvars:: bash

        tar xzf confluent-|release|-|scala_version|.tar.gz

* Copy all configuration files from ./etc, including ``./etc/kafka``, ``./etc/kafka-rest``, ``./etc/schema-registry``, and ``./etc/confluent-control-center`` into the new directory you created in previous step.
* Stop all |ak| services running in the |cc-components| directory. Depending on what was running, this will include kafka-rest, schema-registry, connect-distributed, kafka-server and zookeeper-server.
* Start the corresponding services in the |cp| directory, and in addition start any new Enterprise services you wish you use - for example confluent-control-center.
* Repeat these steps on all Confluent servers, one server at a time, to perform rolling migration.
* If at any time you want to move back to |cc-components|, simply stop the services in the |cp| installation directory and start them in the |cc-components| directory.