VCF Operations for Networks 9.1 upgrade stalls at CDH Platform upgrade step

Products

• VCF Operations for Networks

Issue/Introduction

• Upgrading VCF Operations for Networks (formerly vRealize Network Insight) to version 9.1 stalls indefinitely.
• The upgrade status in the GUI shows: "Platform upgrade: CDH" with a status of "Failed".
• The upgrade process does not time out and remains stuck at this phase for several days.
• Review of the centralized_upgrade.log indicates failures in locating or executing the vrni-apt-cache package.

Environment

• VCF Operations for Networks 9.0.x
• VCF Operations for Networks 9.1.x
  

Cause

The upgrade stall is caused by a discrepancy between the appliance’s current system hostname and the hostname stored in the environment’s deployment metadata.

In VCF 9.1, the Common Deployment Hub (CDH) requires strict hostname alignment to resolve internal repository paths and local caches. When a mismatch exists, the automated scripts fail to locate the vrni-apt-cache package, which is a mandatory dependency for the platform upgrade progression.

Resolution

To resolve this issue, you must align the appliance hostname and manually inject the missing package.

Prerequisites

• Take a snapshot of the VCF Operations for Networks platform and collector nodes before proceeding.
• Obtain the vrni-apt-cache_9.1.0.0_all.deb package (contact Broadcom Support to get the bundle) 

Procedure

1. Correct Hostname Mismatch:
   
   

   • Log into the platform node via SSH as root.
   • Verify the current system hostname: hostnamectl status
   • Ensure the system hostname matches the FQDN/hostname registered in the VCF Operations Build metadata.
   • If a change is required, update the hostname: hostnamectl set-hostname <Correct_FQDN>
   • Update the /etc/hosts file to reflect the correct hostname and IP mapping.

2. Manually Install the Apt-Cache Package:
   
   

   • Upload the vrni-apt-cache_9.1.0.0_all.deb package to the /tmp directory of the platform node.
   • Install the package manually using below command:
     
     pdkg -i /tmp/vrni-apt-cache_9.1.0.0_all.deb

3.  Resume the Upgrade:
   

   • Return to the VCF Operations GUI.
   • Navigate to Build > Tasks.
   • Locate the failed "Platform upgrade: CDH" task.
   • Monitor the task to ensure it progresses past the CDH step and completes the 9.1 upgrade.