Upgrading Datafy

The following is relevant when installing version 1.28.0 or higher. If installing an older version, you must uninstall the existing agent before installing the newer version.

Upgrading From Sensor to AutoScaler

Datafy Sensor and AutoScaler are both based on shared components, operating at different permission levels: Sensor is read-only, and AutoScaler can modify and create volumes.

If you already have Sensor installed and want to upgrade to AutoScaler, these permissions need to be updated, and additional components that manage the volume lifecycle need to be installed.

1

Update IAM Role

Update the IAM role you created when installing Datafy Sensor, using the AutoScaler permissions level in the role template.

If you choose to create a new role and not update the existing one, make sure to update the role ARN in your Datafy dashboard

2

Install Datafy AutoScaler

Install Datafy AutoScaler the same way you installed Sensor, using the AutoScaler version of the installation command.

We recommend asking about the latest version before you upgrade

Upgrading Version of Existing Agent

Sensor

You can upgrade the version of Datafy Sensor you have installed by running the install command with the new version you'd like to install.

Before upgrading, you can check which version is already installed with the following:

EC2

You can check which version is installed on your instance with the command:

 /usr/local/datafy-agent/bin/datafy-agent --version

K8s

You can install a newer or older version this way, make sure to check which is the right one

AutoScaler

Upgrading From Version 1.32.0 or Above

AutoScaler is upgraded in the same way as Sensor. Volumes with active autoscaling and the data on them will continue to be available during the upgrade, with a short period of increased latency.

If the new version includes a kernel module upgrade, it will be implemented the next time the instance reboots. If the Autoscale upgrade is performed during a scheduled maintenance window, it is recommended to reboot the instance following the upgrade to ensure the kernel is updated.

Upgrading From Version < 1.32.0

AutoScaler is upgraded in the same way as Sensor. However, if you have volumes with active autoscaling, they may become temporarily unavailable during the upgrade.

In this case, after running the install command, you will be warned and prompted to approve the installation. If there is no response, the installation will be aborted.

Autoscaling volumes may be unavailable during installation. Do you want to proceed? [y/N]: y

You can use the flag FORCE_INSTALL=true to skip the prompt and approve the installation in advance. For example:

curl -sSfL https://agent.datafy.io/install?version=$VERSION | AGENT_MODE="autoscaler" TOKEN=$TOKEN FORCE_INSTALL=true sh

To ensure no impact on your application or the data on the autoscaling volumes, we recommend unmounting them before upgrading AutoScaler.