Upgrading Gateway

Perform rolling upgrades of Gateway 6.0 and higher:

1. (Load balancer users only) In the load balancer, disable traffic for the specific Gateway being upgraded. Allow traffic to continue flowing to the other Gateways.

2. Stop the Gateway service.

   systemctl stop cloudgateway

3. Apply any operating system patches before upgrading the Gateway.

4. Upgrade the Gateway service:

   dnf -y install caringo-gateway-VERSION.rpm

5. When upgrading Gateway, it is good to refresh your gateway.cfg and logging.yaml, since customized files are not updated by dnf, to have the latest changes. See https://perifery.atlassian.net/wiki/spaces/public/pages/2443810201/Gateway+Configuration#Info and https://perifery.atlassian.net/wiki/spaces/public/pages/2443810251/Gateway+Logging#Upgrading-logging.yaml-to-a-Newer-Version for detailed information.

6. Reload the systemd control scripts:

   systemctl daemon-reload

7. Upgrade the Swarm Storage UI:

   dnf -y install caringo-storage-webui-VERSION.rpm

8. Upgrade the Content UI:

   dnf -y install caringo-gateway-webui-VERSION.rpm

9. Enable and start the Gateway service:

   systemctl enable cloudgateway systemctl start cloudgateway

10. (Load balancer users only) In the load balancer, re-enable client traffic to the newly upgraded Gateway.

11. Repeat the process for the remaining Gateways.