Device Update for IoT Hub device failing when using script handler.

Sriyuta Srivastava

Are you seeing this error for the first time?

Can you check the logs of the device that failed to deploy the update? The logs may provide more information about the specific error that occurred.

Check the script handler that you are using to deploy the update. If possible could you add more details about the script which you are trying?

Im facing similar issue while trying to deploy an update which uses script handler. I get a description which says - Cannot parse the script result file '/var/lib/adu/downloads/d270d434-629d-4b08-b553-73f79c763380/action--action-download_aduc_result.json' along with Extended result code: 810549765.
SSH-ed into the IoT edge device and there was no such result file found in the path '/var/lib/adu/downloads/d270d434-629d-4b08-b553-73f79c763380/action--action-download_aduc_result.json'.

Given below are the contents of updatescript.sh file and systemupdate.importmanifest.json file.

updatescript.sh file

#!/bin/bash

# Update all system packages to the latest

sudo apt update -y 
sudo apt upgrade -y

systemupdate.importmanifest.json

{
  "compatibility": [
    {
      "manufacturer": "beelink",
      "model": "edgeappliance"
    }
  ],
  "createdDateTime": "2023-08-07T11:24:23Z",
  "description": "ubuntu update",
  "files": [
    {
      "filename": "updatescript.sh",
      "hashes": {
        "sha256": "petQB+fmawhdUvXM+rEnxR86syv0KoAVHz47ic7o220="
      },
      "sizeInBytes": 97
    }
  ],
  "instructions": {
    "steps": [
      {
        "handler": "microsoft/script:1",
		"files": [
          "updatescript.sh"
        ],
		"handlerProperties": {
			"scriptFileName": "updatescript.sh",
        },
        "type": "inline"
      }
    ]
  },
  "manifestVersion": "5.0",
  "updateId": {
    "name": "systemupdate",
    "provider": "Stratus",
    "version": "3.0"
  }
}

@Hari Prashanth Took me sometime to get here but there are some points that you might seem helpful.

1. Your update script is wrong. IoT hub expects the script in a specific manner(Some functions and flags should be there by default you can add yours on top of it). Refer to example script to generate your script.
2. To understand the execution of the script on the device side please refer to the readme.MD . Not very descriptive but still give you basic idea of how the script is executed on the device side.
3. Now coming on to the actual issue that you are facing, that error code 810549765 which means ADUC_ERC_SCRIPT_HANDLER_INSTALL_FAILURE_PARSE_RESULT_FILE. You can find the extended results codes here .
4. The script gets called at different stages with different flags. The following are the flags that get called, in chronological order
   1. --action-is-installed
   2. --action-download
   3. --action-install
   4. --action-apply
   5. --action-cancel, if needed
   6. All of these flags are not passed at the same time. The script run again and again with different flags. At each stage a result file is generated, which decides the execution of the next step.
   7. In your scenario, it is not able to find the download result file, action--action-download_aduc_result.json. Hence the error.
   8. My advice is just fix your update script as per the example script and this particular error should be gone.
   9. Last but not the least, try referring to the repo than the official documentation. It is easier to understand what is happening when you're looking at the actual code.

Hi Ashok, I was able to get the exact reason for the extended result code. Had to update the script as per the

example script .

All the steps seem to working except for the actual installation. Here is a snippet of my InstallUpdate() function (gets executed on passing the --action-install flag).

As you can see I am trying to run a dpkg -i for some deb packages.

On running the script locally with the following flags the below mentioned output is seen

In short, the update takes place and upgrades the package from 0.0.5 -> 0.0.6.

But while trying to run the same via Azure IoT Hub device updates the following logs are seen for script handler.

As seen clearly, no logs are generated. What could be the possible reason for this?

Hi @Sriyuta Srivastava Apologies for the delay in getting back to you. I would like to check and confirm if this is still an ongoing issue. I request you to create a support ticket for further investigation and immediate assistance on this. Please let us know if you do not have a support plan. Thank you.