.. _migrate-confluent-server: Migrate |cp| to |cs| ==================== .. include:: includes/confluent-server-intro.rst You can migrate from ``confluent-kafka`` to ``confluent-server`` using the instructions in the following sections. Note that |cs| requires that the ``confluent.license`` property be set to a valid license string in each broker properties file, and this license is checked at broker start up. For more information, see :ref:`cp-license-overview`. Prerequisites ^^^^^^^^^^^^^^ If you have already installed some packages using ``confluent-kafka``, you must remove this package before installing ``confluent-server``. You may need to run ``yum autoremove`` or ``apt autoremove`` to remove packages installed as dependencies by a previous install. Red Hat Enterprise Linux ^^^^^^^^^^^^^^^^^^^^^^^^ If your cluster was installed on Red Hat Enterprise Linux (RHEL), you can migrate from ``confluent-kafka`` to ``confluent-server`` or from ``confluent-server`` to ``confluent-kafka``. Migrating from confluent-kafka to confluent-server """""""""""""""""""""""""""""""""""""""""""""""""" Complete the following steps to migrate to ``confluent-server`` when using Red Hat Enterprise Linux (RHEL). #. Install your cluster using |ansible|. This installs ``confluent-kafka`` by default. For more information, see `Deploy with Ansible Playbooks `__. #. Start your cluster and verify that it is working as expected. #. Log in and stop each |ak| broker host. :: sudo systemctl stop confluent-kafka #. As a precaution, back up the following configuration files: :: sudo cp /etc/kafka/server.properties /tmp sudo cp /etc/systemd/system/confluent-kafka.service.d/override.conf /tmp If running with Kerberos, you must back up your JAAS file: :: sudo cp /etc/kafka/kafka_server_jaas.conf /tmp #. Use ``yum swap`` to change to ``confluent-server``: :: yum swap confluent-kafka-2.12 confluent-server #. Copy your |ak| broker configuration backup to the broker configuration directory: :: sudo cp /tmp/server.properties /etc/kafka/ #. Copy your override file using the following command: :: sudo cp /tmp/override.con /etc/systemd/system/confluent-server.service.d/ .. note:: If you are running Kerberos, complete the next step. If not, skip the next step. #. Copy your JAAS file to the broker configuration directory: :: sudo cp /tmp/kafka_server_jaas.conf /etc/kafka/ #. Start your |ak| brokers: :: sudo systemctl start confluent-server .. _migrate-cs-k: Migrating from confluent-server to confluent-kafka """""""""""""""""""""""""""""""""""""""""""""""""" Complete the following steps to change from ``confluent-server`` back to ``confluent-kafka`` when using Red Hat Enterprise Linux (RHEL). #. Log in to each |ak| broker host and stop each broker: :: sudo systemctl stop confluent-server #. As a precaution, back up the following configuration files: :: sudo cp /etc/kafka/server.properties /tmp sudo cp /etc/systemd/system/confluent-server.service.d/override.conf /tmp If running with Kerberos, you must back up your JAAS file: :: sudo cp /etc/kafka/kafka_server_jaas.conf /tmp #. Use ``yum swap`` to change to ``confluent-kafka``: :: yum swap confluent-kafka-2.12 confluent-kafka #. Copy your configuration files to the broker configuration directory: :: sudo cp /tmp/server.properties /etc/kafka/ .. note:: If you are running Kerberos, complete the next step. If not, skip the next step. #. Copy your JAAS file to the broker configuration directory: :: sudo cp /tmp/kafka_server_jaas.conf /etc/kafka/ #. Start your |ak| brokers: :: sudo systemctl start confluent-kafka Ubuntu ^^^^^^ If your cluster was installed on Ubuntu, you can migrate from ``confluent-kafka`` to ``confluent-server`` or from ``confluent-server`` to ``confluent-kafka``. Migrating from confluent-kafka to confluent-server """""""""""""""""""""""""""""""""""""""""""""""""" Complete the following steps to migrate to ``confluent-server`` when using Ubuntu. #. Install your cluster using |ansible|. This installs ``confluent-kafka`` by default. For more information, see `Deploy with Ansible Playbooks `__. #. Start your cluster and verify that it is working as expected. #. Log in and stop each |ak| broker host. :: sudo systemctl stop confluent-kafka #. As a precaution, back up the following configuration files: :: sudo cp /etc/kafka/server.properties /tmp sudo cp /etc/systemd/system/confluent-kafka.service.d/override.conf /tmp If running with Kerberos, you must back up your JAAS file: :: sudo cp /etc/kafka/kafka_server_jaas.conf /tmp #. Remove ``confluent-kafka`` from your |ak| broker hosts. :: sudo apt-get remove confluent-kafka-2.12 #. Install ``confluent-server`` on your |ak| broker hosts. :: sudo apt-get install confluent-server #. Select the default option to keep your configuration files in place. Get the backup configuration files (that you made earlier) if you accidentally replace the files. .. note:: If you are running Kerberos, complete the next step. If not, skip the next step. #. Copy your override file using the following command: :: sudo cp /etc/systemd/system/confluent-kafka.service.d/override.conf /etc/systemd/system/confluent-server.service.d #. Start your |ak| brokers: :: sudo systemctl start confluent-server Migrating from confluent-server to confluent-kafka """""""""""""""""""""""""""""""""""""""""""""""""" Complete the following steps to change from ``confluent-server`` back to ``confluent-kafka`` when using Ubuntu. #. Log in and stop each |ak| broker host. :: sudo systemctl stop confluent-server #. As a precaution, back up the following configuration files: :: sudo cp /etc/kafka/server.properties /tmp sudo cp /etc/systemd/system/confluent-kafka.service.d/override.conf /tmp If running with Kerberos, you need to back up your JAAS file: :: sudo cp /etc/kafka/kafka_server_jaas.conf /tmp #. Remove ``confluent-server`` from your |ak| broker hosts. :: sudo apt-get remove confluent-server #. Install ``confluent-kafka`` on your |ak| broker hosts. :: sudo apt-get install confluent-kafka-2.12 #. Select the default option to keep your configuration files in place. Get the backup configuration files (that you made earlier) if you accidentally replace the files. #. Start your |ak| brokers. :: sudo systemctl start confluent-kafka Related content """"""""""""""" - :ref:`migrate-ak-cc` - :ref:`cp-license-overview`