WilliamLam.com

  • About
    • About
    • Privacy
  • VMware Cloud Foundation
  • VKS
  • Homelab
    • Resources
    • Nested Virtualization
  • VMware Nostalgia
  • Apple

How to tell if an ESXi host is a VSAN Witness Virtual Appliance programmatically?

09.26.2016 by William Lam // Leave a Comment

I had received this question awhile back but I was only able to get to it recently. If you are not familiar with the VSAN Witness Virtual Appliance and its purpose, Cormac Hogan did an excellent write-up on the topic which you can find it here.

how-to-tell-if-esxi-is-vsan-witness-vm-0
The reason this question came up was that if you were to simply iterate over all ESXi hosts within your vSphere Inventory from an Automation standpoint, you might find a mix of regular ESXi hosts and potentially this new VSAN Witness Virtual Appliance which is basically an ESXi host that runs in a VM (e.g. Nested ESXi). Although, it may look and feel like a regular ESXi host, it is not and the question was how might you go about distinguishing between the two? You can of course setup specific naming standards, folder structure or separate datacenter objects, but you still may accidentally retrieve a VSAN Witness host without even realizing it.

One quick solution is to check for a specific ESXi Advanced Setting called Misc.vsanWitnessVirtualAppliance which will return a value of 1 if it is the VSAN Witness Appliance. Here is a quick PowerCLI snippet which demonstrates how you can access this property:

$vmhost = Get-VMHost -Name 192.168.1.115
Get-AdvancedSetting -Entity $vmhost -Name Misc.vsanWitnessVirtualAppliance

how-to-tell-if-esxi-is-vsan-witness-vm-1
Although the method described above is one quick way to easily identify whether an ESXi host is a VSAN Witness Appliance, it is also limited in the information that it provides you. Another approach is to actually use the new VSAN 6.2 Management API and specifically the Stretched Clustering System APIs to retrieve the associated VSAN Witness host for a given VSAN Cluster. Not only will you get more information about the specific ESXi host providing the VSAN Witness functionality which will allow you to correlate back to your vSphere Inventory, but you will also get additional VSAN Witness configuration such as the preferred Fault Domain, Node UUID and the VSAN Cluster that it is associated with for example.

Here is a quick VSAN Management SDK for Python sample script that I had created called vsan-stretched-cluster-system-sample.py which implements the VSANVcGetWitnessHosts() API method. The script prints out a few of the WitnessHostInfo properties as shown in the screenshot below.

how-to-tell-if-esxi-is-vsan-witness-vm-2
One other option is if you simply just want to know if a given ESXI host is a VSAN Witness host or not, there is also the VSANVcIsWitnessHost() API that simply returns a boolean value. This might useful if you just have a list of ESXi hosts retrieved through the vSphere API and no knowledge of the underlying VSAN Clusters.

Categories // Automation, ESXi, PowerCLI, VSAN Tags // Misc.vsanWitnessVirtualAppliance, PowerCLI, Virtual SAN, VSAN, vSphere API, witness

How to tell if your vCenter Server Appliance (VCSA) was migrated from a Windows vCenter Server?

09.19.2016 by William Lam // 2 Comments

In case you had not heard, last week VMware had officially released the VCSA Migration Tool which is included in the new vSphere 6.0 Update 2m release. Customers can now easily migrate from a Windows based vCenter Server over to the vCenter Server Appliance (VCSA) all while preserving their existing vCenter Server configurations and integrations. For more details, I highly recommend you check out all the links and resources here related to the VCSA Migration Tool.

One interesting question that came up over the weekend from a troubleshooting standpoint was how do you tell if your VCSA was migrated from a Windows vCenter Server? Besides remembering 😉 there is actually a pretty simple way to check by looking at the install parameters as I have previously written about here. To do so, you will need to SSH to your VCSA and enable the Bash Shell first. Once that has been done, go ahead and run the following command:

install-parameter upgrade.source.platform

If your VCSA was migrated from a Windows based vCenter Server using the new VCSA Migration Tool, you should see a value of windows. If you do not get any results, then it means the VCSA was not migrated and it was freshly deployed as an appliance.

In addition, you can also check whether or not you had migrated over the original vCenter Server's Stats, Events and Tasks (SET) data. To do so, run the following command:

install-parameter upgrade.user.options

You should get back a value of either yes or no for migrating over the SET data.

Lastly, if your VCSA was migrated from a Windows based vCenter Server, you can even tell if the migration was done so using the UI or CLI. To do so, run the following command:

install-parameter upgrade.silent

You should get back a value of either True for a CLI-based migration or False for a UI-based migration.

Here is a quick screenshot of running the three commands on a VCSA that was migrated.
how-to-check-if-vcsa-was-migrated-from-windows

Categories // Automation, VCSA Tags // install-parameter, migrate2vcsa, migration, vcenter server appliance, VCSA, vcva

vCenter Server Appliance (VCSA) Migration Tool officially GAs w/vSphere 6.0 Update 2m

09.15.2016 by William Lam // 45 Comments

Today, I am very happy to announce that we have released the official Windows vCenter Server to vCenter Server Appliance (VCSA) Migration Tool which is part of the new VCSA vSphere 6.0 Update 2m release! I know many of you have been asking for an update since we released the VCS to VCSA Convert Appliance Fling a little over a year ago. The Fling was pretty limited in functionality and this was by design so that we could quickly get something out to our customers and get some early feedback. Although I could not say anything, the VMware Engineering team have been very hard at work incorporating all of the feedback in how they designed and built the official VCSA Migration Tool that you see today.

With that, I would like to extend a huge thanks to all of our customers who took part in the Fling and provided feedback both in the comments section as well as reaching out to me through the various channels. It was great to engage with literally hundreds of customers of all sizes and segments, all looking to move away from a Windows-based vCenter Server to the VCSA. Lastly, I want to thank our VMware Engineering team, both to the folks who lead the initial effort on the Fling prototype to those who then productized it! I was very fortunate to have been part of this amazing milestone at VMware.
vcs-migration-appliance-small

The VCSA Migration Tool workflow is quite different from how the Fling had worked which hopefully customers will appreciate. The team worked really hard on trying to simplify the overall user experience as well as trying to minimize the overall amount of downtime for the migration. In addition, we have also added full support for additional configurations and deployment topologies which you can find more details in the resource link below which includes an FAQ which I *highly* recommend folks have a look at before starting or asking further questions.

Collection of all #migrate2vcsa Links / Resources: vmwa.re/migrate2vcsalinks

Here is a quick video that I had recorded earlier which demonstrates a migration from a Windows vSphere 5.5 environment to VCSA 6.0 Update 2m, hopefully this will give you a nice overview of the migration process.

[UI Demo] - Migration of Windows vCenter Server 5.5 to vCenter Server Appliance 6.0 Update 2m from lamw on Vimeo.

One last thing I want to quickly mention is that this release is specifically targeted at customers looking to migrate from a Windows vCenter Server 5.5 to the VCSA 6.0 Update 2, hence the letter "m" denotation. If you are NOT looking to migrate your Windows vCenter Server to the VCSA, this release is NOT applicable to you as you will NOT be able to perform a new install and/or upgrade using this release. Instead, you should be looking at the vSphere 6.0 Update 2 release which is the exact same code base that vSphere 6.0 Update 2m is based off of. This will be even more apparent when you launch the VCSA Installer, as the "Migrate" button is the only option as shown in the screenshot below.

vcsa-migration-tool-vsphere-60update2m
For those planning to attend VMworld this year, we do plan to have several sessions covering the new VCSA Migration Tool as well as some other surprises 🙂 I hope to see you there and if you have any comments or feedback, feel free to leave it here or use the #migrate2vcsa hashtag if you are on Twitter, especially if you are interested in some of the surprises at VMworld.

Categories // VCSA, vSphere 6.0 Tags // migrate2vcsa, migration, Migration Assistant, vSphere 5.5, vSphere 6.0, vSphere 6.0 Update 2m

  • « Previous Page
  • 1
  • …
  • 305
  • 306
  • 307
  • 308
  • 309
  • …
  • 561
  • Next Page »

Search

Thank Author

Author

William is Distinguished Platform Engineering Architect in the VMware Cloud Foundation (VCF) Division at Broadcom. His primary focus is helping customers and partners build, run and operate a modern Private Cloud using the VMware Cloud Foundation (VCF) platform.

Connect

  • Bluesky
  • Email
  • GitHub
  • LinkedIn
  • Mastodon
  • Reddit
  • RSS
  • Twitter
  • Vimeo

Recent

  • VMware Flings is now available in Free Downloads of Broadcom Support Portal (BSP) 05/19/2025
  • VMUG Connect 2025 - Minimal VMware Cloud Foundation (VCF) 5.x in a Box  05/15/2025
  • Programmatically accessing the Broadcom Compatibility Guide (BCG) 05/06/2025
  • Quick Tip - Validating Broadcom Download Token  05/01/2025
  • Supported chipsets for the USB Network Native Driver for ESXi Fling 04/23/2025

Advertisment

Privacy & Cookies: This site uses cookies. By continuing to use this website, you agree to their use.
To find out more, including how to control cookies, see here: Cookie Policy

Copyright WilliamLam.com © 2025

 

Loading Comments...