# D5 Lab Version (LAB) Installation Guide

This section is for administrators who deploy D5 Lab to one or more computers. It covers the lab address security scope, package download, and both manual and batch installation.

## 1. Where to find this feature

::: tip
Sign in to My Space with a **Lab administrator account**. In the left sidebar, go to **Lab Management → Deployment** to configure and deploy D5 Lab.
:::

::: tip
**Deployment order:** Configure the lab address, download the D5 Lab install package, then choose an installation method.
:::

### Before you begin

- Confirm the country and city locations where the target computers will use D5 Lab.
- Choose the final D5 Lab installation path. The default is `C:\Program Files\D5`.
- Choose the required plugins. SketchUp, Rhino, and Revit users should use the more powerful D5 Lite; other supported applications can use DCC LiveSync.
- For batch installation, prepare SCCM or another deployment tool and make sure installation commands can run with administrator privileges.

### Deployment workflow

The deployment page presents the workflow in this order: configure the lab address, download the package, then choose an installation method.

![image](https://docs.d5render.com/~gitbook/image?url=https%3A%2F%2F3611830798-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MjbN1iGmN_HBnj_fyU9%252Fuploads%252Fil2R78r12KWFr8DBfIEH%252Fimage.png%3Falt%3Dmedia%26token%3Daee1ffbb-1856-4351-94a2-b56295f8651d&width=768&dpr=3&quality=100&sign=f4555747&sv=2)

Figure 1: Lab deployment workflow, starting with lab address

#### Step 1: Configure lab address

1. Go to **Lab Management → Deployment**.
2. In “Step 1: Configure lab address,” click **Address Config**.
3. Add the allowed lab locations by country and city, then save.
4. Return to the deployment page and confirm that the configured locations are listed.

::: warning
Add at least one valid lab address before installation. After setup, devices are checked against the configured country and city locations.
:::

#### Step 2: Download the D5 Lab install package

1. Click **Download D5 Lab package**.
2. Wait for the download to finish and keep the package in a convenient location.

The package is used by both manual and batch installation and contains the D5 Lab client installation files.

#### Step 3: Choose an installation method

| Method | Best for | How it works |
| --- | --- | --- |
| Manual install on each computer | A small number of computers or per-device configuration | Generate `install_lab.bat` for the selected settings and run it on each computer |
| Batch install with lab tooling | Many computers managed through SCCM or similar tooling | Distribute either the generated command line or `config.ini` |

### Option 1: Manual install on each computer

Manual installation shows the install path, DCC LiveSync choices, D5 Lite choices, and the `install_lab.bat` download action.

![image](https://docs.d5render.com/~gitbook/image?url=https%3A%2F%2F3611830798-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MjbN1iGmN_HBnj_fyU9%252Fuploads%252FaR3qDwWd2u68GjO9Yzq0%252Fimage.png%3Falt%3Dmedia%26token%3D54456be2-ec23-409b-b0ed-3bd8cba153a3&width=768&dpr=3&quality=100&sign=a4a3f7c5&sv=2)

Figure 2: Manual installation settings and `install_lab.bat` download

1. Set the **Install path**. This is the final D5 Lab destination, not the package download folder. You can keep the default.
2. Select DCC LiveSync plugins if needed. Available options are 3ds Max, Archicad, Blender, Vectorworks, and Cinema 4D.
3. For SketchUp, Rhino, or Revit, select the more powerful **D5 Lite** plugin instead.
4. Click **Download install_lab.bat**.
5. Extract the `deploy-xxxxxx.zip` downloaded in Step 2.
6. Place `install_lab.bat` inside the extracted folder.
7. Run `install_lab.bat` and wait for installation to finish.

::: tip
If you change the install path or plugin selections, download a new `install_lab.bat` and use the latest script.
:::

### Option 2: Batch install with lab tooling

Batch installation uses the left side of the page for configuration and generates a command line or `config.ini` on the right.

![image](https://docs.d5render.com/~gitbook/image?url=https%3A%2F%2F3611830798-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MjbN1iGmN_HBnj_fyU9%252Fuploads%252FKGst6FQpCukyrzxXTpN9%252Fimage.png%3Falt%3Dmedia%26token%3Dd0c3531c-dc7d-4ca8-b12a-e2da6db5bde9&width=768&dpr=3&quality=100&sign=e857b418&sv=2)

Figure 3: Batch installation settings

#### Configure batch installation

- **Install path:** The D5 Lab installation root on target computers. D5 Launcher and D5 Renderer are required.
- **Log path:** The default is `C:\Logs`.
- **Workspace path:** The default is `C:\D5Workspace`.
- **DCC LiveSync / D5 Lite:** Use D5 Lite for SketchUp, Rhino, and Revit. Other supported applications can use DCC LiveSync. Both groups are optional.
- **Install for current user only:** When enabled, installation applies only to the current Windows user. Shared lab computers normally keep this off.

#### Run the batch installation

Choose either of the following methods and distribute it with SCCM or another deployment tool.

**Command-line method**

1. Click **Copy command**.
2. Make sure D5DeployTool and the required installation files are in the same folder.
3. Run the copied command as administrator from that folder.

**config.ini method**

1. Click **Download config.ini**.
2. Place `config.ini` in the same folder as D5DeployTool, Launcher, Renderer, and the selected plugin installers.
3. Run `DeployTool.exe --config` as administrator from that folder.

::: warning
Generated commands, `install_lab.bat`, and `config.ini` are for controlled lab deployment. Store them securely and do not share them with unrelated users.
:::

### Post-installation checklist

- D5 Launcher and D5 Renderer are installed.
- The selected DCC LiveSync or D5 Lite plugins are installed.
- Install, log, and workspace paths match the intended configuration.
- The target computer is located in one of the configured lab address locations.
- D5 starts successfully and completes a basic run check.

### Cesium Integration (Optional)

D5 Render integrates with Cesium services to support geographic data visualization. Before using Cesium features in D5 Render, the LAB administrator needs to prepare a Cesium account and configure a Cesium Access Token.

::: tip
The following instructions are for LAB administrators to configure Cesium access for all LAB seats.

Students or individual users who want to set up Cesium on their own devices can refer to [How to use Cesium](/user-guide/tool/how-to-use-cesium).
:::

#### Obtain Cesium Authorization

1. **Register an account:** Visit the [Cesium official website](https://cesium.com/) and create an account.
2. **Manage assets:** After logging in, the Cesium ion platform opens automatically. Go to the `My Assets` page, where all geographic data assets associated with your account are displayed.
   1. You can upload your own mapping data.
   2. You can also add the official free global base data from the `Asset Depot`.

![image](https://docs.d5render.com/~gitbook/image?url=https%3A%2F%2F3611830798-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MjbN1iGmN_HBnj_fyU9%252Fuploads%252FjU1J6OHvo1xeG2l4zNl3%252Fimage.png%3Falt%3Dmedia%26token%3Dccbeca8e-8ab7-40c5-9841-c0773e3e3a74&width=768&dpr=3&quality=100&sign=e2119d40&sv=2)

3. **Create a Token**
   1. Enter the `Access Tokens` page.
   2. Click `Create token` to create a new token (you cannot use the `Default` token, because it does not have sufficient permissions).
   3. Enable all the data permissions in Public scopes and the asset permissions that need to be opened.
   4. Click `Create` and copy the newly generated token string.

![image](https://docs.d5render.com/~gitbook/image?url=https%3A%2F%2F3611830798-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MjbN1iGmN_HBnj_fyU9%252Fuploads%252F7201wSE9df0Vj5bIu4W2%252Fimage.png%3Falt%3Dmedia%26token%3D53c21a8c-ca12-4e6a-830d-a99e5911e5fb&width=768&dpr=3&quality=100&sign=9208219e&sv=2)

#### Configure Cesium Token in D5 Render LAB

For LAB users, the Cesium Access Token should be configured by the LAB administrator through the D5 management interface.

1. Open [D5 My Space](https://myspace.d5render.com/login) and log in to your D5 Lab admin account, navigate to `Organization - Other Features`, and locate the Cesium settings section.

![image](https://docs.d5render.com/~gitbook/image?url=https%3A%2F%2F3611830798-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-MjbN1iGmN_HBnj_fyU9%252Fuploads%252F0t3cTGjdc0ar5BYQ0Rwm%252Fimage.png%3Falt%3Dmedia%26token%3De832cd1e-45f2-4ba5-85e9-86a7a5303bc7&width=768&dpr=3&quality=100&sign=47baece3&sv=2)

2. Click the `Add` button.
3. In the pop-up window, paste the token you copied in the previous step, then save it. After completing the configuration, LAB users can access and start using the Cesium feature.

### FAQ

**Why can’t I download the package or choose an installation method?**

Complete Step 1 first and add at least one valid lab address.

**What does “lab address” mean in the English deployment flow?**

It is the allowed geographic country and city location for Lab use, not an IP range.

**Is the install path the same as the package download folder?**

No. The install path is the final location where D5 Lab will be installed on the target computer.

**Where should I place install_lab.bat?**

Extract `deploy-xxxxxx.zip` first, then place `install_lab.bat` inside the extracted folder and run it there.

**Do I need both the command line and config.ini for batch installation?**

No. Choose either method.

**Are there any usage limitations for the Cesium Access Token?**

D5 provides the integration channel to access Cesium services within D5 Render. The usage limits, data availability, and licensing terms are determined by your Cesium ion account plan. Please check Cesium’s official pricing and licensing information to ensure your account meets your institution’s usage requirements.
