Note: We've updated our pricing and packaging. This feature is available on Garden, Estate & Forest plans for customers who signed up before Nov 2nd 2020.
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 11 Windows 10 Windows 8 Windows 8.1 Windows 7 Windows 2008 Windows 2008 R2 Windows 2012 Windows 2012 R2 Windows 2016 Windows 2019 Windows 11 | macOS Catalina (10.15) BigSur 11.3.1 (compatible with M1 chipset also) Monterey Mac os(12.0.1) in M1 chipset | Ubuntu 20.04 (requires Python 2.7 - 3.7) Ubuntu 19.04 (Requires Python 2.7) Ubuntu 18.04 (Requires Python 2.7) Ubuntu 22.04 CentOS 8 CentOS 7.1 CentOS 7.3 Debian 10 RedHat 7 RedHat 7.3 |
Note:
- Mac Agent does not work in Mac Arm64 as .NET Core 3.1 runtime is not supported in the architecture.
- Starting from Mac version 5.1.0 and Linux version 4.0.0, Freshservice discovery agent will now operate on the .NET 6 runtime. Please use the attached script, If you wish to uninstall .NET Core 3.1.
Prerequisites
Windows: Microsoft .NET 4.6
Linux: Python Version 3.8 or above
OpenSSL is a prerequisite for .Net runtime to work
.Net runtime has the following library dependencies:
wget or curl
Specific to Linux agents:
Linux packages
GNU C Library (glibc)
GNU C++ Library
GCC low-level runtime library
ICU
Kerberos
Open SSL
zlib compression library
Linux distribution-specific dependencies
Ubuntu
Libc6
Libgcc1
Libgssapi-krb5-2
libicu52 (for 14.x)
libicu55 (for 16.x)
libicu60 (for 18.x)
libicu66 (for 20.x)
libssl1.0.0 (for 14.x, 16.x)
libssl1.1 (for 18.x, 20.x)
libstdc++6
zlib1g
Alpine
icu-libs
krb5-libs
libgcc
libgdiplus (if the .NET app requires the System.Drawing.Common assembly)
libintl
libssl1.1 (Alpine v3.9 or greater)
libssl1.0 (Alpine v3.8 or lower)
libstdc++
zlib
CentOS
krb5-libs
libicu
openssl-libs
zlib
CentOS Stream and RedHat Enterprise Linux
krb5-libs
libicu
openssl-libs
zlib
Debian
libc6
libgcc-s1
libgssapi-krb5-2
libicu52 (for 8.x)
libicu57 (for 9.x)
libicu63 (for 10.x)
libicu67 (for 11.x)
libssl1.0.0 (for 8.x)
libssl1.1 (for 9.x-11.x)
libstdc++6
Zlib1g
Fedor
krb5-libs
libicu
openssl-libs
zlib
OpenSuse
krb5
libicu
libopenssl1_0_0
SLES
krb5
libicu
libopenssl1_1
Support for the following OS versions/flavors deprecated as of September 21, 2017
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