How to update support.fallbackUri

On April 14, 2025, the original destination for Swarm storage nodes' health reports was decommissioned. In most cases, storage nodes are able to use DNS to resolve the new IP address for the current health reports collection server. In Swarm 17, the new location is hard coded into Swarm software, so nodes updated to Swarm 17.0+ are sending health reports to the correct location. However, if you have a storage cluster on Swarm 16 or prior, and your storage nodes are not able to use DNS to resolve our health reports server FQDN (https://swarm.phonehome.datacore.com:443/, then as of April 15, we are no longer receiving health reports.

To fix this issue and continue to allow this vital information to be sent to Datacore, you will need to either:

a) fix your DNS

b) update a parameter in your Swarm cluster to point to the new IP address, overriding the old hard coded location.

Option a is potentially complicated and location-specific, so the following instructions will instead guide a user through option b.

How to update this parameter depends on whether the cluster is booted via a CSN or via the SCS.

CSN

If using a CSN, SSH into your CSN as the root user. Make sure that you have the Support tools available. This link explains how to install and update your support tools if they are not already installed: https://perifery.atlassian.net/wiki/spaces/public/pages/2443826431/How+to+collect+a+support+bundle

The steps presume these tools are on your CSN and unpacked in the /root/dist directory.

• Collect an IP address from any Swarm storage node in your cluster. Any active IP address will do. You can find one by typing: /opt/caringo/csn/bin/ip-assignments --ips

• Type: export SCSP_HOST=<any Swarm storage node IP address>

• Type: cd /root/dist/

• Fill in your own password in the below commands.

• Type: ./swarmctl -a -p 'admin:PASSWORD' -C support.fallbackUri -V "https://50.230.62.139:443/castor/report"

• Type: ./swarmctl -a -p 'admin:PASSWORD' -C support.uri -V "https://swarm.phonehome.datacore.com:443/castor/report"

• Type: ./updateBundle.sh

• Type: ./platform-send-health-reports.sh

Make sure that this gives a positive result. Example:

• Next, edit your /var/opt/caringo/netboot/content/cluster.cfg​​​​​​​ file to ensure that this setting persists through storage node reboots. Append this to the very bottom of that file:

  support.fallbackUri="https://50.230.62.139:443/castor/report" support.uri="https://swarm.phonehome.datacore.com:443/castor/report"

SCS

If using an SCS, SSH into your SCS as the root user. Make sure that you have the Support tools available. This link explains how to install and update your support tools if they are not already installed: How to collect a support bundle

The steps presume these tools are on your SCS and unpacked in the /root/dist directory.

• Collect an IP address from any Swarm storage node in your cluster. Any active IP address will do. You can find one by typing: scsctl storage list

• Type: export SCSP_HOST=<any Swarm storage node IP address>

• Type: cd /root/dist/

• Fill in your own password in the below commands.

• Type: ./swarmctl -a -p 'admin:PASSWORD' -C support.fallbackUri -V "https://50.230.62.139:443/castor/report"

• Type: ./swarmctl -a -p 'admin:PASSWORD' -C support.uri -V "https://swarm.phonehome.datacore.com:443/castor/report"

• Type: ./updateBundle.sh

• Type: ./platform-send-health-reports.sh

Make sure that this gives a positive result. Example:

• Finally, ensure that this setting persists through storage node reboots by typing:

  scsctl storage config set -d support.fallbackUri="https://50.230.62.139:443/castor/report" scsctl storage config set -d support.uri="https://swarm.phonehome.datacore.com:443/castor/report"