Skip to main content

Upgrading the Call Telemetry Appliance

  • Open a ssh client on TCP port 2222.
    • Port 22 is dedicated for SFTP and CDR only, no OS user can login to it.
  • The default credentials calltelemetry/calltelemetry
    • (but you changed the password from the defaults - right? 👍 just use the 'passwd' command if not)
tip

Upgrades now require 8GB of ram minimum.

Run the following script from the shell to update the appliance.

sudo curl https://get.calltelemetry.com | sudo sh -s -- update

Upgrade or Downgrade to a Specific Version​

sudo curl https://get.calltelemetry.com | sudo sh -s -- update 0.8.4-rc172

Air-Gapped Upgrades​

For installations in secure or offline environments without internet access, see the Air-Gapped Upgrade Guide.

Air-gapped upgrades are supported in version 0.7.9 and later.

CLI Command Reference​

For complete CLI documentation including database operations, system maintenance, and troubleshooting commands, see the CLI Reference Guide.

Common Commands​

# Upgrade to latest version
sudo curl https://get.calltelemetry.com | sudo sh -s -- update

# Upgrade to specific version
sudo curl https://get.calltelemetry.com | sudo sh -s -- update 0.8.4-rc172

# Rollback after failed upgrade
sudo curl https://get.calltelemetry.com | sudo sh -s -- rollback

# Check migration status
sudo curl https://get.calltelemetry.com | sudo sh -s -- migration_status

# Create database backup
sudo curl https://get.calltelemetry.com | sudo sh -s -- backup

Possible Upgrade Issues​

Upgrade failure due to system requirements​

Beginning with 0.8.4, the appliance now requires a minimum of 8GB RAM (up from 6GB in earlier releases).

The upgrade script validates system requirements. If upgrade is blocked:

  • RAM: Requires minimum 7.5GB available memory (8GB assigned for v0.8.4+)
  • Disk: Requires minimum 10% free space
  • Docker: Requires version 26 or higher

If you're having trouble at that point, you can add cpus easily. Disk space may be more tricky. Contact me for help if you have support. You may want to upgrade the appliance especially if you were an early adopter before 2023, and have CentOS Stream 9 Applaince.

But for general system things - here are some quick commands to check around for RAM, Disk, and Docker version to confirm things:

free -h              # Check RAM
df -h                # Check disk space
docker --version     # Check Docker version

Failed Migration​

If an upgrade fails during database migration:

  1. Check migration status:
sudo curl https://get.calltelemetry.com | sudo sh -s -- migration_status
  1. Review logs for errors:
sudo docker logs calltelemetry-web -f
  1. If a migstuck, try manual migration:
sudo curl https://get.calltelemetry.com | sudo sh -s -- migration_run

Rollback After Failed Upgrade​

If an upgrade fails, you can rollback to the previous configuration using:

# Rollback to previous configuration
sudo curl https://get.calltelemetry.com | sudo sh -s -- rollback

Kubernetes Updates​

Visit our Kubernetes documentation for the latest instructions around Kubernetes updates. The Kubernetes deployment is in process of some major changes.

Last updated on by Call Telemetry