OMS Linux Agent Installation Errors on Ubuntu 16.04.2

Chiyo OdikaLinux, Microsoft Operations Management Suite, OMSLeave a Comment

I recently was working on some OMS Linux agent testing and sought to test with the 16.04.2 flavor of Ubuntu for the first time. Upon downloading the relevant bundle for my computer as described in my previous article, an attempt to upgrade (–upgrade) the package in the system failed with the dreaded “Errors were encountered while processing” errors, and I saw this across the board on all of the Ubuntu 16.04.2 computers.


Looks like a missing dependency is the culprit. So here’s what I did to address this and onboard this Ubuntu distro to my OMS workspace:

I uninstalled the package and removed all related data, using the –purge bundle operation:

sudo sh ./ --purge

and then proceeded to address the dependency. You can determine if any packages have unmet dependencies using:

sudo apt-get check

Address dependencies using apt-get -f install, and after confirming, answer yes to any prompts:

sudo apt-get install -f

And retrying the agent package installation now successfully configures the OMS Agent configuration


and you can now onboard to your OMS workspace.

Navigate to /opt/microsoft/omsagent/bin to see relevant packages

cd /opt/microsoft/omsagent/bin

You can now onboard using:

sudo ./ -w <WorkspaceID> -s <Shared Key>

Where WorkspaceID Is the ID for your OMS workspace, and the SharedKey is the relevant key for your OMS workspace.


And you should now see the agent in your workspace, using a OMS Query such as:

Type=Heartbeat OSType=Linux OSName=Ubuntu


…And proceed to do what you do best with OMS. Cheers!

The following two tabs change content below.
Chiyo's expertise spans multiple platforms. He holds Microsoft Private Cloud, and Server Infrastructure certifications, and avidly enjoys working on deployments of Microsoft's Server and Cloud Platforms, including Microsoft Systems Center, Windows Server, and Microsoft Azure.
Chiyo OdikaOMS Linux Agent Installation Errors on Ubuntu 16.04.2