[vRNI] [6.5-6.6] [Patch] During vRNI Upgrade the prechecks may fail with the "HBase or HDFS unhealthy" or vRNI GUI may become unresponsive

Products

• VMware Aria Operations for Networks

Issue/Introduction

To mitigate the upgrade pre-check failure or UI unresponsiveness in vRNI 6.5.1 and vRNI 6.6.0.

Symptoms:

While performing an upgrade the pre-checks may fail with the "HBase or HDFS unhealthy" message.

Refer to screenshot below:



Alternatively, during normal operations, UI may become unresponsive
 

Environment

VMware vRealize Network Insight 6.5.1
VMware vRealize Network Insight 6.5.0
VMware vRealize Network Insight 6.6.0

Cause

The number of threads in the restapilayer service keeps increasing steadily until a point where no more threads can be created. This may result in several weird behaviours on the UI.

Resolution

A patch is available to be applied to resolve the issue for each vRNI version (6.5.1 and 6.6).

Workaround:

vRNI 6.5.1 Patch Download Details:
 

Patch Download	https://ftpsite.vmware.com/download?domain=FTPSITE&id=6cc63dafa2a84d35b590b14e35bc9cfa-8294cc637f4a4904b18869869732e4ec
File Name	VMware-vRNI.6.5.1.P3.1650366298.patch.bundle
Size	682.2 MB
SHASUM	6493daae39f49241dc0f3815d608c03a4594c53f

Before applying the patch, please restart the service restapilayer-service on platform (platform1 if you are running a cluster) with the below commands through the user "ubuntu" (ssh with the user "support" then execute "ub" to become "ubuntu" user)

/home/ubuntu/run_all.sh "sudo systemctl stop restapilayer-service.service"
/home/ubuntu/run_all.sh "sudo /home/ubuntu/build-target/restapilayer/stop-restapilayer.sh /home/ubuntu/build-target/restapilayer"
/home/ubuntu/run_all.sh "sudo systemctl start restapilayer-service.service"

Procedure to apply VMware-vRNI.6.5.1.P3.1650366298.patch.bundle:

1. Download the VMware-vRNI.6.5.1.P3.1650366298.patch.bundle file from here . Save the file on you local system.
2. Log into the vRealize Network Insight 6.5.x UI as an Administrator user.

Note: The default admin@local account can be used.

3. Navigate to Settings > Install and Support > Overview and Updates, then under Product, select Click here.
4. Click Browse to select the  locally downloaded patch file (VMware-vRNI.6.5.1.P3.1650366298.patch.bundle) and click Upload.

Notes:

• When the upload is complete, vRealize Network Insight show the Bundle Upload Complete message notification within 2-3 minutes and the bundle processing happens in the background.
• Until the upload of the package happens, ensure that the session is not closed. If the session ends, you have to restart the upload process.
• Do not refresh the page after bundle upload, until you see the Update Available message notification.

5. In the Bundle Available message notification, click View details.

vRealize Network Insight Update screen appears.

6. Read the Before you proceed instruction and click Continue.
7. Wait for the pre-checks to complete, which verifies:

• the disk space, including the space required for migration
• the version
• the NTP sync status
• the bundle checksum

8. Click Install Now.

You can see the approximate time required to complete the update process on your setup.

9. Once the update process begins, the vRealize Network Insight Update screen provides the status of the update process.
10. Upon the completion of update process, you will see a completion message.

 

vRNI 6.6.0 Patch Download Details:
 

Patch Download	https://ftpsite.vmware.com/download?domain=FTPSITE&id=02f0de096a6140f9ba9c989b2447d047-86c0b433f5d94a08ab5a774a3127f86c
File Name	VMware-vRNI.6.6.0.P2.1651837449.patch.bundle
Size	130.3 MB
SHASUM	0cfa61c8bcf3d053e513a0dcb3ffebed3869ecb8

Before applying the patch, please restart the service restapilayer-service on platform (platform1 if you are running a cluster) with the below commands through the user "ubuntu" (ssh with the user "support" then execute "ub" to become "ubuntu" user)

/home/ubuntu/run_all.sh "sudo systemctl stop restapilayer-service.service"
/home/ubuntu/run_all.sh "sudo /home/ubuntu/build-target/restapilayer/stop-restapilayer.sh /home/ubuntu/build-target/restapilayer"
/home/ubuntu/run_all.sh "sudo systemctl start restapilayer-service.service"

Procedure to apply VMware-vRNI.6.6.0.P2.1651837449.patch.bundle:

1. Download the VMware-vRNI.6.6.0.P2.1651837449.patch.bundle file from here . Save the file on you local system.
2. Log into the vRealize Network Insight 6.6.0 UI as an Administrator user.

Note: The default admin@local account can be used.

3. Navigate to Settings > Install and Support > Overview and Updates, then under Product, select Click here.
4. Click Browse to select the  locally downloaded patch file (VMware-vRNI.6.6.0.P2.1651837449.patch.bundle) and click Upload.

Notes:

• When the upload is complete, vRealize Network Insight show the Bundle Upload Complete message notification within 2-3 minutes and the bundle processing happens in the background.
• Until the upload of the package happens, ensure that the session is not closed. If the session ends, you have to restart the upload process.
• Do not refresh the page after bundle upload, until you see the Update Available message notification.

5. In the Bundle Available message notification, click View details.

vRealize Network Insight Update screen appears.

6. Read the Before you proceed instruction and click Continue.
7. Wait for the pre-checks to complete, which verifies:

• the disk space, including the space required for migration
• the version
• the NTP sync status
• the bundle checksum

8. Click Install Now.

You can see the approximate time required to complete the update process on your setup.

9. Once the update process begins, the vRealize Network Insight Update screen provides the status of the update process.
10. Upon the completion of update process, you will see a completion message.

Additional Information

Refer to vRNI 6.6 Release notes under Known issues

Impact/Risks:

The issue is applicable to all types of vRNI deployments from 6.5/6.6 onwards (vRNI On-Premises and vRNI Cloud)