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.

caution

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

1. Install the repository configuration file.

   info

   Replace the <distro> parameter in the example below with rhel7, centos7, rhel8 or rhel9 to install the correct package for your OS.

   sudo yum install https://repos.dh2i.com/<distro>/retail/repo.rpm

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.

Ubuntu

1. Download the repository configuration file.

   wget https://repos.dh2i.com/dists/bionic/retail/repo.deb

2. Install and remove the repository configuration file.

   sudo dpkg -i repo.deb
   sudo rm repo.deb

3. Update the Ubuntu package list.

   sudo apt-get update

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

   dxcli freeze-node <node_name>

5. Upgrade DxEnterprise:

   sudo apt-get upgrade dxenterprise

6. Unfreeze the node to re-enable InstanceMobility.

   dxcli unfreeze-node <node_name>

7. Repeat steps 1-6 for each node in the cluster.

SLES

1. Import the GPG key.

   rpm --import https://repos.dh2i.com/public.gpg

2. Install the repository configuration file.

   sudo zypper install https://repos.dh2i.com/sles15/retail/repo.rpm

3. Update the SLES package list.

   sudo zypper refresh

4. Upgrade DxEnterprise.

   sudo zypper update dxenterprise

5. Unfreeze the node to re-enable InstanceMobility.

   dxcli unfreeze-node <node_name>

6. Repeat steps 1-5 for each node in the cluster.

Additional Information

• Upgrading DxEnterprise from the Command Line
• DxEnterprise DxCLI Admin Guide