WilliamLam.com

  • About
    • About
    • Privacy
  • VMware Cloud Foundation
  • VKS
  • Homelab
    • Resources
    • Nested Virtualization
  • VMware Nostalgia
  • Apple
You are here: Home / VMware Cloud / Quick Tip - Avoid network conflicts with Docker Bridge Network on the vCenter Cloud Gateway for vSphere+/vSAN+

Quick Tip - Avoid network conflicts with Docker Bridge Network on the vCenter Cloud Gateway for vSphere+/vSAN+

07.12.2022 by William Lam // Leave a Comment

The new vSphere+/vSAN+ cloud service is now generally available for all customers! For those interested, I recently wrote about my first experience using the new vSphere+vSAN+ service with my vSphere Homelab environment, which I will also be updating based on the generally available service.

In addition to the resources above and in the VMC Cloud Console, here is a link to the official vSphere+/vSAN+ documentation including pre-req.

During my initial deployment of the vCenter Cloud Gateway (VCGW) used by the vSphere+/vSAN+ service, I did not run into any issues but upon deploying my second VCGW for a different environment, I ran into some networking issues. After a bit of debugging, I came to learn  that the VCGW application and services are composed of various Docker containers and there was a network conflict with the default Docker Bridge Network that the VCGW has been configured by default with.

The VCGW uses 172.17.0.1/16 for its Docker Bridge Network and this actually overlaps with my existing network where my on-premises vSphere environment. One symptom of this issue is that when attempting to register and connect VCGW with the VMC Cloud Console, you will notice the progress bar is stuck at exactly 50% during the "Retrieving Packages".


Unfortunately, this setting is not configurable as part of the initial VCGW deployment workflow, however it can be modified so that a conflict with the VCGW can be avoided.

Step 1 - If you have deployed the VCGW and attempted the registration, you will need to delete the deployment and redeploy. I have found that even updating the settings after the registration process has begun still runs into some other issue.

Step 2 - Before attempting to access the VAMI interface (https://FQDN:5480), SSH to VCGW using the root credentials that you had used during the deployment. Once you are logged in, go ahead and type "shell" to change into the Bash Shell

Step 3 - Edit the Docker configuration file /etc/docker/daemon.json and change the BIP address to another network which does not conflict (e.g. 172.50.0.1/16) and then save the changes

Step 4 - Lastly, reboot the VCGW for the changes to go into effect and once it is available, you can now proceed with the setup.

I have already shared this issue and feedback with our Engineering team and this experience should hopefully be improved in the future and better accommodate Docker Bridge Network changes to avoid network conflicts.

More from my site

  • VMware Cloud (VMC) Console Inventory with various vSphere "Linked Modes"
  • Finding vCenter Cloud Gateway Deployments in your environment
  • Logging into vCenter when vCenter Cloud Gateway (VCGW) is disconnected from vSphere+ Cloud Service
  • Frequently asked scenarios about Subscription & Entitlement for vSphere+, vSAN+ and VCF+
  • Frequently asked scenarios about Global Inventory for vSphere+, vSAN+ and VCF+

Categories // VMware Cloud, vSphere 7.0 Tags // vCenter Cloud Gateway, VMware Cloud

Thanks for the comment!Cancel reply

This site uses Akismet to reduce spam. Learn how your comment data is processed.

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...