Upgrade Meta Service

Overview

This guide will walk you through the process of upgrading your Databend Meta Service to a newer version. The upgrade process involves downloading the new release package, replacing the binary, and restarting the service.

Download New Release

1. Follow the download instructions in Prepare Package Environment to download the new release package.

2. Extract the package:

   tar xzf databend-v1.2.755-nightly-x86_64-unknown-linux-gnu.tar.gz

Upgrade Meta Service

1. Check the current cluster status:

   databend-metactl status

   Verify that all nodes are healthy and note the current leader node.

2. Replace the binary files:

   sudo cp bin/databend-meta /usr/bin/
   sudo cp bin/databend-metactl /usr/bin/
   sudo chmod +x /usr/bin/databend-meta
   sudo chmod +x /usr/bin/databend-metactl

3. Restart the Meta Service:

   sudo systemctl restart databend-meta

4. Check the service status:

   # Check the service is running
   sudo systemctl status databend-meta

5. Verify the upgrade:

   # Check the cluster status
   databend-metactl status

Troubleshooting

If you encounter issues during the upgrade:

1. Check the service status:

   sudo systemctl status databend-meta

2. View the logs for detailed error messages:

   sudo journalctl -u databend-meta -f

3. If the upgrade fails, you can rollback by:

   • Restoring the previous binary
   • Restarting the service

Next Steps

After successfully upgrading the Meta Service, you can:

• Scale Meta Service Nodes (for multi-node deployment)
• Upgrade Query Service (if needed)