Adding a Device to Predix Edge Manager

When you add a device to Edge Manager, information that is specific to the device is added so that when you enroll the device with Predix Edge or Predix Edge Agent, the device can be verified through the security certificate.

Before you begin

Before a device that has Predix Edge or Predix Edge Agent installed can be enrolled and brought online, you must add the device to Edge Manager. This procedure is for adding a single device to Edge Manager. To add multiple devices, see Importing a Device List.

Procedure

  1. Sign into Edge Manager.
  2. In the left navigation pane, select Device Manager > Devices.
  3. In the Device Manager page, select Action > Add.
  4. In the Add a Device dialog box, enter the information for the device:
    • Device Name – the name of the device should be unique and descriptive, and can consist of upper and lower case characters and numbers.
    • Device ID – used to identify the device with Predix Edge. The device ID must be unique in a Edge Manager tenant. While the Device ID is typically a serial number, another option is using the MAC address of the WAN interface, which is auto-populated on the Predix Cloud Enrollment page in the local technician console.
      Note: The Device ID can consist of lower-case characters and numbers, however, any upper-case characters entered during device creation will be converted to lower-case.
      Note: The device ID must follow these conventions:
      • Must be a minimum of 3 characters.
      • Must not exceed 63 characters.
      • Must start with an alphanumeric character (0-9 or a-z).
      • The remaining characters can be any combination of alphanumeric, underscore (_), or hyphen (-).
      • Do not use colons (:).
      • The Device ID is case-insensitive, but is always stored as lower-case. If you enter upper-case characters in Edge Manager, they are converted to lower-case.
      Note: Write down or copy your Device ID for use when enrolling the device with Predix Edge later.
    • (Optional) Group – Select the target group for the device.
    • (Optional) Technician – Select a technician to whom to assign the device.
    • Device Model – Select the device model from the drop-down list.
    • (Optional) Manufacturer Installed BOM – A manufacturer BOM lists packages installed before the device is shipped to the user (the packages are not installed through Edge Manager).
      1. Click Choose BOM.
      2. Select a BOM from the list, and click Confirm.
        Note: Once a manufacturer BOM is installed, it cannot be modified. Any BOMs deployed at a future date are compared against the initial manufacturer installed BOM, and any packages that are already installed as part of the initial manufacturer BOM are skipped.
    • (Optional) Description – Add a description for the device.
    • Shared Secret – Enter the Shared Secret. The shared secret provides an initial form of authentication for a device that otherwise does not have an existing identity when you enroll it with Predix Edge. Certificate-based device authentication and enrollment allows a device to enroll itself to Edge Manager at startup and obtain a certificate signed by a root authority.
    • Confirm Secret – Re-enter the shared secret.
    • (Optional) Click Next to assign a service to the device.
    • Click Finish to add the device.
  5. If you clicked Next in the previous step, in the Assign Service dialog box, select the service, or services, to assign to the device.
    • (Optional) Click Next to add location details for the device.
    • Click Finish to add the device.
  6. (Optional) If you clicked Next in the previous step, in the Location dialog box, enter location details for the device.
    Note: The Elevation value must be in meters.
    • Click Next to add custom attributes for the device.
    • Click Finish to add the device.
  7. (Optional) If you clicked Next in the previous step, in the Custom Attributes dialog box, enter custom attributes as key/value pairs, then click Finish.
    Key/value custom attributes can be used to add more details about a device, for example, Region:West.
    Click + to add more attributes, and X to delete attributes.
  8. Click Finish.
    You receive a confirmation that the device has been successfully added. The device list automatically refreshes and displays the device you added. This may take a moment.

What to do next

Once you have added the devices to Edge Manager and assigned the technician, the technician can enroll them with Predix Edge or Predix Edge Agent. The technician needs to know the following information in order to enroll the devices:

  • Device ID
  • Certificate enrollment URL (found on the Settings page)
  • Shared secret