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.
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:
- RedHat/CentOS
- Ubuntu
-
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
noteReplace the <distro> parameter with rhel7, centos7, or rhel8 to download the correct .conf file. For CentOS 8, use rhel8.
-
Freeze the node to disable InstanceMobility. This instructs the cluster not to failover.
dxcli freeze-node <node_name>
-
Upgrade DxEnterprise:
sudo yum update dxenterprise
-
Unfreeze the node to re-enable InstanceMobility.
dxcli unfreeze-node <node_name>
-
Repeat steps 1-4 for each node in the cluster.
-
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'
-
-
Freeze the node to disable InstanceMobility. This instructs the cluster not to failover.
dxcli freeze-node <node_name>
-
Update the Ubuntu package list:
sudo apt-get update
-
Upgrade DxEnterprise:
sudo apt-get upgrade dxenterprise
-
Unfreeze the node to re-enable InstanceMobility.
dxcli unfreeze-node <node_name>
-
Repeat steps 1-5 for each node in the cluster.