Installing an Edge Node on Windows

Important

At present, this feature is only available in preview, if the DataAPI soft-launch option is enabled. For more information, see Soft-launch options.

Before you continue, make sure the general prerequisites are met.

Prerequisites

The Windows machine must meet the following requirements:

• An x86-64 architecture

• .NET

• ASP.NET

• Microsoft Visual C++ 2015 Redistributable, also known as VC++ 14.0

Installing the Edge Node

1. Obtain the Windows MSI installer for the Edge Node.

2. Run the installer as an administrator.

3. Follow the setup wizard:

   • Select how the Edge Node should connect to the DataMiner System.

   • Enter the DataMiner System key or pre-shared key, depending on the selected connection mode.

After the installation has completed, the DataMiner EdgeNode service starts automatically.

Changing the configuration (optional)

If necessary, you can change the Edge Node configuration after installation.

The configuration is stored in the following file: C:\Program Files\Skyline Communications\DataMiner EdgeNode\edgenode.json.

The file contains the following connection configuration:

{
  "EdgeNode": {
    "Key": "<key>",
    "Url": "wss://relay.dataminer.services"
  }
}

Configure the properties as follows:

• Key: The DataMiner System key or pre-shared key used to register the Edge Node. See Prerequisites.

• Url: The WebSocket endpoint through which the Edge Node connects to the DataMiner System. The URL must use the wss:// scheme, for example: wss://dataminer-agent1.example.local.

  • For a connection through dataminer.services, leave Url set to wss://relay.dataminer.services.

  • For a direct connection, replace the value of Url with the fully qualified domain name of the DataMiner Agent.

Starting the Edge Node service

If you have configured the Edge Node through the installation wizard, the DataMiner EdgeNode service will start automatically.

If you have manually changed the configuration, restart the service for the changes to take effect:

1. Open PowerShell as an administrator.

2. If the service is not running, start it: Start-Service -Name "DataMiner EdgeNode".

3. If the service is already running, restart it: Restart-Service -Name "DataMiner EdgeNode".

4. Verify that the service is running: Get-Service -Name "DataMiner EdgeNode".

   The status of the service should be Running.

Note

You can also manage the service through the Windows Services application.