Upgrading DxEnterprise using the DH2i Repository

Applies to…

  • DxEnterprise for Linux

Summary

Upgrading DxEnterprise on Linux using the DH2i public repository.

Information

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

Note:  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 procedures below:

Ubuntu:

  1. If not already configured, configure the DH2i repository
    • Download the DxEnterprise package signing key:
      wget -qO- https://repos.dh2i.com/public.gpg | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/dh2i.gpg
    • Register the DxEnterprise Ubuntu repository:
      sudo sh -c 'echo deb [arch=amd64] https://repos.dh2i.com/ bionic retail >/etc/apt/sources.list.d/dh2i.list'
  2. Freeze the node to disable InstanceMobility by running the “freeze-node” dxcli command against the node. This instructs the cluster not to failover.
    dxcli freeze-node <node_name>
  3. Update the Ubuntu package list:
    sudo apt-get update
  4. Upgrade DxEnterprise:
    sudo apt-get upgrade dxenterprise
  5. Unfreeze the node to re-enable InstanceMobility by running the “unfreeze-node” dxcli command.
    dxcli unfreeze-node <node_name>
  6. Repeat steps 1-5 for each node in the cluster.

RHEL/CentOS:

  1. If not already configured, configure the DH2i repository
    • Download the DxEnterprise repository configuration file:
      sudo wget -O /etc/yum.repos.d/dh2i.repo https://repos.dh2i.com/<distro>/retail/repo.conf

      Note: 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 by running the “freeze-node” dxcli command against the node. 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 by running the “unfreeze-node” dxcli command.
    dxcli unfreeze-node <node_name>
    
  5. Repeat steps 1-4 for each node in the cluster.