VCSA 6.5 Installer Gotchas

I recently upgraded from VCSA 6.0 to VCSA 6.5 and hit a few gotchas along the way — especially with the newly supported Mac installer. Read on to learn more!
vsphere

UPDATE: This blog post is getting some attention. I just wanted to add my definition of “gotcha”: anything that does not work as expected (solution may be to read the documentation, perform some workaround, or wait for a fix).

Gotcha #1: No need to manually install VMware OVFTool 4.2

The UI installer requires and includes VMware OVFTool 4.2. Even if you install VMware OVFTool 4.2 manually, the installer will NOT leverage it. You will understand why this is important in a minute.

Gotcha #2: The installer for MacOS Sierra does not appear to work

Yes, you read that right — at least it did not work for me. With that said, it is not listed as officially supported. Here is what I experienced:

  • Open CDROM > vcsa-ui-installer > mac > Installer
  • Complete steps 1 through 5
  • Hit an error on step 6

vcsa-mac-ovftool1
Based on the message, I thought I might have a corrupt OVA file, however the download was an ISO and the ISO mounted without issue. To start troubleshooting, I selected the “Show all” button:
vcsa-mac-ovftool2
OK, now it sounds like a problem with ovftool. This made me believe I needed to install ovftool manually and then rerun the installer. After do this, I hit the same issue, which resulted in Gotcha #1. Long story short, no need to install ovftool manually. Next step is to check the “Installer log” so I hovered over the link:
vcsa-mac-ovftool3
Well, that is kind of ugly, but I assume that is the path of the log file. If you click on what is left of “Installer log” then you can download the log file:
vcsa-mac-ovftool4
Next, I opened the log file and scrolled to the bottom of the log file to find:

2016-11-16T23:54:19.360Z - error: could not find ovftoolCmd: /private/var/folders/68/_76kyyfs18l4gd4qrj1hvtp80000gn/T/AppTranslocation/vcsa/ovftool/mac/ovftool
2016-11-16T23:54:19.360Z - info: ovftoolCmd: null
2016-11-16T23:54:19.360Z - error: OVF probe error: Error: ovftool is not available

Well, that is interesting. I was expecting the installer to look for ovftool in the /Applications directory, but instead it is a private path. Next, I decided to check the directory reporting the error. I made it to:

/private/var/folders/68/_76kyyfs18l4gd4qrj1hvtp80000gn/T/AppTranslocation

before I could go no further. The “vcsa” directory did not exist! Well, that is a problem. To fix the problem, I decided to create the missing directories and then create a link to ovftool in my /Applications directory. I restarted the installer and hit the same issue:
vcsa-mac-ovftool1
When I expanded the error this time though I noticed the message had changed:
vcsa-mac-ovftool5
OK, so it appears ovftool was found, but the OVA was not. I also took a look at the updated installer log, which confirmed the issue:

2016-11-16T18:25:05.769Z - error: Could not find ovaFile /^VMware-vCenter-Server-Appliance-.*_OVF10.ova$/ in /private/var/folders/68/_76kyyfs18l4gd4qrj1hvtp80000gn/T/AppTranslocation/vcsa
2016-11-16T18:25:05.769Z - info: ovaFile: null
2016-11-16T18:25:05.770Z - error: OVF probe error: Error: OVA file is not available

This lead me back to the ISO and the directory structure:
vcsa-mac-ovftool6
Well look at that — the “vcsa” directory in the ISO contains both ovftool and the OVA! I copied over the OVA and the installer worked as expected. So long story short:

  1. Refer to Gotcha #1
  2. You need to manually copy the “vcsa” directory in the ISO to the private path in the installer log to make the MacOS installer work on Sierra

Gotcha #3: Upgrade PSC before VCSA

This is nothing new, but I figured I would cover it anyway. If you have an external PSC then you need to upgrade it BEFORE you upgrade VCSA. If you do not, you will not be able to complete the second part of the VCSA upgrade, but can upgrade PSC and then return to the second part of the VCSA upgrade by going to https://<newVCSA>:5480.
Also, as a FYI, to upgrade an external PSC or VCSA, you need:

  • The credentials to the existing PSC/VCSA (UI + CLI)
  • The source ESXi host (CLI)
  • The destination ESXi host (CLI)
  • A temporary IP for this new PSC/VCSA (used until the migration is complete)

FEATURE REQUEST: The installer should check for this and report back to the user beforehand.

Gotcha #4: The INITIAL SSO username matters

Again, nothing specific to 6.5, but pay special attention to the SSO user name if you are not using the default vsphere.local domain. If you forgot to change the domain you will receive an error about authentication:
vcsa-mac-sso-username
However, if you edit the SSO user name after using an incorrect one without closing the installer then the new PSC/VCSA will get deployed — which takes about 20 minutes — but you will not be able to configure the PSC/VCSA as it uses the first SSO user name you entered (i.e. [email protected]).

If you edit the SSO user name after using an incorrect one without closing the installer then you will not be able to configure the PSC/VCSA.

As I am sure you know, you cannot change the SSO domain after deployment so that means you need to power down the new PSC, delete the new PSC, close the installer, open a new installer, fill in all the information again, deploy another PSC, wait another 20 minutes, and sigh heavily (speaking from experience).
BUG: Hopefully this will be fixed in a future release.

Summary

The new Mac installer for VCSA is AWESOME! I am SO GLAD I no longer need Windows. Unfortunately, I had a couple snags, but it was straightforward to come up with a workaround. I think the installer in general could be a little simpler and more intuitive, but it is a huge leap forward from previous versions. Hats off to the vSphere team and looking forward the future (without Windows).

© 2016, Steve Flanders. All rights reserved.

12 comments on “VCSA 6.5 Installer Gotchas

Steve,
Just read your post and few comments:
#1 – Its not VMware Tools, its OVFTool 4.2, this could lead to some confusion
#2 – This is really the only gotcha. macOS Sierra isn’t one of the officially supported OSes and though its worked for some folks, it looks like its related to how directories are mounted. Thomas also recently blogged about this topic here https://kix1979.wordpress.com/2016/11/17/vcsa-6-5-macos-sierra/
#3 & #4 – This has been the case for some time, nothing unique to VCSA 6.5

Thanks William — I will update accordingly.

No need to copy over the vcsa dir. Simply set a symbolic link to it:
/private/var/folders/wc/920664w567s9hn2j2x1hft1w0000gn/T/AppTranslocation
ln -s /Volumes/CDROM/vcsa

works perfect!! Just needed to hit the Back button and continue one through the install after doing this step.

James Tyler says:

Thanks. Your tips worked, except now i’m getting another error;
Error: ovftool exited unexpectedly
debug: ovftoolCmd retrieved: /private/var/folders/nz/mmrn6lzj45z7wgft4tjm1tz00000gn/T/AppTranslocation/vcsa/ovftool/mac/ovftool
debug: ovaFile retrieved: /private/var/folders/nz/mmrn6lzj45z7wgft4tjm1tz00000gn/T/AppTranslocation/vcsa/VMware-vCenter-Server-Appliance-6.5.0.5100-4602587_OVF10.ova
info: probeOvf exited with status null
error: probeOvf null status, signal: null, error: { Error: spawnSync /private/var/folders/nz/mmrn6lzj45z7wgft4tjm1tz00000gn/T/AppTranslocation/vcsa/ovftool/mac/ovftool EACCES
at exports._errnoException (util.js:1008:11)
It can find the ovftool and ovaFile, but then crashes immediately it appears.

Hmm, I have not seen this. Have you tried running the ovftool against the OVA manually? Any chance you have a permissions problem on the directories or files?

Patrick R says:

Good Article – Can you upgrade VCSA 5.5 with the 6.5 install? Does this apply if the 5.5 isn’t on a domain but their is a dns on a domain?

Hey Patrick, per https://pubs.vmware.com/vsphere-65/topic/com.vmware.vsphere.upgrade.doc/GUID-30485437-B107-42EC-A0A8-A03334CFC825.html you can upgrade from VCSA 5.5 to 6.5. Being on a domain is not a requirement for VCSA.

Patrick R says:

Is it possible to fix the VCSA 6.5 if you made an error in the local.domain? Or do you have to x86 the VCSA and re-do ? OOPS 🙁

Hey Patrick — if you specify the wrong domain information during deploy of VCSA then your only supported option is to re-do.

Areeb says:

Lots of good info here. This is for 6.7 but I’ve experienced install failures if the password had certain special characters like * or #.

Hey Areeb — thanks for sharing!

Leave a Reply

Your email address will not be published. Required fields are marked *

Back To Top