Like most folks, I was excited about the release of vSphere 7.0 Update 2 and I was ready to upgrade my personal homelab, which was running on vSphere 7.0 Update 1c. However, after starting my VCSA upgrade in the VAMI UI, it quickly failed with the following error message: Exception occurred in install precheck phase
— William Lam (@lamw) March 9, 2021
Given the release had just GA’ed less than an hour ago and everyone was probably hammering the site, I figured I would wait and then try again.
I normally use the “Stage and Install” option and after accepting the EULA and providing the required credentials, the upgrade began.
The upgrade seemed to have resumed and pre-check results passed as you can see from the screenshot below. However, after hitting continue, I would be taken right back to the pre-check error as noted earlier. I repeated this a few times and realize it was stuck in this loop.
I even attempted to reboot the VCSA, maybe my environment had some issue but the results were the same. There were also a couple of suggestions on removing the following state file /etc/applmgmt/appliance/software_update_state.conf on the VCSA filesystem which apparently was a solution that had worked. However, in this case it did not do anything and I still ran into the issue.
At this point, I was not interested poking around or randomly removing files as I heard few other folks were running into this problem. I generated a support bundle and file an internal bug to have Engineering take a look.
Disclaimer: If you are currently facing this problem in a Production environment, please stop and file a VMware Support Request so that this can be officially tracked and you can have GSS reference PR 2732490. The workaround below has only been confirmed by the community and should only be attempted on non-production or homelabs environment where you are comfortable with the workaround.
Several folks have shared with me a workaround that they have verified which requires the upgrading the VCSA using the VCSA Shell. I have personally not applied this workaround as I wanted to leave my environment in its existing state, in case VMware Engineering need to troubleshoot live. For those interested, below are the instructions to apply the workaround.
Step 1 – Login to the VAMI UI and under Updates, only select the “Stage” option to download the 7.0 Update 2 updates.
Step 2 – SSH to the VCSA and remove /etc/applmgmt/appliance/software_update_state.conf file
Step 3 – Run the following command to install the staged 7.0 Update 2 software:
software-packages install –url –acceptEulas
Once this operation completes, you should now have a successfully upgraded VCSA to 7.0 Update 2. I will update this blog post as I learn more from Engineering and if this workaround is official, I will ask the team to publish a KB and also mention this in the 7.0 Update 2 release notes.