virtuallyGhetto

William Lam

Getting started with the Hybrid Cloud Extension (HCX) APIs

by Leave a Comment

VMware Hybrid Cloud Extension (HCX) is the de facto VMware solution when it comes to Enterprise scale workload migration whether that is from onPrem to onPrem or from onPrem to Cloud, including our VMware Cloud on AWS (VMC) offering. In fact, one of the most popular use cases for HCX right now is datacenter evacuation/consolidation and customers are migrating their workloads to VMC because they want to get out of the business of running datacenters and get back to running their core business. This is especially attractive for customers wanting to expand to new markets without requiring the need of new datacenters. This makes a ton of sense, especially when you go beyond the initial CapEx, its the on-going OpEx costs that folks may not always be thinking about immediately and being able to easily scale up or down is not always possible for most onPrem environments.

HCX already provides a rich UI interface within the vSphere Client for scheduling migrations including the new Cloud Motion with vSphere Replication feature which was announced at VMworld US 2018.


However, it should come as no surprise that our customers are also interested in Automation, especially as it can help expedite migrations and remove potential user error, especially around mapping the destination networks which can be quite daunting for a large number of migrations. The good news is that HCX provides a Restful API that allows customers to automate all aspects of HCX including the HCX VAMI UI for initial configuration as well as consuming the HCX services which are exposed in the vSphere UI.

[Read more...] about Getting started with the Hybrid Cloud Extension (HCX) APIs

How to unregister Hybrid Cloud Extension (HCX) from your onPrem vCenter Server?

by 1 Comment

I recently had to redeploy my Hybrid Cloud Extension (HCX) setup on my onPrem vCenter Server as a newer version had been released since the last time I had looked at this which was some time last year. I had already deleted my HCX Manager and cleaned up the other HCX VMs but one thing that is not handled for you currently are the extension plugins that HCX uses to register with vCenter Server, which is no different than any other solution that integrates with vCenter Server.

Today, the only easy way to unregister an extension is to use the vSphere MOB, which I have blogged about in the past here. As you can see from the screenshot below, HCX has a number of plugins and because this is done by hand, its entirely possible that you may accidentally unregister the wrong extension which could severely impact your vCenter Server.


To help reduce that risk, an alternative and recommended method is to simply use the vSphere API (which is exactly what the vSphere MOB is talking to) and specifying the specific extensions to unregister. Below is a quick PowerCLI snippet which talks to the vSphere API and unregisters the 8 extensions related to HCX. After this, if you are still logged into the vSphere Client, you simply need to logout and log back in for the UI components to go away. If you are still seeing the UI plugins, you may need to restart the vSphere Client service.

Once the HCX extensions have been removed, you can now download the new HCX Manager appliance from the VMC portal and redeploy.

Getting started with the new NSX-T Policy API in VMC

by Leave a Comment

Today, when you deploy a new SDDC on VMware Cloud on AWS (VMC), it is based on NSX-V by default, nothing ground breaking. However, customers also have the option to request an NSX-T based SDDC, which actually came as a surprise to a couple of folks who I spoke with at VMworld. Back in August, Early Access for NSX-T based SDDC was announced and customers can take advantage of the additional networking and security capabilities provided by NSX-T within VMC. Humair Ahmed who works over in our Networking & Security Business Unit has an excellent blog post here that goes into more details. If you are interested in an NSX-T based SDDC, please reach out to your local VMware account team for more information.


Upon first glance, you might think that this is the exact same version of NSX-T that we have been shipping to our on-premises customers but in fact, it is actually a brand new and improved version. Similar to vSphere (vCenter and ESXi) and VSAN, VMC is always running a newer version of our software than our on-prem customers. One immediate difference that you should be aware of when using NSX-T in VMC is that the current NSX-T API is not available and instead a new NSX-T Policy API has been introduced to help simplify the consumption of NSX-T. All functionality in the current on-prem NSX-T API can be consumed using the new Policy API.

At VMworld, I spoke to a number of current and upcoming customers with NSX-T based SDDCs and they were really interested in using the new NSX-T Policy API and as the title of this blog post suggests, this will be a quick primer on how to do that. Before we get started, confirm that you have an NSX-T based SDDC deployed. If you are not sure, there are a few ways to determine this using either the VMC Console UI or API, instructions can be found here and here.

[Read more...] about Getting started with the new NSX-T Policy API in VMC

VSAN Managed Object Browser (MOB) in vSphere 6.7 & vSphere 6.7 Update 1

by 1 Comment

If you have ever spent any time using the vSphere API, you probably have heard of or have used the vSphere Managed Objected Browser (MOB) which is an extremely useful learning and debugging tool when working with the vSphere API. The vSphere MOB is accessed through a web browser connecting to either vCenter Server or ESXi and provides a graphical interface, allowing you to discovery/explore the underlying vSphere API and its data in a very intuitive manner.

As an avid user of the VSAN Management API since its release, I have always wanted something similar, especially when I first got started. I was quite happy when I found out in vSphere 6.7 and VSAN 6.7, the VSAN team has added a VSAN MOB interface directly on ESXi, for the VSAN specific APIs that are available only on an ESXi host. Just like the vSphere MOB which is also available on ESXi host, it is disabled by default and must be enabled.

The following ESXCLI commands can be used to enable/disable the VSAN MOB on ESXi 6.7:

esxcli vsan debug mob start
esxcli vsan debug mob stop

However, when I tried to enable the VSAN MOB, I ran into the following error message:

hostname 'localhost.localdomain' doesn't match '192.168.30.10'


It turns out there is an issue where it fails to match the IP Address of the ESXi host to the default localhost.localdomain and hence it fails to start the VSAN MOB. This issue is fixed in the upcoming vSphere & VSAN 6.7 Update 1, but in the mean time, there is a workaround.

[Read more...] about VSAN Managed Object Browser (MOB) in vSphere 6.7 & vSphere 6.7 Update 1

Using VMC API to answer commonly asked questions about your SDDC

by Leave a Comment

In the past month or so since joining the VMware Cloud on AWS (VMC) team, I have seen a number of inquiries from our Customer Success team, partners and customers on how to retrieve certain pieces information about their deployed SDDC, usually for information or integration purposes. Some of these questions can simply be answered by using the VMC Console UI, however there are others that is only available when using the VMC API, which provides a ton more data than what the UI could ever display. In any case, I figure it would be useful to share some of this information, especially as it pertains to the VMC API.

Below are just some of the frequently asked questions that I have seen and they can all be answered simply performing a GET /api/orgs/<orgId>/sddcs/<sddcId> on your specific SDDC via VMC API. In addition, I have also create two sample scripts which exercises these VMC APIs, one using the native VMC REST API and another with PowerCLI using the VMC cmdlet, which you can find more details below.

1) What version is my SDDC running?

This can be found in the VMC Console UI under the "Support" tab for a given SDDC.


You can also find this information using the VMC API by referring to the resource_config.sddc_manifest.vmc_version property.

2) When was my SDDC created?

This can be found in the VMC Console UI under the "Support" tab for a given SDDC.


You can also find this information using the VMC API by referring to the created property.

3) How long do I have until my 1-Node SDDC expires?

This can be found in the VMC Console UI under the SDDC card summary view or detailed view.


You can also find this information using the VMC API by referring to the expiration_date property. This property will be null if your SDDC is NOT a 1-Node, which is the only configuration which has an expiration.

[Read more...] about Using VMC API to answer commonly asked questions about your SDDC

Direct playback & download URLs for all VMworld 2018 US Sessions

by 12 Comments

It has been less than 24 hours since VMworld 2018 has concluded and the awesome VMworld team has already published most, if not all VMworld 2018 US session recordings! Similar to past years, I have put together a nice summary page that contains all the session recordings links separated out by the different  categories which you can find by visiting http://vmwa.re/vmworld2018.

As of writing this, there are a total of 585 sessions with 570 published with recordings. I will check back in a week or so in case more videos and/or PPT decks are posted. Please enjoy, especially for those that were not able to attend VMworld this year.

UPDATE 1 (09/01/18) - It looks after publishing the streaming URLs, folks found that it included a direct download link to the .MP4 file. Thanks to Jorge de la Cruz from the community who was able to extract this from my original github repo. I have gone ahead and also updated my repo to include both the streaming and download URL for folks who just want to download individual sessions. There are a number of ways to "Automate" the download including using wget or Invoke-Webrequest.

UPDATE 2 (09/03/18) - If you try to download the files without going through my github repo (browser or through automation), you may noticed you get a 404 error message. It turns out the client performing the download must include a referer within the request (which is automatically done for you when you click open the link in my github but not the case using wget/cURL or other tools. Below are a few examples on how to include the referer for automated downloads.

Here is wget example:

wget --referer http://www.vmware.com https://s3-us-west-1.amazonaws.com/vmworld-usa-2018/VIN2527BU.mp4

Here is cURL example:

curl --referer http://www.vmware.com https://s3-us-west-1.amazonaws.com/vmworld-usa-2018/VIN2527BU.mp4 -O VIN2527BU.mp4

Here is PowerCLI example:

$headers = @{"referer" = "http://www.vmware.com"}
Invoke-WebRequest -Uri https://s3-us-west-1.amazonaws.com/vmworld-usa-2018/VIN2527BU.mp4 -Headers $headers -Outfile VIN2527BU.mp4

In addition, I have also published us.txt file which contains the name of the session + download URL which can then be used by this quick PowerShell script called downloadSessions.ps1 to automatically download. You can edit the us.txt file to only include sessions you want downloaded (make sure its copied from the original file) since it contains "#" symbol as a delimiter for the title and the download URL.