Skip to main content
Version: Archive

Upgrading DxEnterprise using the DH2i Repository

Applies to:

  • DxEnterprise for Linux


Upgrading DxEnterprise on Linux using the DH2i public repository.


DxEnterprise software is fully backward compatible and can be updated during normal production without impacting SQL instances or workloads.


If you are running availability groups using tunnels, the tunnel communication between availability group replicas will be impacted until the upgrade completes and the availability group resyncs.

It is also advisable to have access to the node outside of any DH2i tunnels via SSH since access to tunnels will be impacted during the upgrade.

To update DxEnterprise software, please follow one of the following procedures for your operating system:

  1. If not already configured, configure the DH2i repository.

    • Download the DxEnterprise repository configuration file:
    sudo wget -O /etc/yum.repos.d/dh2i.repo<distro>/retail/repo.conf

    Replace the <distro> parameter with rhel7, centos7, or rhel8 to download the correct .conf file. For CentOS 8, use rhel8.

  2. Freeze the node to disable InstanceMobility. This instructs the cluster not to failover.

    dxcli freeze-node <node_name>
  3. Upgrade DxEnterprise:

    sudo yum update dxenterprise
  4. Unfreeze the node to re-enable InstanceMobility.

    dxcli unfreeze-node <node_name>
  5. Repeat steps 1-4 for each node in the cluster.

Additional Information