Overview
If the current instance specifications cannot meet your business needs, you can upgrade them in the console.
Note:
- The instance specifications you can upgrade include peak bandwidth, disk capacity, and the number of topics/partitions. You can also increase the disk capacity only. The upgrade is smooth without suspending your services.
- Upgrading the configuration may add new ports, which you can view by clicking Access Mode > View All IPs and Ports on the instance details page. When configuring the security group, you need to open all these ports.
Prerequisites
Check the following items before upgrading:
- Check whether the instance has unavailable public network routes, supporting networks, VPC networks, etc. For more information, see Adding Routing Policy.
- Check whether the instance has unsynced replicas. For more information, see Viewing Topic.
- Check whether the instance has unfinished tasks (data migration), abnormally created topics, abnormally deleted topic data, etc.
Note:
If there are unfinished tasks, we recommend you wait for all the tasks to be completed before upgrading. If task execution is abnormal, submit a ticket for assistance.
Directions
- Log in to the CKafka console.
- In the Operation column on the instance list page, select More > Upgrade to enter the upgrade page.
- Select the target specification for the instance.
- Click Submit to complete the instance upgrade.
- Log in to the CKafka console.
- In the Operation column on the instance list page, select More > Upgrade to enter the upgrade page.
- Select Pro Edition as the target specification type.
- Product Specification: Select a model based on the peak bandwidth and disk capacity.
- Instance Price: You need to pay for the upgrade based on the number of days.
- Rebalance Time:
- If the backend detects that data migration is required during the upgrade, you can choose to upgrade right away or at specified time (upgrade at night is recommended to reduce the impact on your business). The estimated upgrade duration is calculated by backend APIs.
- If the backend detects that data migration is not required during the upgrade, you will see the message "Rebalancing will not occur during the upgrade".
- Upgrade Mode: If the backend detects that instance migration is required during the upgrade, you can select an upgrade mode as needed. Otherwise, you do not need to select an upgrade mode.
- Stable: CKafka will limit the speed of data migration during the upgrade to ensure that instances have optimal bandwidth performance. This option is recommended if you don't want to affect business operations.
- High-speed: CKafka will not limit the speed of data migration during the upgrade, thus affecting the bandwidth available for data production and consumption of instances. This option is recommended for off-peak hours or when service suspension is allowed.
- Click Submit to complete the instance upgrade. You can view the upgrade progress in the Status column.
- If you choose to upgrade at the specified time, you can modify the time you specified in the Status column.
- Log in to the CKafka console.
- In the Operation column on the instance list page, select More > Upgrade to enter the upgrade page.
- Select the target specification for the instance.
- Product Specification: Select a model based on the peak bandwidth and disk capacity.
- Instance Price: You need to pay for the upgrade based on the number of days.
- Rebalance Time:
- If the backend detects that data migration is required during the upgrade, you can choose to upgrade right away or at specified time (upgrade at night is recommended to reduce the impact on your business). The estimated upgrade duration is calculated by backend APIs.
- If the backend detects that data migration is not required during the upgrade, you will see the message "Rebalancing will not occur during the upgrade".
- Upgrade Mode: If the backend detects that instance migration is required during the upgrade, you can select an upgrade mode as needed. Otherwise, you do not need to select an upgrade mode.
- Stable: CKafka will limit the speed of data migration during the upgrade to ensure that instances have optimal bandwidth performance. This option is recommended if you don't want to affect business operations.
- High-speed: CKafka will not limit the speed of data migration during the upgrade, thus affecting the bandwidth available for data production and consumption of instances. This option is recommended for off-peak hours or when service suspension is allowed.
- Click Submit to complete the instance upgrade. You can view the upgrade progress in the Status column.
- If you choose to upgrade at the specified time, you can modify the time you specified in the Status column.
Possible causes of upgrade failures
- The disk resources in the current AZ cannot meet the requirements of this upgrade. We recommend you contact the Tencent Cloud customer service to check whether there are sufficient resources.
- If the high-speed mode is selected during instance upgrade, and there are production tasks that use a lot of bandwidth resources in the cluster, the data migration delay will increase. You can view monitoring data to see whether there are excessive peaks of the production and consumption traffic during the upgrade.
- The upgrade process takes too long. The maximum acceptable message byte size of the migrated server configuration is 1 MB, but the broker configuration that needs to be migrated is 8 MB, so the broker cannot receive oversized message migration, resulting in prolonged data migration. Submit a ticket for assistance.
- During the upgrade or migration between the new and old clusters, the broker IP update is abnormal, causing the broker IP of the new cluster to fail to pull data. You can view monitoring data to see that there is no monitoring data for a period of time. Submit a ticket for assistance.
Was this page helpful?