Configure a module

To configure modules for a device:

1. From the Device List, locate and select the device you wish to configure.

   The device details display in the Device Information panel.

2. Select the Modules tab.

   A list of available modules displays. The modules available depend on the platform type configured for the device.

3. Drag a module tile from the list into the left column to associate the module with the device. You can also select the add icon on the module's tile.

   Note: You can associate multiple modules with a device, but each individual module can only be associated with a device once. For example, you can configure a device with four different modules, but any specific module can only be configured once per device.

4. Specific configuration details differ by module. Refer to Linux x64 modules, Linux (ARM) Modules, or Linux ARM64 modules for more information.

5. If a device is created from a template, some module settings are controlled by the template.

   • Values that are derived from the template and cannot be changed are indicated by .

   • Values indicated by are linked to the template, so their values are initially derived from the template. To change one of these values, select , changing it to to indicate it is unlinked from the template. You can now edit the value.

   • To re-link a value to the template, select , changing it to . The value returns to the template's value.

Secure secrets

AVEVA™ Edge Management provides module developers with the ability to securely store sensitive information, such as user names and passwords. If the module you are configuring uses this feature, the module's settings page contains a Secret Store section.

To configure secure secrets for a module:

6. From the module's settings page, locate the Secret Store section and select Setup.

   The Setup module secret dialog displays.

   

   Note: This example is only a sample. The specific fields that are displayed vary by module.

7. Enter values for each of the fields in the Setup module secret dialog. By default, the text you enter is hidden, indicated by .

   To toggle visibility and see the text you entered, select , changing it to . The text you enter in the field is now visible.

   

8. When you are finished, select Create.

   A module command script is generated containing the secret information.

   

9. Copy this command, then run it on your edge device in a Linux terminal, or as an administrator in Windows Powershell, depending on your device's operating system.

   If this is a new device, you can now pair your edge device with the device twin and deploy the device twin. See Pair a device twin with an edge device for more information.

   If this is an existing device and you are updating the secret information, you must publish your device changes. See Deploy a device twin for more information.

   Important: Every time you generate a new module command script to update secret information, you must run the script on your device, and also publish the device changes. Failure to perform both of these steps prevents the device from functioning correctly.