Lockbox Access Failed during Network Configuration upgrade

Products

• VMware Smart Assurance
• Network Observability

Issue/Introduction

Application server upgrade fails with a lockbox authorization error when the specified passphrase is incorrect or the encryption key is missing.

 

ERROR MESSAGE: "Error: Lockbox Access Error: Lockbox authorization failed. This may occur if the specified passphrase is incorrect."

Environment

NCM - All supported version

Cause

The upgrade fails because the application cannot authorize access to the lockbox, often due to an incorrect passphrase or a missing encryption key file (.ekey).

Resolution

STEPS:

1. SOURCE ENVIRONMENT VARIABLES:

   Command: source /etc/voyence.conf

    

2. Navigate to the tools directory:

   Path: $VOYENCE_HOME/tools/passphrase

    

3. Run the Perl utility to change the password:

   Command: perl changePassphrase.pl

    

   • Enter the current lockbox passphrase when prompted for "Old Password".

      

   • Enter and re-enter a new passphrase meeting the complexity requirements.

      

   EXPECTED: System returns "*** SUCCESS: Passphrase changed!"

    

   NOTE: You can perform these steps again to change the passphrase back to the original if desired once the lockbox access is restored.

    

VERIFY SUCCESS:

• Confirm /opt/smarts-ncm/lockb.ekey is generated.

   

• Relaunch the upgrade setup binary to confirm it proceeds past the server configuration stage.