Upgrade precheck fails due to Unhealthy services for VCF Operations for Networks appliance.

Products

• VCF Operations for Networks

Issue/Introduction

 

• An upgrade pre-check or operational task fails within the VCF Operations for Networks (formerly Aria Operations for Networks) UI.

• When running the service health check script on the platform node via SSH, the HRegionServer reports as running but not healthy.

• Output from ./check-service-health.sh -p -d as below:
  
  ElasticSearch is running and healthy.
ElasticSearch statistics:
Uptime:20-03:52:03
HMaster is running and healthy.
Uptime:20-03:55:01
HRegionServer is running but not healthy.
Uptime:4-22:31:34

• VCF Operation VCF management  Tasks on  GUI shows error message for platform prechecks:
  
  VCF Operations for networks Upgrade Prechecks pre-check result status: Failed
  
  Reference screenshot as below:
  
  
  
  
• On VCF Operations for Networks GUI platform shows below error:
  
  HRegionServer service is not running on aria-networks-platform(##.###.###.##). If the situation persists for more than 6 hours
  
  Reference screenshot:
  
  

 

Environment

VCF Operations for Networks 9.0.x
VCF Operations for Networks 9.1.0.x

Cause

This issue occurs when the platform node's IP address and hostname mapping is missing from the local /etc/hosts file or has been incorrectly updated.
Without this entry, internal services like HRegionServer cannot resolve the hostname correctly, leading to service health degradation and subsequent upgrade or task failures in the GUI.

Resolution

To resolve this issue, you must manually add the missing IP and hostname entry to the /etc/hosts file on the platform node and restart the appliance.

Step 1: Verify the Missing Entry

1. Connect to the VCF Operations for Networks platform node via SSH (e.g., using PuTTY) and log in with the ubuntu user.

2. View the contents of the hosts file by running:
   
   cat /etc/hosts

3. Notice that the specific IP address mapped to the platform's hostname (e.g., aria-networks-platform) is absent.
   Step 2: Update the /etc/hosts File

Step 2: Update the /etc/hosts File

1. Open the hosts file in a text editor with root privileges:
   sudo vim /etc/hosts

2. Press i to enter Insert mode.

3. Add the missing IP address and hostname to the bottom of the file. (Note: Replace the IP below with your node's actual IP address if different)
   
   ##.###.###.##   aria-networks-platform

4. Save and exit the file (Press Esc, type :wq!, and hit Enter).

Step3: Validation

1. View the contents of the hosts file by running:
   
   cat /etc/hosts
2. Refresh the VCF Operations for Networks GUI, the error messages should be cleared, and upgrade checks or tasks should now complete successfully. You can also re-run the health check script (./check-service-health.sh -p -d) to verify that the HRegionServer now reports as healthy.
   
   
3. Log back into the VCF Operations for Networks UI trigger the prechecks and upgrade all the  tasks should now complete successfully.
   
   

To speak with a customer representative or a Support Engineer if needed, see  Contact Support.

Additional Information

Review available documentation for How to change the IP of any platform node or a collector in a cluster

It is recommended to Subscribe to this article. Reference: (KB 275360) Subscribe to a Broadcom knowledge article by article or product to be updated on any changes