Content Architecture for API Documentation
|

Content Architecture for API Documentation

📐 Best Practices from the Field When developers interact with your product, the documentation is the interface. And while code may power the platform, it’s content architecture that powers clarity. Over the past decade, working with enterprise APIs in environments like VMware, I’ve learned that the best documentation isn’t just accurate—it’s deliberately structured to support…

My Experience with the DCCA Certification, a Comprehensive Review

My Experience with the DCCA Certification, a Comprehensive Review

Introduction After completing the Schneider Electric Data Center Certified Associate (DCCA) exam, I’m excited to share my experience, insights, and practical takeaways for anyone considering the course. With 20 years of experience in data centers and a background in electrical engineering and computer systems, I entered the exam with a solid foundation. However, I knew…

VCF for NSX Engineers

VCF for NSX Engineers

Introduction VMware Cloud Foundation (VCF) is a software-defined data center (SDDC) platform that combines multiple VMware technologies, including vSphere, vSAN, NSX, and SDDC Manager, into a single, integrated solution. This article takes a look at what VMware Cloud Foundation (VCF) means for a VMware NSX network engineer in an NSX edge deployment. SDDC Manager NSX components are…

NSX Home Lab Series – 7. NSX Install

NSX Home Lab Series – 7. NSX Install

Objective: The goal is to deploy an NSX manager in the lab environment. The NSX Manager provides a web-based user interface where you can manage your NSX environment. It also hosts the API server that processes API calls. Product Interoperability Check: From the VMware Product Interoperability Matrix, for the versions running in the lab: NSX versions 4.0.1.1, 4.1.0.0, and…

NSX Home Lab Series – 4. NTP

NSX Home Lab Series – 4. NTP

You can’t reliably run a vCenter or NSX environment without infrastructure time synchronization. As with DNS, save yourself time, and get this working before deploying vCenter and NSX Manager. This fourth in a series of NSX Home Lab articles, looks at simple approach to providing NTP services within an NSX home lab. Objective: The goal…

VMware Validated Designs are Discontinued

VMware Validated Designs are Discontinued

Introduction: VMware Validated Designs are a collection of comprehensive end-to-end design guides that serve as a blueprint for a Software-Defined Data Center (SDDC) implementation. VMware Validated Designs have been discontinued, are retained as a historical reference, and have evolved into VMware Cloud Foundation Designs. To better understand what this means from an NSX perspective, it’s…

Troubleshooting NSX Stateful Active Active mode

Troubleshooting NSX Stateful Active Active mode

NSX version 4.0.1.1 introduces support for stateful services on Tier-0 and Tier-1 gateways in Active-Active HA mode, where one Service Router (SR) can span multiple active edge nodes. This feature offers improved resource usage and scale-out for higher performance. This article introduces a three-step troubleshooting approach that can be used to determine the traffic path to…

Aspirational Labour Works!

Aspirational Labour Works!

Introduction: Due to numerous requests I have rebooted spillthensx, with an updated name. Connecting with the VMware community has been a very rewarding experience, and I’m starting up again in 2023! Keep in mind that aspirational labour works! Aspirational labour is a mode of uncompensated, independent work that is propelled by the ideal of doing…

Troubleshooting BGP Peering onNSX-T Edges

Troubleshooting BGP Peering on NSX-T Edges

Introduction: In this article, we will look at a troubleshooting approach for network connectivity issues, known as the Bottom-Up Methodology. We will take a close look at troubleshooting BGP Peer Establishment on NSX-T edges to illustrate this approach. Physical Layer Troubleshooting, troubleshooting the transfer of bits Physical Layer Troubleshooting, sample topology for BGP Peers We…

NSX-T Edge Commands

NSX-T Edge Commands

Introduction: In assisting customers with a wide variety of NSX-T related issues, I’m constantly pulling up cheat sheets for frequently used commands. This is the second in a series of pages, my favorite NSX-T Edge commands, where I’m selfishly pulling these commands together as a reference. I plan to add to this page over time,…

NSX-T REST API Tips

NSX-T REST API Tips

Introduction: Here is a collection of REST API tips I’ve learned while supporting NSX-T. The tips are organized in sections for beginner, intermediate, and advanced users. I’m hoping there is something here for everyone! Beginner Tips, getting set up to access the REST API: 1. NSX-T Manager hosts it’s own REST API Reference You will…

NSX-T ESXi Commands

NSX-T ESXi Commands

Introduction: In assisting customers with a wide variety of NSX-T related issues, I’m constantly pulling up cheat sheets for frequently used commands. This is the first in a series of pages, my favorite NSX-T ESXi network commands, where I’m selfishly pulling these commands together as a reference.

Introduction to NSX-T Principal Identities

Introduction to NSX-T Principal Identities

Introduction: In NSX-T, Principal Identities (PI) are role-based users who have ownership of the objects they create. Objects can only be modified or deleted by the owning Principal Identity. PI is an effective method to manage multi-tenancy, where multiple tenants share the same resource infrastructure. In NSX-T, Principal Identities: – are certificate-based, and are considered…

The Standalone VLAN Based OneArm Load Balancer

The Standalone VLAN Based OneArm Load Balancer

Introduction: The NSX-T VLAN Based OneArm Load Balancer on a Standalone Tier-1 Gateway scenario is often of interest to VMware customers that use NSX-T without VXLAN. These customers primarily use NSX-T for micro-segmentation and edge functionality. Network Topology: In this article, we will look at a simple base topology from which you can build. Although…

NSX-T 3.0 User Interface Mode

NSX-T 3.0 User Interface Mode

Introduction: As NSX-T evolves, users are moved closer to using Policy-based objects. NSX-T 3.0 introduces a User Interface Mode that by default is hidden and presents users only Policy-based objects to the UI in greenfield deployments. From What’s New, in the NSX-T 3.0 release Notes: User Interface Preferences for NSX Policy versus Manager Modes – You can…

NSX-T TEP IP Addressing Considerations

NSX-T TEP IP Addressing Considerations

Introduction: NSX-T TEP IP address misconfiguration is one of the most common issues associated with new NSX-T deployments. It can lead to downed GENEVE tunnels between ESXi hosts and NSX-T Edges, in collapsed Compute/Edge Cluster topologies. In this scenario, NSX-T backed virtualized guests can reach each other, but not the physical environment. In this article,…

NSX-T TLSv1.1 Disablement using cURL

NSX-T TLSv1.1 Disablement using cURL

Introduction: Transport Layer Security (TLS) is a cryptographic protocol designed to provide communications security over a computer network. This article looks at NSX-T TLSv1.1 disablement using cURL, leaving Web clients to connect to the NSX-T Manager Web UI via TLSv1.2. Questions around NSX-T TLSv1.1 disablement have come in from some VMware customers looking at PCI compliance….

NSX-T 2.5 ESXi Logging Enhancements

NSX-T 2.5 ESXi Logging Enhancements

Introduction: There have been some significant enhancements in NSX-T 2.5 to ESXi host logging. The logging level can be changed dynamically, and logs are now consolidated under Syslog offering more powerful and flexible NSX-T troubleshooting options at the ESXi host level. VMware CLI Reference Guides These changes are covered in the NSX-T Data Center 2.5.0…

NSX-T Automation with Ansible

NSX-T Automation with Ansible

Introduction Ansible is an open-source automation tool used for IT tasks such as configuration management, application deployment, and provisioning. This post is the first in a series of articles that review automation with Ansible in an NSX-T 2.5 lab environment. In this series, VMware’s NSX-T Ansible Modules will be used to: Deploy the NSX-T Management plane…

NSX-T Deployment Automation – Part 1

NSX-T Deployment Automation – Part 1

Introduction: I’ve been experimenting with NSX-T deployment automation, working on a method to quickly deploy typical network topologies for repro and testing. A typical lab topology consists of Tier-0 and Tier-1 gateways and segments, where one or more object IDs uniquely identify each construct. NSX-T Universally Unique IDentifiers (UUID) NSX-T identifies objects using Universally Unique…

NSX-T Data Path Troubleshooting using nsxcli capture

NSX-T Data Path Troubleshooting using nsxcli capture

Introduction: The nsxcli includes the capture command, a useful debugging tool to capture specified network traffic at various points and stages in the network processing pipeline. It is a valuable and powerful tool to troubleshoot a variety of network issues. In this article, we will look at using nsxcli capture in a data path troubleshooting…

NSX-T with Jam, trouble with DFW, SOLVED!

NSX-T with Jam, trouble with DFW, SOLVED!

Introduction: Congratulations to Omkar, the winner of the first Spill the NSX-T Reader Challenge! And thank you Chris, our Ireland based correspondent that delivered the winning prize, a cup of tea. 🙂 Here is a brief summary of the issue: Additional problem description details are found here: https://spillthensxt.com/nsx-t-with-jam-trouble-with-dfw/ Question: Why does VM2’s DFW Filter have…

NSX-T with Jam, trouble with DFW

NSX-T with Jam, trouble with DFW

Introduction: Inspired by Mike Da Costa’s NSX/NSX-T Troubleshooting Scenarios, I’m putting out an NSX-T troubleshooting challenge to those who know me on Twitter as @spillthensxt. In this scenario, a specific Guest VM has no Distributed Firewall (DFW) rules applied. It’s now time for some NSX-T DFW troubleshooting! This is a Spill the NSX-T Reader Challenge:…

DHCP Server Configuration in NSX-T

DHCP Server Configuration in NSX-T

Introduction: The Dynamic Host Configuration Protocol (DHCP) allows clients to obtain their network configuration from a DHCP server automatically. In NSX-T, this means the allocation of IP address, subnet mask, and default gateway. This article is a brief guide to get you up and running with an NSX-T managed Local DHCP Server configuration. NSX-T supports…

Geneve Tunnel Dependencies in NSX-T

Geneve Tunnel Dependencies in NSX-T

Introduction: This post covers two crucial Geneve Tunnel dependencies to be aware of within NSX-T network virtualized environments: High-Level Concept to Remember: If the Geneve Bidirectional Forwarding Detection (BFD) tunnels are not up due to misconfiguration or other network issues, the Edge’s failover mechanism triggers causing the Edge Node to drop its BGP neighborships. This failsafe mechanism…

How to Validate MTU in an NSX-T Environment

How to Validate MTU in an NSX-T Environment

Introduction: NSX-T leverages the Generic Network Virtualization Encapsulation (Geneve) protocol, a network virtualization tunneling protocol used to establish tunnels across transport nodes to carry overlay traffic. Transport nodes include VM and physical-based Edges, ESX hosts, and KVM Hypervisors, all of which require at least one Geneve Termination End Point (TEP). With encapsulation technologies, like Geneve,…

NSX-T Edge Maintenance Mode 2

NSX-T Edge Maintenance Mode 2

Edge Maintenance Mode Overview The NSX-T Edge cluster is a logical grouping of NSX-T Edge virtual machines that provide North-South routing for the workloads in compute clusters. NSX-T Edges can be taken out of production by being placed in maintenance mode, if for example, the Edge has become inoperable. In the first post of this…

NSX-T Edge Maintenance Mode (1)

NSX-T Edge Maintenance Mode (1)

Edge Maintenance Mode Overview The NSX-T Edge cluster is a logical grouping of NSX-T Edge virtual machines that provide North-South routing for the workloads in the compute clusters. NSX-T Edges can be taken out of production by being placed in maintenance mode, if for example, the Edge has become inoperable. If high availability is enabled…

Disabling the NSX-T DFW

Disabling the NSX-T DFW

Background: It is possible to disable the NSX-T Distributed Firewall (DFW) using a REST API Client or using cURL (Client URL) via the command line. This article reviews both methods. Get the current DFW Status with Postman: Let’s begin with a REST API Client, in this case it’s Postman for Google Chrome. Start by setting up…

Connecting NSX-T to LDAPS

Connecting NSX-T to LDAPS

Introduction: Identity Firewall (IDFW) features allow an NSX-T administrator to create Active Directory user-based Distributed Firewall (DFW) rules. IDFW requires NSX-T access to Active Directory user objects. This access is achieved through an NSX-T to LDAP (Lightweight Directory Access Protocol) connection. Connecting NSX-T to LDAPS is a part of the Identity Firewall Workflow. Details in…

Tier-0 Connectivity to Physical

Tier-0 Connectivity to Physical

Introduction: NSX-T Data Center Edges carry all traffic in and out of the Software-Defined Data Center network, providing connectivity between virtualized and physical environments. The goal of this blog post is to review some issues that result in an inability for a Tier-0 gateway to ping it’s directly connected physical peer IP. NSX-T introduces a…

Troubleshooting NSX-T Backups

Troubleshooting NSX-T Backups

Overview: Backups are an important part of maintaining an NSX-T environment. Troubleshooting backups through the UI can be challenging since the errors are often generic. In this post we’ll begin with a review of NSX-T backup configuration parameters, look at some troubleshooting options performed from the NSX-T Manager CLI, and troubleshoot an SFTP backup failure….

NSX-T BGP Configuration

NSX-T BGP Configuration

[fusion_builder_container hundred_percent=”no” equal_height_columns=”no” menu_anchor=”” hide_on_mobile=”small-visibility,medium-visibility,large-visibility” class=”” id=”” background_color=”” background_image=”” background_position=”center center” background_repeat=”no-repeat” fade=”no” background_parallax=”none” parallax_speed=”0.3″ video_mp4=”” video_webm=”” video_ogv=”” video_url=”” video_aspect_ratio=”16:9″ video_loop=”yes” video_mute=”yes” overlay_color=”” video_preview_image=”” border_size=”” border_color=”” border_style=”solid” padding_top=”” padding_bottom=”” padding_left=”” padding_right=””][fusion_builder_row][fusion_builder_column type=”1_1″ layout=”1_1″ background_position=”left top” background_color=”” border_size=”” border_color=”” border_style=”solid” border_position=”all” spacing=”yes” background_image=”” background_repeat=”no-repeat” padding_top=”” padding_right=”” padding_bottom=”” padding_left=”” margin_top=”0px” margin_bottom=”0px” class=”” id=”” animation_type=”” animation_speed=”0.3″ animation_direction=”left” hide_on_mobile=”small-visibility,medium-visibility,large-visibility”…

How can I use Postman or Curl to administer NSX-T with a vIDM Account?

How can I use Postman or Curl to administer NSX-T with a vIDM Account?

[fusion_builder_container hundred_percent=”no” equal_height_columns=”no” menu_anchor=”” hide_on_mobile=”small-visibility,medium-visibility,large-visibility” class=”” id=”” background_color=”” background_image=”” background_position=”center center” background_repeat=”no-repeat” fade=”no” background_parallax=”none” parallax_speed=”0.3″ video_mp4=”” video_webm=”” video_ogv=”” video_url=”” video_aspect_ratio=”16:9″ video_loop=”yes” video_mute=”yes” overlay_color=”” video_preview_image=”” border_size=”” border_color=”” border_style=”solid” padding_top=”” padding_bottom=”” padding_left=”” padding_right=””][fusion_builder_row][fusion_builder_column type=”1_1″ layout=”1_1″ background_position=”left top” background_color=”” border_size=”” border_color=”” border_style=”solid” border_position=”all” spacing=”yes” background_image=”” background_repeat=”no-repeat” padding_top=”” padding_right=”” padding_bottom=”” padding_left=”” margin_top=”0px” margin_bottom=”0px” class=”” id=”” animation_type=”” animation_speed=”0.3″ animation_direction=”left” hide_on_mobile=”small-visibility,medium-visibility,large-visibility”…

Are my ESXi host NICs driver and firmware compatible, and NSX-T ready?

Are my ESXi host NICs driver and firmware compatible, and NSX-T ready?

[fusion_builder_container hundred_percent=”no” equal_height_columns=”no” menu_anchor=”” hide_on_mobile=”small-visibility,medium-visibility,large-visibility” class=”” id=”” background_color=”” background_image=”” background_position=”center center” background_repeat=”no-repeat” fade=”no” background_parallax=”none” parallax_speed=”0.3″ video_mp4=”” video_webm=”” video_ogv=”” video_url=”” video_aspect_ratio=”16:9″ video_loop=”yes” video_mute=”yes” overlay_color=”” video_preview_image=”” border_size=”” border_color=”” border_style=”solid” padding_top=”” padding_bottom=”” padding_left=”” padding_right=””][fusion_builder_row][fusion_builder_column type=”1_1″ layout=”1_1″ background_position=”left top” background_color=”” border_size=”” border_color=”” border_style=”solid” border_position=”all” spacing=”yes” background_image=”” background_repeat=”no-repeat” padding_top=”” padding_right=”” padding_bottom=”” padding_left=”” margin_top=”0px” margin_bottom=”0px” class=”” id=”” animation_type=”” animation_speed=”0.3″ animation_direction=”left” hide_on_mobile=”small-visibility,medium-visibility,large-visibility”…

NSX-T 2.4 with both Simplified and Advanced UI

NSX-T 2.4 with both Simplified and Advanced UI

[fusion_builder_container hundred_percent=”no” equal_height_columns=”no” menu_anchor=”” hide_on_mobile=”small-visibility,medium-visibility,large-visibility” class=”” id=”” background_color=”” background_image=”” background_position=”center center” background_repeat=”no-repeat” fade=”no” background_parallax=”none” parallax_speed=”0.3″ video_mp4=”” video_webm=”” video_ogv=”” video_url=”” video_aspect_ratio=”16:9″ video_loop=”yes” video_mute=”yes” overlay_color=”” video_preview_image=”” border_size=”” border_color=”” border_style=”solid” padding_top=”” padding_bottom=”” padding_left=”” padding_right=””][fusion_builder_row][fusion_builder_column type=”1_1″ layout=”1_1″ background_position=”left top” background_color=”” border_size=”” border_color=”” border_style=”solid” border_position=”all” spacing=”yes” background_image=”” background_repeat=”no-repeat” padding_top=”” padding_right=”” padding_bottom=”” padding_left=”” margin_top=”0px” margin_bottom=”0px” class=”” id=”” animation_type=”” animation_speed=”0.3″ animation_direction=”left” hide_on_mobile=”small-visibility,medium-visibility,large-visibility”…