Skip to main content

Upgrading Data Formulator requires careful planning to minimize downtime and ensure data integrity. The upgrade process varies depending on the version jump and deployment configuration.

Pre-upgrade Preparation

Before starting any upgrade, create a complete system backup including databases, configuration files, and custom integrations. Review the release notes for breaking changes and new requirements.

Stop all Data Formulator services:


Bash
sudo systemctl stop dataformulator
sudo systemctl stop dataformulator-worker

Ubuntu Upgrade Process​

Download the latest version:


Bash
wget https://releases.dataformulator.com/latest/dataformulator-ubuntu.tar.gz
tar -xzf dataformulator-ubuntu.tar.gz

Run the upgrade script:​


Bash
sudo ./upgrade.sh --backup-config

The upgrade script automatically handles database migrations and configuration updates while preserving custom settings.

RHEL8 Upgrade Process​

For RHEL8 systems, the upgrade process includes additional SELinux policy updates:

Bash
wget https://releases.dataformulator.com/latest/dataformulator-rhel8.tar.gz
tar -xzf dataformulator-rhel8.tar.gz
sudo ./upgrade-rhel.sh --preserve-selinux

Post-upgrade Verification​

After upgrading, verify system functionality:


Bash
sudo systemctl start dataformulator
curl http://localhost:8080/health