Installation

The latest release is available from our github releases page.

Note

In the case you're replacing FusionInventory agent with GLPI Agent, you should first uninstall FusionInventory agent before installing GLPI Agent. You can use the same dedicated configuration if you placed it in conf.d configuration subfolder.

Hint

Nightly builds are also available from our dedicated GLPI-Agent Nightly Builds page.

Windows

The installer integrates its native, although reduced but recent, version of Strawberry Perl including recent OpenSSL support.

You can download the lastest GLPI Agent installer or current nightly build. It is available for both 32 and 64 bits systems and provides a graphical interface as well as command line facilities.

By default, it will perform a graphical installation, unless you use the msiexec /i and /quiet options. All installer parameters are described in Windows installer dedicated page.

Note

All graphical installer options are related to a command line one. Check Windows installer if you need help.

Winget

You can also use Winget tool to install or update GLPI-Agent on Windows 10 and Windows 11.

You can check glpi-agent availability from the command line:

winget search glpi-agent

During first installation, you can trigger interactive installation running:

winget install -i glpi-agent

To install without configuration or update using current configuration, just run:

winget install glpi-agent

Note

As it is installed at machine level and requires administrative privileges, an UAC prompt should be triggered if you don't start the installation from an administrative console.

During first installation, you can use --custom option to configure glpi-agent as expected, for example for a quiet installation. You can use all parameters described in Windows installer page:

winget install glpi-agent --custom="SERVER='https://my-glpi-server/' RUNNOW=1"

Note

If you didn't configure during first installation, you still can edit configuration in registry under HKEY_LOCAL_MACHINE\SOFTWARE\GLPI-Agent registry key. Don't forget to restart the service if installed as a service (by default, it is).

Large Installations

Consider a scenario where the GLPI Agent application needs to be installed on large and diverse range of Windows systems. A VBScript can be useful in this scenario to perform the following tasks:

  • Install it silently taking variables from the installation script previously configured.

  • Check for the presence of FusionInventory and OCS Inventory agents and uninstall them if you need it.

  • Configure application settings based on command line parameters that can be explored here.

  • Log installation progress and errors for review and analysis.

A VBScript (Visual Basic Script) is provided to deploy the installer on a network: glpi-agent-deployment.vbs.

In this script you'll find some variables that can be changed to your environment needings (uncomment what is commented and you need. Comment what you don't need.):

  • GLPI Agent Version hereby named SetupVersion

  • Setup the Location from where the script will download the MSI hereby named SetupLocation. It can be a HTTP or HTTPS url, a CIFS or local folder. The default is to use the github release page url.

  • Setup the Architecture of your systems (if you need it to be x86, x64, or if you want to let it be installed according to the system Architecture) hereby named SetupArchitecture

  • Setup Options from the command line parameters:

    • It is recommended to keep the /quiet parameter so the user will not be bothered with wizard or command line messages or windows

    • If you want to follow all the steps of installations, don't add the /quiet parameter.

  • Reconfigure:

    • You will just set this up to Yes if the current installed agent has the same version you have configured on the SetupVersion above. This option, when activated, is going to reconfigure the new options for the same Agent.

    • It's useful when you just need to change a parameter like GLPI SERVER url, for example.

  • Repair:

    • This option will unregister and register the MSI service DLL, and reinstall it with the options selected on the script.

    • It works just when the Setup is still installed.

  • Verbose:

    • It Enables or Disables

  • Run uninstall:

    • Here you can uncomment the deprecated agents you want the script to uninstall (FusionInventory Agent or OCSInventory Agent)

Hint

Adding this VBS Script to a Computer GPO to run on startup of computers, usually works better, since there are some users with no installation rights. The msi download should be accessible for every computer that needs to execute it. If you are using a local network sharing, or a regular Github URL, you must make sure the computers are able to download it from the original source.

Contributions

Glpi-Agent Monitor

Leonardo Bernardes published Glpi-Agent Monitor tool which provides a systray icon to survey the agent status and permit to ask a tasks run.

You can download it from the Glpi-Agent Monitor project release page. You simply have to download the exe into any folder (the Glpi-Agent installation folder is just fine) and start it.

If you want to add it to all users auto-started softwares, you can directly install it into the C:\ProgramData\Microsoft\Windows\Start Menu\Programs\StartUp folder.

Hint

Glpi-Agent Monitor has been integrated into GLPI-Agent MSI installer and can be enabled using AGENTMONITOR=1 on the MSI commandline. When installed this way, you don't need to copy it manually and it starts when a user is logs in.

MacOS

The installer integrates its native, although reduced but recent, version of Perl including recent OpenSSL support.

Get the latest .pkg package from our releases page or the nightly build page. After installing it, you'll have to configure the agent to your needs by creating a dedicated .cfg file under the /Applications/GLPI-Agent/etc/conf.d folder.

You can for example create a local.cfg file and:

  • add the server = GLPI_URL line to point to your GLPI server,

  • eventually set debug = 1 to generate some debug in logs,

  • set a tag like tag = MyLovelyTag.

Hint

A MacOSX installation video tutorial is available here: GLPI Agent Demonstration - macOS Monterey - Apple M1

GNU/Linux

We support major distros as we provides generic packages for RPM and DEB based distros as well if they supports Snap packaging. You can install required packages after getting them from our github releases page or the nightly build page.

Hint

When possible, prefer to use our linux perl installer as it supports RPM and DEB based distros. There's a version also including the Snap package. The linux installer accepts few options to configure the agent so it can simplify manual or automatic installation. It also can be handy for tools like Puppet or Ansible.

Linux AppImage installer

Hint

When not sure or linux perl installer doesn't support your distro, try Linux AppImage installer.

See Linux AppImage installer dedicated page

Snap

The Snapcraft Snap package integrates its native, although reduced but recent, version of Perl including recent OpenSSL support.

If your system support Snap, you can simply install the agent with the snap command after getting the Snap package from our releases page or the nightly build page. Then, you just have to run:

snap install --classic --dangerous GLPI-Agent-1.7_amd64.snap

After installation, you can easily configure the agent with the set snap sub-command:

snap set glpi-agent server=http://my-glpi-server/

Any supported glpi-agent option can be set this way. If you need to unset a configuration parameter, just set it empty:

snap set glpi-agent tag=

Note

You won't find the package in the Snapcraft store as their standard policies are too restrictive for GLPI Agent features and requirements.

Linux Perl Installer

Attention

The linux installer main requirement is the perl command.

It also requires one of the following command, depending on the targeted system:

  • dnf for recent RPM based systems

  • yum for previous generation of RPM based systems

  • apt for DEB based systems like Debian & Ubuntu

  • snap for other systems supporting Snapcraft Snap packages

We also provide a dedicated linux installer which includes all the packages we build (RPM & DEB) and eventually the snap one. On supported distros (DEB & RPM based), the installer will also eventually try to enable third party repositories, like EPEL on CentOS if they are required.

The installer is a simple perl script. It supports various options to configure the agent during installation. If no options are specified, the default is for the installer to configure glpi-agent to not scan user home directories or profiles, to run inventory modules with a 30 minute timeout, to allow HTTP requests to port 62354 only from the GLPI server, to setup the glpi-agent as a service and to install only the Computer Inventory and Remote Inventory tasks. You can check all supported options by running:

perl glpi-agent-1.7-linux-installer.pl --help

or if you use the installer embedding snap package:

perl glpi-agent-1.7-with-snap-linux-installer.pl --help

If your GNU/Linux distro is not supported, you still can install it from sources.

Unofficial repositories

Attention

Unofficial repositories are not supported by GLPI-Agent editor. Use them at your own risk.

Thanks to ligenix, a COPR repository can be used to install glpi-agent on Fedora 35 & 36, CentOS Stream 8 & 9, EPEL 7, 8 & 9: ligenix/enterprise-glpi10

From sources

Note

We strongly recommend the use of GNU tar because some file path length are greater than 100 characters. Some tar version will silently ignore those files.

First, you need to extract the source and change the current directory.

tar xfz GLPI-Agent-1.7.tar.gz
cd GLPI-Agent-1.7

Executing Makefile.PL will verify all the required dependencies are available and prepare the build tree.

perl Makefile.PL

If you don't want to use the default directory (/usr/local), you can use the PREFIX parameter:

perl Makefile.PL PREFIX=/opt/glpi-agent

Note

At this point, you may have some missing required modules. See PERL Dependencies section for installing them. Once this is done, run the same command again.

You now can finish the installation. Here again we recommend GNU make (gmake):

make
make install

Tests

Note

The tests suite requires some additional dependencies like Test::More.

GLPI agent comes with a test-suite. You can run it with this command:

make test

Perl dependencies

The easiest way to install perl dependencies is to use cpanminus script, running:

cpanm .

You can use the --notest flag if you are brave and want to skip the tests suite execution for each install perl module.

Offline installations

Note

This requires the cpanminus script to be installed.

First grab the tarball from the website and extract it:

tar xzf GLPI-Agent-1.7.tar.gz
cd GLPI-Agent-1.7

We use cpanm to fetch and extract the dependencies in the extlib directory:

cpanm --pureperl --installdeps -L extlib --notest .

If this command fails with an error related to Params::Validate, then just run this last command:

cpanm --installdeps -L extlib --notest .

Now you can copy the directory to another machine and run the agent this way:

perl -Iextlib/lib/perl5 -Ilib glpi-agent

Other dependencies

On Solaris/SPARC, you must install sneep and record the Serial Number with it.

On Windows, we use an additional dmidecode binary shipped in the windows MSI package to retrieve many information not available otherwise, including fine-grained multi-cores CPUs identification. Unfortunately, this binary is not reliable enough to be used on Windows 2003, leading to less precise inventories.

On Linux, lspci will be used to collect PCI, AGP, PCI-X, ... information.