CX Agent 3.1 - Upgrade Instructions
Cisco is excited to announce the release of CX Agent 3.1, available starting September 04, 2025. This release is a major step forward in simplifying telemetry for Cisco Success Tracks, with a single, scalable setup that reduces complexity and prepares you for the future of digital CX services. See full details for the CX Agent 3.1 release.
Step by step upgrade instructions
- Check Current Version & Prerequisites
- Ensure you have at least v2.4.x installed.
- If you're on v2.3.x, you'll need to first upgrade to v2.4.x before moving to v3.1.
- If you're on v2.2.x, you'll need to first upgrade to v2.3.x, and then from v2.3.x to v2.4.x before moving to v3.1.
- Review prerequisites such as network connectivity, DNS resolution.
- Recommended to make VM snapshot before initiate upgrade for roll-back procedure (if applicable).
- Log In to CX Cloud Portal
- Access the CX Cloud portal.
- Navigate to the Admin Center, then go to Data Sources to locate your existing CX Cloud Agent entry.
- Initiate the Upgrade
- In the CX Cloud Agent detail view, find the Software tab.
- From the “Choose a software version to update to” dropdown, select the target version 3.1.
- Click Install Update to apply the upgrade. You may also choose to schedule the update by unchecking Install Now, which opens scheduling options.
- Monitor Update Procedure
- The portal will handle the installation and registration of the new agent version.
- Monitor progress via the UI; status or confirmation messages should appear upon successful upgrade.
- Post-Upgrade Tasks
- After upgrading, ensure that all data sources and telemetry connections are active and collecting properly.
- If needed, revisit configurations such as seed files, SNMP ranges, or connected data sources. These may need to be revalidated post-upgrade.
- Fallback (Optional)
If issues arise during or after the upgrade, use your VM hypervisor’s snapshot/restore feature to roll back to the previous state.
For further assistance, refer to the CX Agent FAQ, or contact the Technical Assistance Center (TAC) to open a support case.
Additional Resources: