What is the Freshservice Discovery Agent?

Overview

The Freshservice Discovery Agent can be installed on all your Windows, Mac and Linux machines. The discovery agent then collects the machine’s hardware and software information and updates Freshservice regularly without needing further intervention from the respective user(s). Besides making the discovery of your assets extremely easy, it helps you keep track of your assets better in the long run.

The Discovery Agents use two update logics to send information to Freshservice:

Dynamic Discovery: Every time the Agent detects a change in its host machine, including changes to Hardware or Install/Uninstall of Softwares, it will update the data to Freshservice. This makes sure that the database stays the best possible representation of your assets at all times
Periodic Discovery: The Discovery Agent updates Freshservice on a weekly basis to maintain an up to date record of all your assets. This is done regardless of whether changes were made to the asset or not.

Downloading the Discovery Agent

The Discovery Agent for Windows, Mac and Linux operating systems can be downloaded directly from your Freshservice Portal.

Navigate to Admin -> Discovery
In the Agent tab, choose the required Operating system
Click on Download Agent

Installing Discovery Agent

There are multiple ways in which the Discovery Agent can be deployed for each operating system.

Windows

Install on a single machine
To install on all machines in a domain, use Group Policy Object
To install on all machines in a workgroup, use the PsExec tool

Mac

To install on a single/multiple machines follow this solution article

Linux

To install it on a Linux machine run the script using the command: >sudo python FS-Linux-Agent.py

Supported Operating Systems

Windows

Mac

Linux

Windows 10
Windows 8
Windows 8.1
Windows 7
Windows 2008
Windows 2008 R2
Windows 2012
Windows 2012 R2

macOS Catalina (10.15)

macOS Mojave (10.14)

macOS High Sierra (10.13)

Ubuntu 20.04 (requires Python 2.7 - 3.7)

Ubuntu 19.04 (Requires Python 2.7)
Ubuntu 18.04 (Requires Python 2.7)
Ubuntu 14.04
Ubuntu 17.04

CentOS 8
CentOS 7.1
CentOS 7.3

Debian 10
Debian 7
Debian 8
RedHat 7
RedHat 7.3

Prerequisites

Windows: Microsoft .NET 4.6

Linux: Python Version 2.7 to 3.7 (Python version 3.8 or above is not supported yet)

.Net core runtime with version 3.1 Requirement

For Linux Agent v3.0 onwards and the Mac Agent v4.0 onwards, .Net core runtime with version 3.1 is required and is automatically downloaded and installed during installation of the Agent.

Support for the following OS versions/flavors deprecated as of September 21, 2017

Windows: Windows XP, Windows Vista, Windows 2003

Support for the following OS versions/flavors deprecated as of August 01, 2017

MAC: OS X Mountain Lion (10.8) and OS X Mavericks (10.9)

Linux: openSUSE and Fedora