"Failed to configure License history repository" error when upgrading from Platform Services Controller Appliance 6.5 to 6.7

Products

• VMware vCenter Server

Issue/Introduction

Symptoms:

• Upgrading a Platform Services Controllers from version 6.5 to 6.7 fails.
• You see the error:
  
  Failed to configure License history repository
   
• In the /var/log/firstboot/license_firstboot.py_<PID>_stderr.log file, you see entries similar to:

 "detail": [
        {
            "translatable": "Failed to configure License Service history repository. Reason: %(0)s",
            "args": [
                "\t... 4 more"
            ],
            "id": "install.license.configurehistoryrepo.failed",
            "localized": "Failed to configure License Service history repository. Reason: \t... 4 more"
        }
    ],

Environment

VMware vCenter Server Appliance 6.5.x
VMware vCenter Server Appliance 6.7.x

Cause

This issues occurs because upgrade process is not able to export one of the license configuration files or the file is corrupt.

Resolution

To resolve this issue:

Note: Take a snapshot of the Platform Services Controller, if your environment is configured in Enhanced Linked Mode, please take snapshot of all the PSCs in ELM.

1. Connect to the Platform Services Controller using SSH
2. Copy the UUID from /etc/vmware/install-defaults/sca.hostid file by running this command:
   
   less /etc/vmware/install-defaults/sca.hostid

3. Navigate to the path /var/log/vmware/cis-license/history by running this command:
   
   cd /var/log/vmware/cis-license/history

4. Copy the HistoryMetadataEntity_HistoryMetadataId file by running this command:
   
   cp /var/log/vmware/cis-license/history/HistoryMetadataEntity_HistoryMetadataId /var/tmp/HistoryMetadataEntity_HistoryMetadataId_backup

5. Edit the HistoryMetadataEntity_HistoryMetadataId file using VI edit and update the value of MetadataRepoId with the UUID copied in Step # 2.
   
   For example:
   Name=HistoryMetadataEntity_HistoryMetadataId
   MetadataIsStateValid=true
   MetadataSnapshotCount=142
   MetadataDigest=tfMxug937MWQ/kj6qVLS4zB1NKatR6F6jiitgMQ9OJo\=
   ObjectClass=HistoryMetadataEntity
   MetadataRepoId=e729e847-67a3-40a7-b64d-28a21488aafc

6. Save the file and re-try the upgrade again.