The EDB DMS agent (packaged as cdcagent) is versioned and released independently of Hybrid Manager (HM). New HM releases and new migration features often require a minimum cdcagent version, so you may need to upgrade an already installed agent.
Before you upgrade, check the minimum cdcagent version your HM release requires. See DMS agent version compatibility.
Upgrade the package
To upgrade to the latest available version, run the following command as a user with sudo privileges:
sudo apt-get install -y --only-upgrade cdcagent
sudo dnf upgrade -y cdcagent
sudo zypper update -y cdcagent
To pin a specific version instead of taking the latest, append the version to the package name and run the command as a user with sudo privileges:
sudo apt-get install -y cdcagent=<version>
sudo dnf install -y cdcagent-<version>
sudo zypper install cdcagent=<version>
Verify the upgrade
Confirm the new version is installed:
dpkg -l cdcagentrpm -q cdcagent
rpm -q cdcagent
Then check the agent directory:
ls -la /opt/cdcagent/
The upgrade regenerates the runtime files (run-cdcagent.sh, quarkus-run.jar) with new timestamps. It doesn't touch your own configuration — any environment variables you set in run-cdcagent.sh for a source or destination carry over untouched, so you don't need to reconfigure the agent after an upgrade.
Restart the agent
Upgrading the package doesn't restart an agent that's already running. Linux lets you replace a package's files on disk while a process still has them open, so the running agent keeps using the old version in memory until you restart it. You don't need to stop the agent before you upgrade — only before you start the new version.
Stop the running agent.
If it's running in the foreground of the terminal session where you started it, stop it with Ctrl+C.
If it's running detached from a terminal (for example, in the background or under
nohup), find and stop the process instead:ps aux | grep quarkus-run kill <pid>
Restart the agent using your existing configuration:
cd /opt/cdcagent ./run-cdcagent.shCheck the agent's startup output to confirm it reports the new version before you rely on it for a migration.