Skip to main content
Migration Notice
We're migrating documentation from the old portal into this one. Some things may look a little different or out of place in the meantime — we know, and we're working to get it right. If something's unclear or doesn't look right, let us know.
Version: 2.15.0

Upgrade Guide for Data Orchestration for Dell

Introduction​

This page describes how to upgrade an existing Data Orchestration for Dell (Superna Golden Copy) appliance to a newer release. Review the target release's entry on the Release Notes page before upgrading to confirm supported OneFS versions and any upgrade-specific known issues.

tip

Take a VMware-level snapshot of every appliance VM (management node and any Virtual Accelerator Nodes) before starting the upgrade, so you can roll back if needed.

Before You Upgrade​

  • Confirm the target release supports your source cluster's OneFS version. See the Release Notes page for the supported OneFS release list.

  • Take a VM-level snapshot of all appliance nodes.

  • For releases 1.1.16 and later, back up the current folder configuration and job history before upgrading:

    searchctl settings config export

  • If you previously modified container memory settings for a Vertical Scaling deployment, note that these customizations will need to be re-applied after the upgrade (see below).

note

When upgrading from release 1.1.9, confirm the state of any job that was running at the time of the upgrade. A known issue on that upgrade path could leave an in-progress job out of both the running jobs list and job history, with its files not uploaded. Re-run the affected folder's job after upgrading if this occurs.

Offline Upgrade Procedure​

This procedure upgrades the appliance without requiring internet access from the appliance itself.

  1. Log in to the Superna support site and download the offline Data Orchestration upgrade file for your target release.

  2. Shut down the cluster. SSH to node 1 as ecaadmin:

    ecactl cluster down

    Wait for the shutdown to complete before continuing.

  3. Run the installer:

    cd /home/ecaadmin
    chmod 777 <name of install file>
    ./<name of install file>

    Enter the ecaadmin password when prompted, and wait for all nodes to complete the upgrade.

  4. If you previously customized container memory settings for a Vertical Scaling deployment, those settings are reset by the upgrade and must be re-applied. Remove the memory configuration lines added during install (if reverting) or re-add them (if keeping the customization) in:

    nano /opt/superna/eca/templates/docker-compose.gc.yml
    nano /opt/superna/eca/templates/docker-compose.gc_multi_node.yml
    nano /opt/superna/eca/docker-compose.yml

    Apply the change:

    echo y | ecactl cluster push-config

  5. Start the cluster:

    ecactl cluster up

    Wait until all nodes have started.

  6. The upgrade is complete. Verify folder definitions, licenses, and scheduled jobs are intact using the Configuration Guide monitoring commands.

See Also​

  • Release Notes – Current and historical release information, including upgrade-relevant known issues.
  • Installation Guide – Full deployment and licensing steps for new installations.