Install the IoT Intelligence add-in in LCS

This article explains how to install the IoT Intelligence add-in in Microsoft Dynamics Lifecycle Services (LCS). Note that add-ins cannot be installed on a demo/trial environment. Before you can install the add-in, you must create the Azure resources.

You can set up and configure IoT Intelligence without writing any code. Here are the basic steps.

  1. Set up Azure resources – Create an IoT hub, a Redis cache, and a key vault that can be accessed from Supply Chain Management.
  2. Message schema formats for IoT Hub – Configure your devices to send messages to IoT Hub, and define the JavaScript Object Notation (JSON) message format.
  3. In Feature Management, enable the IoT Intelligence feature flag.
  4. Install the IoT Intelligence add-in in Microsoft Dynamics Lifecycle Services (LCS) – Install the add-in in LCS, and configure the Azure secrets (as described in this article).
  5. Set up metrics – Set up metrics in Supply Chain Management.
  6. Scenario setup – Set up the scenarios in Supply Chain Management.

Set up the LCS environment

  1. Open LCS, and go to your Microsoft Dynamics 365 Supply Chain Management environment.

  2. Scroll to the Environment add-ins section.

  3. Select Install a new add-in to show the list of add-ins that have been enabled for the environment.

  4. In the Select an add-in to install dialog box, select IoT Intelligence.

  5. In the Setup add-in dialog box, provide the details of your IoT hub and Redis cache. You can find the required values in the key vault that you created in Create Azure resources.

    • Tenant ID – In the Azure portal, go to the key vault, and then, in the left navigation pane, select Overview, and copy the Directory ID value. Paste that value in the Setup add-in dialog box.
    • IoT Event Hub-compatible endpoint Key Vault URI – Go to the key vault, and then, in the left navigation pane, select Overview, and copy the DNS name value. Paste that value in the Setup add-in dialog box.
    • IoT Event Hub-compatible endpoint secret name – Go to the key vault, and then, in the left navigation pane, select Secrets, and copy the name of the secret where the event hub connection string for the IoT hub is stored. Paste that value in the Setup add-in dialog box.
    • Redis cache key vault URI – Go to the key vault, and then, in the left navigation pane, select Overview, and copy the DNS name value. Paste that value in the Setup add-in dialog box.
    • Redis cache endpoint secret name – Go to the key vault, and then, in the left navigation pane, select Secrets, and copy the name of the secret where the connection string for the Redis cache is stored. Paste that value in the Setup add-in dialog box.
  6. Select the check box to accept the terms and conditions.

  7. Select Install.

  8. A message box appears that states, "Add-in has been successfully triggered for installation." Select OK.

LCS setup is now completed. The next step is to set up the scenarios.

Uninstall the add-in

  1. In Supply Chain Management, disable the scenarios.
  2. In LCS, go to your Supply Chain Management environment details.
  3. Scroll to the Environment add-ins section.
  4. Select Uninstall for the IoT Intelligence add-in.