.. _controlcenter_upgrade:

Upgrading Control Center
========================

Upgrading from version 3.0.0
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

 NOTE: the upgrade process will delete historical stream monitoring data older than the configured retention time (``confluent.monitoring.interceptor.topic.retention.ms``) for the stream monitoring topic.

 #. Stop the Control Center process

 #. Copy the 3.0.0 configuration file

     .. sourcecode:: bash

       $ sudo cp /etc/confluent-control-center/control-center.properties /etc/confluent-control-center/control-center-3.0.0.properties

 #. Upgrade to version 3.0.1

     .. sourcecode:: bash

       $ # Via yum
       $ sudo yum update confluent-control-center
       $ # Via apt-get
       $ sudo apt-get update && apt-get upgrade confluent-control-center

 #. Reset the application (deleting internal state)

     .. sourcecode:: bash

       $ # Use the same properties file you used to launch Control Center
       $ /usr/bin/control-center-3_0_0-reset /etc/confluent-control-center/control-center-3.0.0.properties

 #. Edit the Control Center properties file.  Some :ref:`configuration property names <controlcenter_configuration>` have changed

     * Change ``confluent.controlcenter.id`` from ``0`` to ``1``.  This isn't strictly necessary but a good precaution in case any step of the reset failed.

 #. Start Control Center

     .. sourcecode:: bash

       $ /usr/bin/control-center-start /etc/confluent-control-center/control-center.properties