Knowledge BaseTroubleshootingAdding a ZSphere host fails because the management VLAN differs from the cluster default VLAN

Adding a ZSphere host fails because the management VLAN differs from the cluster default VLAN

TroubleshootingZVF · ZSphereVersions4.xArticle IDKB-200043Updated2026-09-16

Issue/Introduction

This article helps troubleshoot failures to add a ZSphere host when the management VLAN differs from the cluster default VLAN.

Symptoms

  • Adding a host fails. The error contains default port group, managementIp vlanId, and an inconsistency with cluster default vlanId.
  • The target host network is reachable, but default port group initialization fails.

Environment

  • Product: ZVF
  • Version: 4.x
  • Component: ZSphere
  • Affected object: add host
  • Scenario: For host and hardware issues, confirm the current version, deployment type, storage type, and operation timeline.

Possible causes

  • The cluster default VLAN differs from the VLAN plan for the host management network interface.

Sign in to view the rest of this article, plus more troubleshooting and solution know-how.

Adding a ZSphere host fails because the management VLAN differs from the cluster default VLAN | KB-200043 | ZStack Resource Center