Cluster Intranet Deployment Guide (Windows)

This guide covers deploying LarkXR in a **Windows cluster** configuration on an intranet. A minimum of two servers is required: one **master node** (management server) and one **GPU rendering node**.

## Prerequisites

1. **Environment Preparation** - Set up at least two servers, with at least one being a GPU server. Refer to [Environment Preparation](https://docs.paraverse.cc/doc/215/) for setup details.
   > If the master node will also serve as a rendering node, follow the [Stand-Alone Version deployment guide](https://docs.paraverse.cc/doc/245/) from Step 4 onward for rendering node configuration.
2. **Download Package** - Based on [System Components](https://docs.paraverse.cc/doc/239/), download and extract the program package to a drive root directory. The path must not contain Chinese characters.
3. **Port Availability** - Ensure all required ports are free on both servers. Modify any conflicting ports before proceeding.

## Required Ports

### Master Node

| Protocol | Port | Purpose |
|---|---|---|
| TCP | 8181 | Frontend page (nginx) and backend interface |
| TCP | 8182 | Backend page nginx forwarding |
| TCP | 8184 | Management service |
| TCP | 3306 | MySQL database |
| TCP | 6379 | Redis cache |

### Rendering Node

| Protocol | Port | Purpose |
|---|---|---|
| TCP | 8089 | Sync and proxy service |
| TCP | 10002 | WebSocket communication |
| TCP | 10003 | Internal rendering server communication |
| TCP | 10004 | Rendering server SSL |
| UDP | 10011-10040 | Audio and video communication |

## Deployment Steps

### Master Node Setup

1. **Launch the manager** - On the master node, navigate to the extracted `larkxr-center-windows` folder and double-click `LarkXRLauncher.exe`.
2. **Configure the management node** - Open **Configure Management Node**. Enter the local IPv4 address of the master server. Enable **Start on Boot** if desired. Keep other settings at their defaults.
3. **Save and start services** - Click Save, then start the service. Dismiss any pop-up dialogs that appear during startup by clicking **Cancel**.
4. **Verify the management node** - Open a browser and go to `http://<master-IP>:8182`. Log in with the default credentials:
   - **Username:** `admin`
   - **Password:** `123456`

### Rendering Node Setup

5. **Launch the manager** - On the GPU rendering node, navigate to the extracted `larkxr-render-windows` folder and double-click `LarkXRLauncher.exe`.
6. **Configure the rendering node** - Open **Configure Rendering Node**. Set:
   - **Admin Server URL** to `http://<master-IP>:8181`
   - **Local IP** to the rendering server's local IPv4 address
7. **Save and start services** - Click Save, then start the AgentServer and RenderServer services.

### Verification

8. **Confirm registration** - Log in to the backend at `http://<master-IP>:8182` and check the resource monitoring panel. A successfully connected GPU node should appear with a count of 1.