Loading
Salesforce now sends email only from verified domains. Read More

How to Download the Gravity Binary to Other Nodes (Not the Installer) During RTF Appliance Upgrade

Publish Date: Aug 5, 2025
Steps

QUESTION

The RTF appliance upgrade performs in a rolling fashion. If the gravity binary is not upgraded yet on a node (not the installer node) but the upgrade failed on the node, I will need to use the newer gravity binary to get verbose output on the node. How can I get the gravity binary on the node without downloading the whole package?

ANSWER

The binary is uploaded to the gravity-site store before the upgrade. You can download the binary from there:
1. Check what binaries available in the gravity-site store. You can run the command on any node
$ gravity package list --ops-url=https://gravity-site.kube-system.svc.cluster.local:3009 --insecure

[gravitational.io]
------------------

...
* gravitational.io/gravity:5.5.36 99MB
* gravitational.io/gravity:5.5.38 100MB
...

There are two gravity binaries in the gravity-site store: gravity:5.5.36 and gravity:5.5.38. I would like to download the gravity:5.5.38 to a node. 

2. Log in to the node. Check if the gravity has upgraded with the newer gravity with "gravity version". If it's still in the old version, run the commands below. 
> gravity package export --insecure --ops-url=https://gravity-site.kube-system.svc.cluster.local:3009 gravitational.io/gravity:5.5.38 gravity
> chmod +x ./gravity
The newer gravity binary is under the current directory. 
 

ADDITIONAL INFORMATION

User the newer binary to execute and rollback, for example
$ sudo ./gravity plan rollback --phase /nodes/VM-PRD-MEL-INTEG-RFWORKER-01/system-upgrade
$ sudo ./gravity plan execute --phase /nodes/VM-PRD-MEL-INTEG-RFWORKER-01/system-upgrade --debug
Knowledge Article Number

001116606

 
Loading
Salesforce Help | Article