Skip to content

1. Environment Requirements

Server

Number of TerminalsNumber of ServersNumber of PortsCapacityLoad TypeRemarks
200-800124TSingle-machine loadDual-NIC load balancing optional
800-2000224T+Dual-machine loadDual-server load balancing recommended
2000+2+24T+Multi-machine loadMulti-server load balancing recommended

Client

Terminal TypeCPUMemoryDiskRemarks
X86/X642G+1G+32G+When terminal memory is below 1G, the software may not run properly
Domestic chips (Loongson / Phytium / Kunpeng, etc.)——2G+32G+Compatible with common domestic-chip machines on the market; see Build Image Linux/Domestic

2. Software Environment

Server-side Software Environment Requirements

ItemRequirementRemarks
Server OSWindows Server 2008R2 and above / Linux serverNone
Console browserGoogle Chrome 109 and above (or same-kernel Edge)The console is the new Web management end

Terminal Software Environment Requirements

System NameSupportRemarks
windows 98/MENot supported
windows 2000Not supported
windows XP/2003-X86/X64Not supported
windows Vista/Server 2008No longer supported
windows 7/Server 2008R2None
windows 8/8.1 / Server 2012(R2)None
windows 10/11+None
Ubuntu / Debian / Fedora / OpenSUSENone
CentOS / RedHatNone
NeoKylin / Kylin / UnionTech UOS and other domestic systemsSee Build Image Linux/Domestic
Other LinuxNone

2. Server-side Installation

1) Install the server

TypeInstallation MethodRemarks
Windows serverInstall with defaults directly, no special configuration neededNone
Linux serverCopy the installation file to the server's /switch directory, run chmod 777 /switch then install.sh; requires an Internet connectionNone

3. Initialize the Server

1) Open the console

Open a browser and enter to open the console and initialize the server.

The console is multilingual by default; you can switch between Chinese / English and other languages in the top-right corner.

2) Initialization wizard

Initialization wizard

  1. Server name: used to identify the server; in a multi-server environment, give it an easy-to-remember name
  2. Server IP: the automatically detected server IP. Please first confirm the server has a static IP set and that it matches the server's actual configuration; if detected incorrectly, you can edit it manually
  3. Remarks: remark information

3) Service DHCP information

DHCP information

This setting is meaningful when the server and clients are on the same LAN; it is meaningless when they are not on the same LAN — just turn it off.

4) Set the working directory

Working directory

The working directory is the storage directory for client images. You can select multiple at once; building a RAID is recommended.

5) Set the computer group

Computer group

The default computer group, which is also the first computer group.

6) Create a computer

Create a computer

Computer type EFI/BIOS: choose BIOS for very old machines; use EFI for new machines.

7) Done

4. Install the Client

1) Install the client on a template machine with the OS already installed

TypeInstallation MethodRemarks
Windows clientInstall with defaults directly, no special configuration neededNone
Linux clientPackage and build using the dedicated tool; see Build Image Linux/DomesticNone

Optimizations and changes the client install makes to the system

Changes the Windows client install makes to the systemPossible ImpactReason for Change
Automatically disables "update system drivers through Windows Update"Cannot update hardware drivers via Windows Update1. Auto-updating the NIC driver during network boot may cause a crash; 2. Prevents various faults caused by driver updates during operation
Sets the NIC service start=0No impactCompatible with network boot: when a desktop has not been distributed or distribution failed but class must start, you can network-boot and cache while in use, then sync the full cache later
Changes service load orderNo impactCompatible with network boot, same reason as above
Intercepts physical disk readsAffects obtaining SMART info from the physical diskIf you need physical-disk SMART, view the X-drive info directly (the X drive passes through physical-disk SMART); you can also view detailed health under Desktop → SSD Health
Disables network discoveryNonePrevents one image serving multiple machines and IP changes within a classroom from causing Win10 to pop up network discovery and block the right-side area
Changes the Linux client install makes to the systemPossible ImpactRemarks
Fully disables NetworkManagerNetwork cannot be configured within the system; related network tools won't openPrevents user network configuration from causing IP misconfiguration and connection interruption

2) After the Windows client install completes, the image upload tool opens automatically

Enter the server IP, username and password; default admin / 123456.

  1. With a single server, keep the default service selection
  2. Image name: enter an easy-to-remember name, e.g. win1022h2
  3. Select partition: the C drive is selected by default; the EFI partition is uploaded automatically along with it, no special setup needed

Do not perform any operation on the system during upload.

After the upload completes, the "Start Upload" button changes from gray to available. The "Warning" can be ignored: after the upload completes it sends multiple messages to close the network disk, and multiple retries will produce a prompt; the data is normal at this point and does not affect use.

3) Apply the image: Console → Desktop → Desktop pool

Desktop pool

Go to Desktop → Desktop pool. The "Virtual Disk List" on the left is the virtual disk you just uploaded; the number after it (e.g. 1) is the desktop version number, indicating a successful upload.

Select the virtual disk you just uploaded on the left and click Apply to Template, fill in the desktop name and template remarks to generate a desktop template; the template appears in the "Desktop Template" list on the right.

4) Mount the desktop to a group

Mount to group

In the "Desktop Template" list on the right, select the template you just generated, click Mount to Group, check the groups to mount, then click OK.

5. Add Computers

1) Create a computer group

Navigate to Desktop → Desktop management.

Desktop management

Create a group (i.e. a classroom) in the group area on the left.

2) Create a computer

Navigate to Desktop → Desktop management → Computer → Add.

Computer menu

Add computer

  1. Group: select a child node; do not create the computer at the root node or an intermediate node
  2. Name prefix: the computer name prefix; adding the classroom name is recommended, e.g. 202-, for easy distinction
  3. Start IP, subnet mask, gateway, DNS: fill in according to the classroom's actual info
  4. Computer type: defaults to EFI boot; choose BIOS for old machines; select the CPU architecture by machine (including domestic-chip architectures)
  5. Maintenance channel: keeping it on is recommended; after download completes it triggers one automatic maintenance and optimizes the system; if you place drivers in the client's c:\tools directory it can trigger automatic driver installation
  6. Maintenance channel template: once selected, newly created computers automatically apply this maintenance channel template

3) Switch the default join group

Navigate to Desktop → Desktop management → Computer → Join Settings.

Join Settings

Turn on "Allow new computers to join" and set the "Default join group" to the group you just created.

4-1) PXE boot (server and client on the same LAN)

Quick-access methods for network boot on mainstream computers

Brand/TypeKey (press repeatedly at power-on)Remarks
LenovoF12 or Fn+F12Some models use F12 to select the boot option
DellF12Press when the Dell logo appears
HPF12 or F9Mostly F12 for commercial, F9 for some
ASUSF8 or EscPress Esc to enter the boot menu, then select PXE
AcerF12Press repeatedly at power-on
HuaweiF12Mostly F12 for desktops/laptops
XiaomiF12Mostly F12 for laptops
Tsinghua TongfangF12Commonly F12 for the boot menu
HaseeF7 or F12Depends on the model
Intel NUCF10F10 on some models
Generic/OtherF12, F11, F8, EscMost motherboards use F12 or Esc

Disabling Secure Boot on mainstream computers

Brand/TypeKey to enter BIOSSecure Boot disable path (approximate)Remarks
LenovoF1 or F2Security → Secure Boot → DisabledSome are under Boot; you must set a password first before changing
DellF2Boot → Secure Boot → DisabledOr disable via Security → Secure Boot Enable
HPF10 or EscSystem Configuration → Boot Options → Secure Boot → DisabledSome are under the Security menu
ASUSDel or F2Boot → Secure Boot → OS Type to Other OS, or turn off Secure BootSome require Advanced → Boot
AcerF2Security → Secure Boot → DisabledSome models under Main or Boot
HuaweiF2 or F12Security → Secure Boot → DisabledWhen on the same screen as the boot options, enter via Security
XiaomiF2Security → Secure Boot → DisabledSome are in the Boot options
Tsinghua TongfangDel or F2Security / Boot → Secure Boot → DisabledDepends on the BIOS version
HaseeDel or F2Security → Secure Boot → DisabledOr under the Boot menu
Intel NUCF2Boot → Secure Boot → DisabledSome on the Security page
Generic/OtherDel, F2, F1, EscSecurity or Boot → Secure Boot → DisabledThe name may be Secure Boot Enable to turn off

Power on using network boot.

It will automatically enter the ROM after the timeout; if you don't want to wait, press F7 to enter directly.

Select the computer to bind.

  1. After selecting, you enter the main interface directly
  2. Repeat the steps above to add all the computers in the entire classroom; when adding, add them correctly by the computer seating order
  3. When the computer list is too long, press F5 to refresh the list before selecting

4-2) Use a USB drive to boot into ROM (server and computer room not on the same LAN: across VLAN, campus, or Internet)

USB drive creation tool

  1. Creating a bootable USB drive will erase the USB data
  2. At "select device", make sure you select the USB drive
  3. At "boot server ip", enter the server IP

4-2-1) Use the USB drive to boot the first computer

Quick-access methods for the boot menu on mainstream computers

Brand/TypeKey (press repeatedly at power-on)Remarks
LenovoF12 or Fn+F12Some models use F12 to select the boot option, then choose USB
DellF12Press when the Dell logo appears, select USB or UEFI USB
HPF9 or F12Mostly F9 for the boot menu, F12 for some
ASUSF8 or EscPress Esc to enter the boot menu, then select the USB drive
AcerF12Press repeatedly at power-on, select USB in the menu
HuaweiF12 or F7Mostly F12 for desktops/laptops
XiaomiF12Enter the boot menu, then select the USB device
Tsinghua TongfangF12Commonly F12 to bring up the boot menu
HaseeF7 or F12Depends on the model; select USB boot
Intel NUCF10F10 is the boot menu on some models
Generic/OtherF12, F11, F8, EscMostly F12 or Esc to enter the boot menu and select the USB drive

Disabling Secure Boot on mainstream computers

Brand/TypeKey to enter BIOSSecure Boot disable path (approximate)Remarks
LenovoF1 or F2Security → Secure Boot → DisabledSome are under Boot; you must set a password first before changing
DellF2Boot → Secure Boot → DisabledOr disable via Security → Secure Boot Enable
HPF10 or EscSystem Configuration → Boot Options → Secure Boot → DisabledSome are under the Security menu
ASUSDel or F2Boot → Secure Boot → OS Type to Other OS, or turn off Secure BootSome require Advanced → Boot
AcerF2Security → Secure Boot → DisabledSome models under Main or Boot
HuaweiF2 or F12Security → Secure Boot → DisabledWhen on the same screen as the boot options, enter via Security
XiaomiF2Security → Secure Boot → DisabledSome are in the Boot options
Tsinghua TongfangDel or F2Security / Boot → Secure Boot → DisabledDepends on the BIOS version
HaseeDel or F2Security → Secure Boot → DisabledOr under the Boot menu
Intel NUCF2Boot → Secure Boot → DisabledSome on the Security page
Generic/OtherDel, F2, F1, EscSecurity or Boot → Secure Boot → DisabledThe name may be Secure Boot Enable to turn off
  1. On the first USB boot, it prompts you to enter the server IP, client IP, and other info; after connecting to the server normally, it enters the computer selection process, and you enter the main interface after selecting
  2. When selecting a computer, pay attention to the numbering order; the number is an important reference for marking the computer's location in daily management
  3. If booting fails, first confirm that is disabled

4-2-2) Use the first already-booted computer to enable DHCP relay

DHCP relay 1

DHCP relay 2

  1. On first entry, press F2 to set the LAN IP info and server IP; after confirming, it connects to the server and enters the computer binding page
  2. After binding succeeds, press F7, or click the DHCP relay menu
  3. DHCP relay automatically fills in the relevant info based on the current network environment; when no changes are needed, just click Start Relay

4-2-3) Other computers join via network boot

Other computers boot into ROM via network boot; refer to section 4-1 for the method.

6. Download the Desktop (Distribute)

Navigate to Desktop → Desktop management → Distribute Desktop → Distribute Desktop.

Distribute Desktop menu

  1. Check the computers to distribute to and click Distribute Desktop; the system automatically distinguishes computers of different network speeds for chained distribution
  2. If the data to download is larger than the locally available capacity, the download will fail directly
  3. While the download is incomplete,
  4. The same menu also includes Transfer Optimization, Distribution Settings, Cache Verification, Clear Download Tasks and other features

7. Network Boot (in step 6, once the download starts and has speed, simply reboot the computer)

Network boot

  1. Network boot caches while booting; once the download completes it automatically switches to local boot
  2. Network boot is mainly used for emergency boot (desktop not fully downloaded), insufficient disk capacity, and special security scenarios; since it cannot boot offline, please still perform the download for normal use
  3. If auto-download pops up at power-on, you can clear it under Desktop → Desktop management → Distribute Desktop → Clear Download Tasks. When network resources are limited, downloading while network-booting will be very laggy
  4. The same computer supports a "cache boot + network boot" combination; for a desktop not used long-term, you can define network boot only

Quick Deploy Complete