This section describes how to configure and manage your Edge appliance remotely.
Edge can be managed, configured and monitored remotely through a Cloud of Things cloud tenant. You can control and troubleshoot your Edge deployments remotely.
To enable this, you must first register the Edge appliance as a device in a Cloud of Things cloud tenant. You can register the Edge appliance by enabling remote connectivity and providing the Cloud of Things cloud tenant account details. Once registered, you can access your Edge appliance remotely, monitor its metrics, update, reboot, and collect diagnostic data of your Edge appliance remotely. The Cloud of Things cloud tenant uses the SSH protocol to access the remote Edge appliance through a web browser.
Important
If you want to configure remote connectivity, you must configure the DNS when configuring the network.
Configuring remote connectivity using the UI
Log in to the Management tenant.
Username: management/<username>
Password: password provided during the installation
Switch to the Administration application using the application switcher at the right of the top bar .
Click Edge > Remote Connectivity in the navigator.
Switch the Enable remote connectivity toggle to enable remote-connectivity.
Provide the URL of the Cloud of Things cloud tenant in the Remote tenant URL field.
Registering the Edge appliance in the Cloud of Things tenant
Before performing these steps, ensure that you have configured the URL for the Cloud of Things cloud tenant in the Edge appliance.
Log in to your Cloud of Things tenant.
Go to the Device Management application.
Click Registration in the Devices menu and then click Register device.
Select General device registration.
In the Device ID field, enter the Edge device ID.
Click Next.
Click Complete to register your Edge appliance.
After successful registration, the Edge appliance appears in the Device registration page with the status Waiting for connection.
Turn on the Edge appliance and wait for the connection to be established.
Once the device is connected, the device status changes to Pending acceptance.
Click Accept to confirm the connection. The status of the device changes to Accepted.
Accessing the Edge appliance from the Cloud of Things tenant
The Cloud of Things Remote Control allows you to remotely access the Edge appliance through a web browser. The remote Edge appliance is represented as a device in the Device Management application of Cloud of Things.
Prerequisites
To use Remote Control, you need:
“Remote access” permission granted to the tenant user.
A Cloud of Things tenant subscribed to the Remote Control microservice. To get the subscription, contact DT IoT support.
Supported protocols
The following protocols are supported to connect to the Edge appliance through remote access from the Cloud of Things tenant:
Starting with Edge Release 10.15, the support for the Telnet protocol has been removed, as Telnet is considered to be an insecure protocol lacking built-in security measures. For accessing the Edge appliance remotely from the Cloud of Things tenant, DT IoT recommends you to use the SSH protocol instead.
For more information about remote access, see Remote Control.
Accessing the Edge appliance remotely through VNC
You can access the Edge appliance from the Cloud of Things tenant by installing the VNC components on your Edge appliance. Ensure that you have registered your Edge appliance with the Cloud of Things tenant. See Registering the Edge appliance in the Cloud of Things tenant.
Info
VNC server does not work if SELinux is set to enforcing mode.
Step 1: Installing the VNC components
Info
The Edge appliance must be connected to the internet to install the VNC components.
Run the script vnc-setup.sh.
sudo /opt/c8y/utilities/vnc-setup.sh
The vnc-setup.sh script installs the VNC components. After installing the VNC components, you should configure the VNC server for each user.
After installing the VNC components, log in as a root user and add the vnc-server service to the firewalld firewall. For example, the following commands add the vnc-server to the firewalld with the zone set to public:
These are sample commands and may vary based on your requirements.
Step 2: Configuring VNC server for a user
To configure the VNC server, run the vnc-user-setup.sh script. Each user should run this script to set up VNC components and be able to connect to the Edge appliance. The vnc-user-setup.sh script enables the current user to use VNC functionality and set a VNC password for the current user.
Run the script vnc-user-setup.sh.
/opt/c8y/utilities/vnc-user-setup.sh
Provide and verify the password.
Select Y or N to enter a view-only password.
Record the allocated port number. This port number will be used to connect to the VNC server on your Edge appliance.
Info
You can also get the allocated port number from the /opt/c8y/utilities/vnc-display-mapping file. In this file, you will find the VNC display number allocated for each user. For example, admin:1. You must add 5900 to the number associated with the user. In this example, the port number for the user admin is 5901.
Step 3: Connecting to the Edge appliance using VNC
To access and connect to the Edge appliance:
In the Cloud of Things tenant for your registered Edge appliance, add a remote access endpoint. See Adding remote access endpoints. You must use the same port number that is allocated for you.
The connection to the Edge appliance is established and the UI appears for the Edge appliance. Right-click in the screen to open the desktop components xterm and firefox.
Important
Do not use the Send Ctrl+Alt+Del button in the VNC interface. If you do so, you will lose the VNC connection and not be able to reconnect until you restart the Edge appliance.
Changing the VNC password
You can change the VNC password for the current user by running the vnc-user-setup.sh script. After changing the password, you must update the password in the remote access endpoint.
Accessing the Edge appliance remotely through SSH
You can access the Edge appliance from the Cloud of Things tenant through SSH.
In the Cloud of Things tenant for your registered Edge appliance, add a remote access endpoint. See Adding remote access endpoints. If you select the Sign-in method as Username and password, you must enter the operating system’s administrator credentials. By default, the port number should always be 22.
The Cloud of Things tenant allows you to remotely restart your Edge appliance. To do so:
Log in to your Cloud of Things tenant.
Go to the Device Management application.
Click Devices > All devices in the navigator.
Select the Edge appliance that you want to restart.
Click Restart device.
Updating Edge remotely
You can remotely update your Edge appliance using the Cloud of Things’s firmware update feature. This process requires you to upload the Edge archive file (tar.gz) to your tenant account or a server (you must provide the location of the archive on that server). For more information about the firmware feature, see Device Management > Managing device data > Managing device firmware in the User guide.
Important
The Edge archive file size is about 3GB. If your tenant account has a limitation for uploading files with size over 1GB, contact Telekom support to increase the maximum file size for upload.
Before you update your Edge appliance remotely, you must:
Click Firmware repository in the Management menu in the navigator.
Click Add firmware at the right of the top menu bar.
Provide a name for the firmware, add a description and its version (all required).
Optionally, you can define the device type filter when adding a new firmware. For example, c8y_EdgeAgent.
Select the Provide a file path option to specify an HTTPS URL of a server from where the archive file can be downloaded.
Click Add firmware. The firmware object appears in the firmware list.
Click All devices in the Devices menu in the navigator, select your Edge appliance from the device list.
Click Firmware. The Firmware tab shows the current Edge appliance version.
You can also see the current Edge appliance version in the Info tab.
Click Replace firmware.
Select the firmware that you just uploaded and click Install.
To check the status of the update, hover over the refresh icon as shown in the figure below:
To check the details of the update, click the text outlined in red in the figure below:
Restart your Edge appliance after the firmware update is complete. You can remotely restart your Edge appliance from your tenant account as shown in the figure below:
Updating Edge appliances using bulk operations
In your tenant account, you can update multiple Edge appliances using the bulk operations feature. To do so, follow the steps below:
Log in to your Cloud of Things tenant account.
Go to the Device Management application.
Click Device control in the Overviews menu in the navigator.
Click Bulk operations and then click New bulk operation.
Click Firmware update.
Select a firmware from the list. The list can be filtered by firmware name. Click Next.
Expand the version and select the archive file. Click Next.
Select the Edge appliances that you want to update by applying filters to the paginated list of all devices.
You can filter by status, name, type, model, group, registration date and alarms. You may apply multiple filters. To apply a filter, click the column header, make your filter option choices in the context menu and click Apply.
Enter a new title or use the preset title. Optionally enter a description. Select a start date and a delay. The delay may either be in seconds or milliseconds and is the time spent between each single operation of the bulk operation. Click Schedule bulk operation to create the bulk operation.
The Cloud of Things tenant allows you to download the diagnostics report remotely from your tenant account after you have registered your Edge appliance in the tenant account.
To download the diagnostics report from your tenant account:
Log in to your Cloud of Things tenant.
Go to the Device Management application.
Click Devices > All devices in the navigator.
Select the Edge appliance for which you want to download the diagnostics report.
Click Diagnostics > Request diagnostic file.
Click the ZIP file link to download the diagnostic report.
Data exchange using data broker
Data broker lets you upload the data to a Cloud of Things tenant account selectively. Note that you must first create a Cloud of Things tenant account.
Important
Data broker and Edge connectivity are compatible only with the current version and previous two releases of Cloud of Things.
Cloud of Things has a release every three months.
You can share the following data with the tenant account:
Devices (and more generically, managed objects)
Events
Alarms
Measurements
Important
Data broker in Edge does not support synchronization of the operations.
To upload the data to a Cloud of Things tenant account, you must first create a data connector in the Edge appliance and subscribe this connector in the tenant account.
Note down the security code. This security code will be used to subscribe the connector in the tenant account.
Log in to the Cloud of Things tenant account.
In the tenant account, go to the Administration application. Click Data broker > Data subscriptions to subscribe the connector created in your Edge appliance.
You can now navigate to the Device Management application or the Cockpit application. You will find a new “virtual group” with a specific icon showing the forwarded devices. The group will have the same name as your subscription.
.
