Add WxStack Cloud Platform
The xSpace management component integrates with WxStack's API interfaces to manage underlying computing resources. Due to the resource organization characteristics of the WxStack platform, basic "business group" preparation needs to be completed on the underlying platform side before integration.
1. Pre-requisite: Create Business Groups
Since the management component currently does not support dynamic creation of WxStack business groups via API calls, administrators need to pre-create business groups in the WxStack console for storing cloud desktops.
1.1 Access Business Group Management
In the WxStack management page, open the "Business Group" management page.

Tip: As a commonly used module in cloud desktop scenarios, it is recommended to star the "Business Group" entry menu and save it to the left navigation bar.
1.2 Create New Business Group
Click the "New Business Group" button in the upper right corner to create one.

1.3 Naming Convention and Filtering Mechanism
Enter the business group name. The core logic is as follows:
* Logical Mapping: WxStack's Business Group corresponds to xSpace's Project.
* Security Filtering: To avoid synchronizing non-desktop virtual machines (such as management components, access gateways, or other business cloud hosts) into xSpace, the system uses a "group prefix" matching mechanism.
* Naming Suggestion: By default, it is agreed to start with "VDI" (e.g., VDI001). Only business groups matching this prefix will be managed as "projects".
* Correspondence: Business Group ↔ xSpace Project ↔ Desktop Pool. These three have a one-to-one correspondence.
1.4 VM Preparation (Optional)
You can pre-create virtual machines in the business group, which will be used as cloud desktop resources after synchronization; or you can create desktops in xSpace desktop pools after project synchronization is complete (recommended method).
The created virtual machines will be located in the specified business group, facilitating subsequent synchronized management.

2. Operation Process
2.1 Access Interface
Log in to the xSpace system console and access "Resources -> Cloud Platforms".

2.2 Initiate Addition
2.3 Configure WxStack Attributes
Enter the various parameter information for the WxStack platform, then click "OK".

- Cloud Platform Address: The API access address of the WxStack management node.
- User/Password: Account with system management privileges.
- Group Prefix: Fill in the preset business group name characteristic used in WxStack (default value is
VDI).
3. Core O&M Logic
3.1 Resource Management Policy
- Only virtual machine instances within managed projects (business groups matching the prefix) will be synchronized to xSpace and mapped as desktops.
- Security Isolation: Ensure that the management component and access gateway virtual machines are placed in business groups without the VDI prefix, to prevent accidental operations if synchronized into the xSpace system.
3.2 Consistency Notes
The design logic regarding "Project ↔ Business Group/VM Group" and "group prefix filtering" also applies to SmartX and ZStack cloud platforms.
Note: For automatic synchronization mechanisms, progress monitoring, and troubleshooting after adding a cloud platform, please refer to Cloud Platform Overview -> 3. Resource Synchronization and Management Mechanism section.
