Azure Linux — Hybrid runbook Worker group package is not present

In this post, would like to share that I had recently encountered an error as the Hybrid runbook Worker group package is not present while integrating the Azure update management solution for the Linux (SUSE) Edition, and followed that error the procedure was taken to resolve the issue.

Incident details:

After configuring the automation account with the Update management solution, followed by having been enabled the Hybrid Runbook worker group provisioning for a SUSE (15.3 Sp3) Linux workload ended with the below error.

Before proceeding with necessary fixes, firstly we would need to understand the importance of a Hybrid runbook Worker and the Prerequisite to complete the integration with Azure Update management.

What is a Hybrid Runbook Worker group? Hybrid Runbook Worker is a feature of Azure Automation to run runbooks directly on the Azure or non-Azure machine, including servers registered with Azure Arc-enabled servers.

The Linux Hybrid Runbook Worker executes runbooks as a special user that can be elevated for running commands that need elevation. Azure Automation stores and manages runbooks and then delivers them to one or more chosen machines.


A Log Analytics workspace — The Hybrid Runbook Worker role depends on an Azure Monitor Log Analytics workspace to install and configure the role. You can create a Log Analytics Workspace using the following link

Supported Linux operating systems

All operating systems are assumed to be x64. x86 isn’t supported for any operating system.

1. Amazon Linux 2012.09 to 2015.09

2. CentOS Linux 5, 6, 7, and 8

3. Oracle Linux 6, 7, and 8

4. Red Hat Enterprise Linux Server 5, 6, 7, and 8

5. Debian GNU/Linux 6, 7, and 8

6. Ubuntu 12.04 LTS, 14.04 LTS, 16.04 LTS, 18.04, and 20.04 LTS

7. SUSE Linux Enterprise Server 12, 15, and 15.1 (SUSE didn’t release versions numbered 13 or 14)

How to install Linux Hybrid Runbook Worker group

We have two methods to deploy the Hybrid Runbook worker group on Linux workloads as follows,

Deploy agent-based Linux Worker

Deploy Extension based Linux worker

Deploy agent-based Linux Worker

In this method, you can deploy the agent via Runbook gallery or manual method by using PowerShell

Importing a runbook from the Runbook Gallery

The import procedure is described in detail in Import runbooks from GitHub with the Azure portal. The name of the runbook to import is Create Automation Linux HybridWorker.

The runbook uses the following parameters.

Manually run PowerShell commands

To install and configure a Linux Hybrid Runbook Worker, perform the following steps.

Enable the Azure Automation solution in your Log Analytics workspace by running the following command in an elevated PowerShell command prompt or in Cloud Shell in the Azure portal:


Set-AzOperationalInsightsIntelligencePack -ResourceGroupName <RG-Hybrid> -WorkspaceName <LogSpace> -IntelligencePackName “AzureAutomation” -Enabled $true

Deploy the Log Analytics agent to the target machine.

For Azure VMs, install the Log Analytics agent for Linux using the virtual machine extension for Linux. The extension installs the Log Analytics agent on Azure virtual machines and enrolls virtual machines into an existing Log Analytics workspace..

For non-Azure machines, you can install the Log Analytics agent using Azure Arc-enabled servers. Azure Arc-enabled servers support deploying the Log Analytics agent using the following methods:

Using the VM extensions framework.

This feature in Azure Arc-enabled servers allows you to deploy the Log Analytics agent VM extension to a non-Azure Windows and/or Linux server. VM extensions can be managed using the following methods on your hybrid machines or servers managed by Azure Arc-enabled servers:

Using Azure Policy.

Using this approach, you use the Azure Policy Deploy Log Analytics agent to Linux or Windows Azure Arc machine's built-in policy definition to audit if the Arc-enabled server has the Log Analytics agent installed. If the agent isn’t installed, it automatically deploys it using a remediation task. If you plan to monitor the machines with Azure Monitor for VMs, instead use the Enable Azure Monitor for VMs initiative to install and configure the Log Analytics agent.

Happy reading !!!



Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store