Overview

This document describes the procedure for upgrading DataCore Content Gateway deployments running Gateway 6.0 or later. The recommended approach is to perform a rolling upgrade to maintain service availability while minimizing operational disruption.

The upgrade process includes upgrading the Gateway service, associated user interfaces, and refreshing configuration files to ensure compatibility with the latest release.

For environments running versions earlier than Gateway 6.x, refer https://perifery.atlassian.net/wiki/spaces/public/pages/2443817356 documentation before proceeding.

Prerequisites

Gateway upgrades require access to the appropriate package repositories.

Ensure that the Gateway server has access to either:

• Internet-hosted package repositories, or

• A locally mirrored/internal repository containing the required Gateway packages and dependencies

Repository access is required for installing Gateway packages and any associated operating system dependencies during the upgrade process.

Rolling Upgrade Procedure

Perform rolling upgrades of Gateway 6.0 and higher. Perform the following steps on one Gateway node at a time:

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. After upgrading, review and refresh customized configuration files as needed to incorporate the latest configuration changes.

   Recommended files for review:

   • gateway.cfg

   • logging.yaml

   Refer 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 configuration (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. Repeat the rolling upgrade procedure for each remaining Gateway node in the environment until all nodes are upgraded successfully.