CONFLUENT PLATFORM
Important
confluent.metrics.topic.skip.backlog.minutes
confluent.monitoring.interceptor.topic.skip.backlog.minutes
Version 6.0.1 of Confluent Platform includes the option to enable the Cluster Registry for Control Center, which creates a more user-friendly RBAC role binding experience and enables centralized audit logging.
Note
For details on all new feature flags for Cluster Registry in Control Center, see the section on Cluster Registry Settings.
If you are upgrading from 6.0.0 to 6.0.1:
Export your cluster information from the command store and then import it into Cluster Registry using the migration scripts described below.
Configure Control Center to talk to MDS and RBAC.
Add the following property to the control-center.properties file:
control-center.properties
confluent.metadata.cluster.registry.enable=true
If you are upgrading from 5.5.x to 6.0.1:
To upgrade existing Control Center components from versions 5.5.x and prior to 6.0.x, you need to transition your existing cluster data from command store to Cluster Registry. You can do this easily using import and export scripts.
Only MDS broker super.user or MDS broker SystemAdmin roles can successfully execute the migration scripts.
Export Script
To export cluster information from the command store into a .json file:
.json
Confirm that your Kafka broker is up and running.
Run the export command script:
./control-center-export --cluster propertiesFilePath --outfile outputfilePath
The path to the Control Center properties file.
The path for the .json file where you want save your output.
Import Script
To read the cluster information from the provided .json file and register the clusters with Cluster Registry:
Confirm that MDS is up and running.
Run the import command script:
cluster-information-migration-script [-i import] [-u url] [-p properties-file] -f clusters-file
The properties file for providing the MDS url, username, and password.
The .json file for importing and exporting cluster information.
Upgrade Apache Kafka® brokers to your target Confluent Platform release. Follow instructions in Confluent Platform Upgrade Guide.
Upgrade the monitoring interceptors in all Kafka clients to your target Confluent Platform version (this is optional if you are using Confluent Platform interceptors 3.1 version and later).
Stop the Control Center process.
Make a backup of your current version configuration file. For example, copy and rename as control-center-3.1.properties.
control-center-3.1.properties
sudo cp /etc/confluent-control-center/control-center.properties /etc/confluent-control-center/control-center-3.1.properties
Upgrade Control Center packages to your target version.
Edit the Control Center properties file. Configuration property names may have changed between versions.
confluent.controlcenter.streams.{producer,consumer}.{sasl,ssl}.*
confluent.controlcenter.streams.{sasl,ssl}.*
Start Control Center. For more information about starting Confluent Platform, see On-Premises Deployments.
<path-to-confluent>/bin/control-center-start <path-to-confluent>/etc/confluent-control-center/control-center.properties
If you have authentication and authorization configured, you must run control-center-set-acls to give Control Center permission to create topics. For more information, see Configuring Control Center to work with Kafka ACLs.
control-center-set-acls
Upgrade Kafka brokers to Confluent Platform 3.1
Upgrade the monitoring interceptors in all Kafka clients to Confluent Platform 3.1
Stop the Control Center process
Copy the 3.0.x configuration file
sudo cp /etc/confluent-control-center/control-center.properties /etc/confluent-control-center/control-center-3.0.properties
Upgrade Control Center packages to Confluent Platform 3.1
Reset the application (deleting internal state)
# Use the same properties file you used to launch |c3-short| # From 3.0.1 /usr/bin/control-center-3_0_1-reset /etc/confluent-control-center/control-center-3.0.properties # From 3.0.0 /usr/bin/control-center-3_0_0-reset /etc/confluent-control-center/control-center-3.0.properties
Edit the Control Center properties file. Some configuration property names have changed
confluent.controlcenter.name
Start Control Center
/usr/bin/control-center-start /etc/confluent-control-center/control-center.properties