more upgrade edits

Author: rachel-netq

content/cumulus-netq-52/Installation-Management/Backup-and-Restore-NetQ.md

@@ -8,6 +8,7 @@ toc: 3
 The following sections describe how to back up and restore your NetQ data and VMs for on-premises deployments.
 
 {{%notice note%}}
+- Follow the backup and restore instructions as outlined on this page to upgrade your deployment from 5.0 to 5.2. If your deployment is currently running version 5.1, {{<link title="Upgrade NetQ Virtual Machines" text="perform an in-place upgrade">}} to upgrade to version 5.2.
 - You must run backup and restore scripts with sudo privileges.
 - NetQ does not retain custom-signed certificates during the backup and restore process. If your deployment uses a custom-signed certificate, you must {{<link title="Install a Custom Signed Certificate" text="reconfigure the certificate">}} after you restore it on a new NetQ VM.
 - The backup and restore process does not retain several configurations necessary for the Grafana integration, including switch TLS certificates, authentication tokens (vm-tokens), OpenTelemetry configurations, and external time-series database configurations. After reinstalling NetQ, you must {{<link title="Integrate NetQ with Grafana" text="reconfigure these components">}}. Grafana will not display data from previous NetQ versions.
@@ -18,7 +19,7 @@ The following sections describe how to back up and restore your NetQ data and VM
 Follow the process below for your deployment type to back up your NetQ data.
 
 {{<tabs "TabID19" >}}
-{{<tab "Ethernet-only and Combined (Ethernet + NVLink)" >}}
+{{<tab "Ethernet and Combined (Ethernet + NVLink) Deployments" >}}
 
 {{%notice note%}}
 If your NetQ deployment uses combined Ethernet and NVLink mode, only your Ethernet data can be backed up and restored. NVLink data is excluded from the backup and restoration process.
@@ -106,7 +107,7 @@ nvidia@netq-server:~$ sudo scp /opt/backuprestore/combined_backup_20250117054718
 ```
 
 {{</tab>}}
-{{<tab "NVLink-only" >}}
+{{<tab "NVLink-only Deployments" >}}
 
 These steps apply exclusively to {{<link title="Install NetQ for NVLink" text="NetQ NVLink">}} three-node cluster deployments.
 
@@ -135,12 +136,12 @@ cp -r /home/nvidia/nvlink_cluster_backup_20250617063052 /tmp/data-infra
 ## Restore Your NetQ Data
 
 {{<tabs "TabID129" >}}
-{{<tab "Ethernet-only and Combined (Ethernet + NVLink)"  >}}
+{{<tab "Ethernet and Combined (Ethernet + NVLink) Deployments"  >}}
 
 To restore your NetQ data, perform a {{<link title="Install the NetQ System" text="new NetQ VM installation">}} and follow the steps to restore your NetQ data when you run the `netq install` command. You will use the `restore` option, referencing the path where the backup file resides.
 
 {{</tab>}}
-{{<tab "NVLink-only" >}}
+{{<tab "NVLink-only Deployments" >}}
 
 1. Run the installation command on your master node and specify the following within the command itself: 
 

content/cumulus-netq-52/Installation-Management/Upgrade-NetQ/Upgrade-System.md

@@ -5,7 +5,7 @@ weight: 410
 toc: 4
 ---
 
-This page describes how to upgrade your NetQ virtual machines. Note that the upgrade instructions vary depending on NetQ version you’re currently running.
+This page describes how to upgrade your NetQ virtual machines while preserving your existing NetQ data. Note that the upgrade instructions vary depending on NetQ version you’re currently running.
 
 For deployments running:
 
@@ -71,15 +71,20 @@ If the output of this command displays errors or returns an empty response, you
     Processing triggers for man-db (2.8.3-2ubuntu0.1) ...
     ```
 
-
+-->
 ## Download the Upgrade Software
 
-1. Download the upgrade tarball.
+1. Download the NetQ image.
 
-    {{<netq-install/upgrade-image version="4.12">}}
+    a. Log in to your {{<exlink url="https://nvid.nvidia.com/" text="NVIDIA Application Hub">}} account.<br>
+    b. Select **NVIDIA Licensing Portal**.<br>
+    c. Select **Software Downloads** from the menu.<br>
+    d. In the search field above the table, enter **NetQ**.<br>
+    e. For deployments using KVM, download the **NetQ SW 5.2.0 KVM Scale** image. For deployments using VMware, download the **NetQ SW 5.2.0 VMware Scale** image<br>
+    f. If prompted, read the license agreement and proceed with the download.<br>
 
 2. Copy the tarball to the `/mnt/installables/` directory on your NetQ VM.
-
+<!--
 ## Run the Upgrade
 
 {{%notice note%}}
@@ -115,7 +120,7 @@ Run the appropriate commands for your deployment type:
 
 {{<tab "Standalone">}}
 
-Run the upgrade command on your master node, specifying the tarball of the latest NetQ release: 
+Run the upgrade command on your master node, specifying the tarball path in the command: 
 
 ```
 nvidia@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-5.2.0.tgz
@@ -126,7 +131,7 @@ If this step fails for any reason, run the <code>netq bootstrap reset keep-db</c
 {{</tab>}}
 
 {{<tab "High-availability Cluster">}}
-Run the upgrade command on your master node, specifying the current version's tarball and your cluster's virtual IP address.
+Run the upgrade command on your master node, specifying the tarball path and your cluster's virtual IP address in the command:
 
 ```
 nvidia@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-5.2.0.tgz <cluster-vip>
@@ -137,7 +142,7 @@ nvidia@<hostname>:~$ netq upgrade bundle /mnt/installables/NetQ-5.2.0.tgz <clust
 
 Run the upgrade command on your master node and specify the following within the command itself: 
 
-- The tarball of the latest NetQ release. This command upgrades NetQ to the release specified in the command.
+- The path to the tarball of the latest NetQ release. This command upgrades NetQ to the release specified in the command.
 - The passwords for the read-write user (`rw-password`) and the read-only user (`ro-password`)
 - The `/home/nvidia/nvl-cluster-config.json` file
 
@@ -147,12 +152,28 @@ nvidia@<hostname>:~$ netq upgrade nvl bundle /mnt/installables/NetQ-5.2.0.tgz ko
 {{</tab>}}
 
 {{<tab "High-availbility Scale Cluster (NVLink + Ethernet)">}}
-Run the upgrade command on your master node, specifying the current version's tarball and your cluster's virtual IP address.
+
+Two upgrade options are available for this deployment model. One option upgrades your NetQ deployment to the latest version. The other option upgrades your NetQ deployment to the latest version and concurrently adds additional nodes to your existing cluster.
+
+## Upgrade with Same Number of Nodes
+
+Run the upgrade command on your master node, specifying the current version's tarball and your cluster's virtual IP address:
 
 
 ```
-nvidia@<hostname>:~$ netq upgrade nvl bundle /mnt/installables/NetQ-5.2.0.tgz <cluster-vip>
+nvidia@<hostname>:~$ netq upgrade cluster bundle /mnt/installables/NetQ-5.2.0.tgz <text-cluster-config>
 ```
+## Upgrade and Add Additional Nodes
+
+<!--how to load json file? how to upgrade v2 to v3-->
+
+
+Run the installation command on your master node, specifying the current version's tarball and the full path to your cluster's JSON configuration file:
+
+```
+nvidia@<hostname>:~$ netq install cluster extend-cluster bundle /mnt/installables/NetQ-5.2.0.tgz /tmp/combined-cluster-config.json
+```
+
 {{</tab>}}
 
 {{</tabs>}}

content/cumulus-netq-52/Whats-New/_index.md

@@ -46,8 +46,7 @@ This page summarizes new features and improvements for the NetQ {{<version>}} re
 
 NetQ 5.2 is available exclusively for on-premises deployments. You can upgrade to 5.2 if your deployment is running version 5.1 or 5.0. 
 
-- To upgrade from 5.1 to 5.2, perform an {{<link title="Upgrade NetQ Virtual Machines" text="in-place upgrade">}}.
-- To upgrade from 5.1 to 5.2 and concurrently add additional nodes to your cluster, run the `netq install cluster` command with the `extend-cluster` option.
+- To upgrade from 5.1 to 5.2, perform an {{<link title="Upgrade NetQ Virtual Machines" text="in-place upgrade">}}. 
 - To upgrade from 5.0 to 5.2, {{<link title="Back Up and Restore NetQ" text="back up your NetQ data">}}, then concurrently restore your data and upgrade NetQ during a {{<link title="Install the NetQ System" text="new NetQ 5.2 installation">}}.