---
title: "FAQ"
description: "Frequently asked questions about LumiScan File Transfer - Runner and Trainer roles, installation, licensing, folder structure, network settings and file transfer."
product: "LumiScan File Transfer"
component: "lumiscan-file-transfer"
version: "1.8.4"
display_version: "1.8.4.3"
latest_version: true
language: "en"
url: "https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/faq.html"
---

# FAQ – LumiScan File Transfer

Short answers to common questions and error messages for LumiScan File Transfer. Each entry links to the page with the details.

> [!TIP]
> Search this page for the exact error message. Each entry has a fixed anchor (for example `#faq-network-settings`).

## Installation and licensing

### What do the Runner and Trainer roles do? {#faq-runner-trainer}

- **Answer:**
  - The **Runner** sends the generated and annotated images to the Trainer and receives the trained neural networks (models) back.
  - The **Trainer** receives the images from the Runner, stores them in the specified folder for training, and sends newly trained neural networks back to the Runner.
- **More:** [Description](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/description.html)

### How do I install LumiScan File Transfer? {#faq-installation}

- **Answer:**
  1. Install CodeMeter Runtime 9.00 or later and connect the LumiScan Key.
  2. Double-click `Installer_LumiScan_File_Transfer_va_b_c_d.exe` (**a** to **d** depend on the software version).
  3. Accept the licence terms with **Accept**, optionally change the location with **Browse**, then click **Next** and **Install**.
  4. When the installation is complete, click **OK** and **Finish**.
- **More:** [Installing LumiScan File Transfer on Windows](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/installing-lumiscan-file-transfer-on-windows.html), [Before Installation](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/before-installation.html#installing-the-codemeter-runtime-environment-3)

### How is LumiScan File Transfer licensed? {#faq-licence}

- **Answer:** The licence is on the LumiScan Key (Windows 11). CodeMeter Runtime 9.00 or later must be installed. One LumiScan Key is needed per device that runs the software at the same time; keys can be exchanged between devices.
- **More:** [Licence](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/before-installation.html#licence), [Licensing FAQ](https://docs.hdvisionsystems.com/en/lumiscan-licensing/1.0.4/faq.html)

### Which folders do I need to create before starting? {#faq-folder-structure}

- **Answer:** Create one folder for the Runner and one for the Trainer on the computers on which they run:
  - Runner folder: must contain the subfolders `networks` (trained networks received from the Trainer, empty at the beginning) and `training_data` (image data). These names are predefined and cannot be changed. Select this folder as **Annotated Data Directory**.
  - Trainer folder: two subfolders with names of your choice. One receives the training data from the Runner (**Training Data Directory**); the other holds the trained networks in subfolders named `yyyy-mm-dd` (**Trained Network Directory**).
- **More:** [Before Starting the Program](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/before-starting-the-program.html#folder-structure-2)

## Roles and settings

### How do I switch between Runner and Trainer? {#faq-switch-role}

- **Answer:** On first start, the program opens in the Runner role. To change the role:
  1. Open `C:\Users\<UserName>\AppData\Local\HD Vision Systems GmbH\LumiScan File Transfer\settings\settings.json`.
  2. Enter the new role as the value of `profile`: `RUNNER` or `TRAINER`, in capital letters only.
  3. Save with Ctrl+S and reopen the program.
- **More:** [Switching Roles](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/switching-roles.html), [Starting the Program for the First Time](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/starting-the-program-for-the-first-time.html)

### How do I set the ports and IP addresses? {#faq-network-settings}

- **Answer:** Open **Menu** > **Settings** and set the following values. Ask your IT department for the correct addresses and for the ports that are permitted in your firewall.
  - **Port**: the port on which this tool waits for incoming transfers. Use it as the destination port on the other side.
  - **Destination IP**: the IPv4 address of the system on which the other role (Trainer or Runner) runs.
  - **Destination Port**: the port on which the other role waits for incoming connections.
- **More:** [Runner: Settings](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/lumiscan-file-transfer-runner.html#settings-2), [Trainer: Settings](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/lumiscan-file-transfer-trainer.html#settings-3)

## Troubleshooting {#troubleshooting}

Problems and error messages are described step by step in [Troubleshooting](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/troubleshooting.html):

- [**Save** reports invalid settings](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/troubleshooting.html#faq-invalid-settings)
- [The remote display stays **Offline**](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/troubleshooting.html#faq-remote-offline)

## Transferring files

### How do I send images from the Runner to the Trainer? {#faq-send-images}

- **Answer:** The Trainer shows the incoming data and the transfer progress in its status bar and saves the data in its data directory after a successful transfer.
  1. Click **Start Runner**; the status changes to **Active**.
  2. Wait until the remote display shows **Online** (connection to the Trainer successful).
  3. Click **Send**.
- **More:** [Runner: File Transfer](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/lumiscan-file-transfer-runner.html#file-transfer)

### How do I send a trained network back to the Runner? {#faq-send-network}

- **Answer:** The Runner shows the progress on the **File Transfer** screen and stores the network in the corresponding folder of the Runner project directory.
  1. In the Trainer, click **Start Trainer**; the status changes to **Active**.
  2. Wait until **Remote** shows **Online**.
  3. Select the network in **Network** and click **Send**.
- **More:** [Trainer: File Transfer](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/lumiscan-file-transfer-trainer.html#file-transfer-2)

### Does the Runner delete images after sending them? {#faq-images-deleted}

- **Answer:** The Runner deletes images from the Runner folder only after they have been transferred successfully. Newly captured images are not deleted.
- **More:** [Runner: File Transfer](https://docs.hdvisionsystems.com/en/lumiscan-file-transfer/1.8.4/lumiscan-file-transfer-runner.html#file-transfer)

## Support

### Where can I get further help? {#faq-support}

- **Answer:** See the site-wide [LumiScan FAQ](https://docs.hdvisionsystems.com/en/faq.html). Contact customer success at [customer.success@hdvisionsystems.com](mailto:customer.success@hdvisionsystems.com) or +49 6221 6721905; for licences, contact [licenses@hdvisionsystems.com](mailto:licenses@hdvisionsystems.com).