Beijer ELECTRONICS CloudVPN Agent Software User Guide

Beijer ELECTRONICS CloudVPN Agent Software

 

Funkcija ir naudojimo sritis

This document describes how to install and activate the CloudVPN Agent on X3 web HMIs (pro, marine, and extreme) in a Docker environment.

CloudVPN, available as both hardware and software, enables secure communication over untrusted networks. It encrypts data using AES-256.

CloudVPN works as a virtual network extension. It allows you to access remote devices as if they were directly connected to your local network.

Apie šį Greitos pradžios vadovą

This Quick Start Guide provides basic instructions for installation and activation. It does not replace the full product documentation.

Taikymo sritis

This document uses the following hardware and software:

• X3 web (pro, marine, extreme)
• CloudVPN Agent (BAPP)

Papildomi ištekliai

Daugiau informacijos rasite:

• Help Online
• Dokumentacijos portalas
• Connected Forum

Atsiliepimai

Send feedback about this document to:

support.europe@beijerelectronics.com

Autoriaus teisės © 2026 Beijer Electronics AB. Visos teisės saugomos.

Šiame dokumente pateikta informacija gali būti keičiama be įspėjimo ir pateikiama tokia, kokia yra publikavimo metu. „Beijer Electronics AB“ pasilieka teisę keisti bet kokią informaciją neatnaujindama šio leidinio. „Beijer Electronics AB“ neprisiima jokios atsakomybės už klaidas, kurios gali atsirasti šiame dokumente. Visos exampŠiame dokumente esantys failai skirti tik pagerinti programinės įrangos funkcionalumo ir naudojimo supratimą. „Beijer Electronics AB“ neprisiima jokios atsakomybės, jei šie failai neatitinka tikrovės.amples yra naudojami realiose programose.

Given the software’s wide range of applications, users must acquire sufficient knowledge to ensure it is used correctly in their specific application. Persons responsible for the application and the equipment must themselves ensure that each application is in compliance with all relevant requirements, standards, and legislation in respect to configuration and safety. Beijer Electronics AB will accept no liability for any damage incurred during the installation or use of this software. Beijer Electronics AB prohibits all modification, changes, or conversion of the software.

Introduction to CloudVPN Solutions

Beijer Electronics provides multiple CloudVPN solutions for secure remote access.

„CloudVPN“ šliuzas 

Suteikia: 

• Nuotolinė prieiga
• Duomenų registravimas
• Dashboard functionality

CloudVPN SecureEdge Pro 

Includes all features of CloudVPN Gateway, and adds:

• Docker palaikymas
• GPS/GNSS support (requires hardware with 4G/LTE)

CloudVPN Agent 

The CloudVPN Agent runs as a Docker container on the device.

• Provides remote access to the local device only
• Does not support routing to other devices

Tinklo architektūra 

A CloudVPN network can include a mix of:

• Hardware routers
• Software-based routers

The system supports one-to-one connections between sites.

CloudVPN Agent Distribution

The CloudVPN Agent is distributed as a Beijer APP (.bapp file). Select the correct version based on the device architecture:

• ARM64
  Use CloudVPN vx.xx ARM64.bapp
  (for X3 Web and other ARM64 devices)
• ARMHF
  Use CloudVPN vx.xx ARMHF.bapp
  (for GL998x Programmable I/O and other ARMHF devices)

Download the BAPP files iš Beijer Electronics Smartstore.

BAPP Support
You can install and run multiple BAPPs on the same device at the same time.

ExampTinklo sąranka

Šiuose examples in this quick start guide:

• LAN A is connected to the internet using DHCP
• LAN B uses a static IP address: 192.168.10.111

Install CloudVPN Agent on an X3 Web Įrenginys

You can install the CloudVPN Agent on X3 Pro Web, X3 Marine Web, and X3 Extreme Web devices. To transfer the installation file to the device, use a USB storage device.

1. Copy the CloudVPN BAPP file to the root directory of the USB storage device. Example file vardas:
   CloudVPN vx.xx ARM64.bapp
2. Power up the X3 web HMI panel.
3. Press and hold the top of the screen until Settings appears, then tap Settings.
4. Log in as Administrator.
5. Enter the password, then tap Login.
   Numatytasis slaptažodis: 88282282
6. Atidarykite skirtuką „Nustatymai“.
7. Scroll down and enable the following services:
   • Ping
   • SSH
   • Dokeris
8. Bakstelėkite Išsaugoti.
   PASTABA: Remember to disable Ping after commissioning is complete.
9. Open the Apps tab.
10. Insert the USB storage device into the HMI panel.
11. Tap Add apps in the upper-right corner.
12. When the CloudVPN app appears in the list of available apps, tap Install.
    PASTABA
    An Internet connection is required to complete the installation.
13. Verify that CloudVPN appears in the list of installed apps.

The CloudVPN Agent is now installed on the X3 Web HMI panel. The next step is to activate the CloudVPN Agent.

Activate the CloudVPN Agent on an X3 Web Įrenginys

After you install the CloudVPN Agent, you must activate it before use.

Prieš pradėdami:
Make sure SSH is enabled in X3 Web:
Settings > General > SSH

1. Open Command Prompt or PowerShell on your PC.
2. Connect to the device using SSH:
   ssh root@<device_ip>
   ExampLe:
   ssh root@192.168.10.111
3. Enter the root password.
   The default password is printed on the label on the back of the device. Default password: BeijerLT4C
4. List running Docker containers:
   dokeris ps
5. Locate the CloudVPN container and note the Container ID.
6. You must also locate the Company ID:
   a. Log in to the CloudVPN Cloud.
   b. Open the application menu (top-right corner).
   c. Select Admin.
   d. In the Company section, select Tapatybė.Arba: Spustelėkite profesionaląfile icon in the top-right corner and copy the displayed Company ID.
7. To register the agent, run the following command:
   docker exec <Container ID> /usr/bin/ixagent-register.sh<Cloud Company ID>
   ExampLe:
   docker exec 92cce0ffd150 /usr/bin/ixagent-register.sh 6693-0340-0000-0000-0000PASTABA
   If the message “Failed to register the Agent” appears:
   • Verify that the device has an active internet connection.
   • Make sure the agent is not already registered to another company.

The CloudVPN Agent is registered to your company.
After registration, activate the CloudVPN Agent in the CloudVPN platform.

Activate the CloudVPN Agent in the Cloud Platform

This chapter describes how to activate the CloudVPN Agent in the Cloud Platform.

1. Open the CloudVPN Cloud Platform and log in to your Beijer account.
2. Select Fleet Manager.
   If 1 new device appears, the installation on the X3 web is complete and the device has internet access.
3. Select 1 new device.
4. Select the checkbox to activate the device.
5. Enter the required device information.
6. Click Activate device.
7. Enter the CloudVPN Agent Activation Key (PN: 602-0017).
8. Spustelėkite Patvirtinti.PASTABA
   The license is valid only for the hardware where it is installed.
   If you perform a factory reset of the X3 web, the license is removed. You must then purchase a new license.
9. Spustelėkite Tęsti.
10. Configure the LAN settings:
    a. Go to Fleet Manager > Network > LAN.
    b. Enter the LAN IP address of the X3 web (pvzample, 192.168.10.200).
    c. Enter the subnet mask (for example, 255.255.255.0).
    d. Click Confirm changes.

The CloudVPN Agent is now installed and activated.

Dabar galite:

• Connect to the device remotely
• Use available CloudVPN functions

PASTABA 

CloudVPN Agent does not support routing.

You can access only the device where the agent is installed.

The next step is to start the VPN connection to access the X3 web nuotoliniu būdu.

Remote Access to X3 Web and BAPP Applications

This section describes how to access the X3 web and installed BAPP applications using CloudVPN.

Connect to X3 Web Using CloudVPN 

1. In the Cloud Platform, select the device in Fleet Manager.
2. Click Connect to establish a secure VPN connection to the CloudVPN Agent.When the connection is established, the VPN status indicates that the device is connected.
3. Locate the VPN IP address in the Cloud Platform under the device connection details.
4. Access the X3 web, with Command Prompt or Powershell, using the VPN address.
   Use the following format:
   <username>@<VPN address> ExampLe:
   root@10.187.157.62

Prisijunkite prie WebIQ Using CloudVPN 

WebIQ Runtime is a BAPP that allows you to run a WebIQ project on the X3 web.

1. Atsisiųsti WebIQ Runtime BAPP from Beijer Electronics SmartStore.
2. Copy the BAPP file į USB diską.
3. Install the BAPP on the X3 web. For installation instructions, see the X3 web Konfigūracija ir veikimas vadovas.
4. Norėdami pasiekti WebIQ application (requires that the CloudVPN Agent is connected):
   a. Atidarykite a web naršyklė.
   b. Enter the application URL using the following format:
   <IP address>:10123/<project name>
   ExampLe:
   10.187.157.62:10123/main/

Dabar galite:

• Access the X3 web nuotoliniu būdu.
• Run and access WebIQ applications over a secure VPN connection.

Additional Information and Guidelines

CloudVPN agent license

The CloudVPN Agent license is locked to the hardware for the entire lifetime of the device.

If you uninstall the CloudVPN Agent or reset the hardware:

• The license is consumed.
• You must purchase a new license to continue using the service.

Resolve SSH Fingerprint Warning

When connecting to X3 Web using SSH, a fingerprint warning may appear.

This occurs when the device fingerprint has changed or does not match the stored value.

1. Locate the SSH known hosts file (.ssh).
2. Delete the entry that corresponds to the device IP address.
3. Run the SSH command again.
   ExampLe:
   ssh root@192.168.10.111
4. When prompted, type yes and press Enter.
5. Įveskite slaptažodį ir paspauskite Enter.

Restart Docker Container 

This section describes how to restart a Docker container on the X3 device.

1. Connect to the device using SSH:
   ExampLe:
   ssh root@192.168.10.111
   Paspauskite Enter.
2. Įveskite slaptažodį.
   Default root password: BeijerLT4C
3. List running containers; enter: docker ps
4. Identify the Container ID.
5. Restart the container:
   docker container restart <CONTAINER ID>
   ExampLe:
   docker container restart d475b2721155 The system restarts the selected container.

Remove Unused Data 

1. Open the Command Prompt.
2. Connect to the device using SSH: ssh root@<IP address>
3. Run the following command: docker system prune
4. When prompted, enter y and press Enter to confirm.
   The system removes unused data and displays the reclaimed disk space.

Data removed:
The command removes the following:

• all stopped containers
• all networks not used by at least one container
• all images without at least one container associated to them
• all build cache

PASTABA 

Prune is also available in the settings menu on the X3 web.

How to Take a Screenshot 

This section describes how to take a screenshot from the X3 web using SSH.

1. Open the Command Prompt.
2. Start Powershell: Powershell
   Paspauskite Enter.
3. Connect to X3 Web using SSH:
   ssh root@<IP-address>
   Paspauskite Enter.
4. Įveskite slaptažodį ir paspauskite Enter.
5. Take a screenshot:
   kmsgrab /<folder>/<file name> ExampLe:
   kmsgrab /tmp/test1
6. Atsijungti:
   atsijungti
7. The screenshot is stored on the X3 web. Use SCP or an FTP client (for example, FileZilla) to copy the file prie kompiuterio.
   To use the Command Prompt, enter:
   scp root@<IP address>:/<folder>/<file name>.png .
   ExampLe:
   scp root@192.168.10.111:/tmp/test1.png .
   The space followed by a dot ( .) copies the file to the current folder.

The screenshot is saved to your local computer.

PASTABA 

• Screenshots are saved in PNG format only.
• The system stores screenshots in RAM.
• All screenshots are deleted when the device restarts.
• The maximum available storage for screenshots is 50 MB.
• If the screen saver is active, the screenshot is completely black.

Firmare Update of X3 web

• A firmware update preserves:
  • Docker containers
  • Nustatymai
  • Licencijos
• A factory reset deletes:
  • Docker containers
  • Nustatymai
  • Licencijos

Deleted data cannot be recovered.

Pagrindinė buveinė
Beijer Electronics AB
426 langelis
201 24 Malmė, Švedija
www.beijerelectronics.com / +46 40 358600