VIC 1.3 Upgrade Fails "Failed to register appliance"
search cancel

VIC 1.3 Upgrade Fails "Failed to register appliance"


Article ID: 340136


Updated On:


VMware vSphere ESXi



Running the script results in "Failed to register appliance. Check vCenter target and credentials and provided PSC settings."  The upgrade.log may show similar to the following.

Preparing upgrade environment
Disabling and stopping Admiral and Harbor path startup
### lines omitted for brevity ###
Failed to register appliance. Check vCenter target and credentials and provided PSC settings.



VMware vSphere Integrated Containers 1.x


The special character in the password is not being handled to the vCenter.

Known Problem Characters

Colon :


No resolution at this time. Please use the workarounds in this KB.


Validation Steps:

  1. Test the user can login the vCenter using the Web Client.
  2. SSH to the PSC and view the log /var/log/vmware/sso/vmware-sts-idmd.log during the same time at the upgrade was attempted. Verify that the username is logged correct and that the error is invalid credentials.

[IdentityManager] Failed to authenticate principal [[email protected]]. Login failed Login failed
 at com.vmware.identity.idm.server.provider.vmwdirectory.VMwareDirectoryProvider.authenticate( ~[vmware-identity-idm-server.jar:?]
### lines omitted for brevity ###
Caused by: com.vmware.identity.interop.ldap.InvalidCredentialsLdapException: Invalid credentials

Workaround Option 1:

Change the password to not use the impacting special characters. For Active Directory accounts this need is done through Active Directory. For SSO users this can be done from the Web Client by logging in with the user > click the user name in the top right of the page > Select change password.


Workaround Option 2:

Create a new user in the SSO domain from the web client > Administration > Users & Groups > Select the green plus symbol for new user. This user will need to be added to administrators group in the same Users & Groups tab.