Rechercher une page de manuel

Chercher une autre page de manuel:


Langue: en

Version: 2010-05-27 (ubuntu - 24/10/10)

Section: 1 (Commandes utilisateur)


fusioninventory-agent - FusionInventory agent For Linux/UNIX and MacOSX


fusioninventory-agent [ ... ] [ --server server | --local /tmp ]...


     % fusioninventory-agent --server localhost
     # send an inventory to the OCS server
     % fusioninventory-agent --server http://localhost/ocsinventory2
     # send an inventory over http to a server with a non standard
     # virtual directory
     % fusioninventory-agent --server https://localhost/ocsinventory
     # send an inventory over https to the OCS server
     % fusioninventory-agent --local /tmp
     # write an inventory in the /tmp directory
     % fusioninventory-agent --server localhost --user=toto --password=pw
 --realm="Restricted Area"
     # send a report to a server protected by a basic authentication
     % fusioninventory-agent --lazy
     # send an inventory only if the a random delay between 0 and PROLOG_FREQ
 had been run over.
     % fusioninventory-agent --delaytime 60 -d
     # If NO PROLOG_FREQ has been preset, pick a time between execution and
 --delaytime for the agent to contact the server [default is 3600 seconds]


fusioninventory-agent creates inventory and send or write them. This agent is the successor of the former linux_agent which was released with OCS 1.01 and prior. It also replaces the Solaris/AIX/BSD unofficial agents. The detailed list of supported Operating System is available in the Wiki.


Most of the options are available in a short form and a long form. For example, the two lines below are all equivalent:
     % fusioninventory-agent -s localhost
     % fusioninventory-agent --server localhost
Time before the agent kills modules processing which don't end before the timeout.
Indicate the place where the agent should store its files.
Display color on the terminal.
-d, --daemon
Launch fusioninventory-agent as daemon in background. Proc::Daemon is needed.
-D, --daemon-no-fork
Launch fusioninventory-agent in daemon but do fork in background.
The directory where public SSL certificat are stored. In general it /etc/ssl/certs;
The path to the public certificat (e.g: /etc/ssl/certs/cacert.pem). If --ca-cert-file is used, --ca-cert-dir is ignored.
Turn the debug mode on.
This option is designed for the developer. With it enabled, fusioninventory-agent won't try to load the Backend module installed on the system. Instead it will scan the ./lib directory. It may also be useful if you don't want to install the agent on your system.
This option defaults to waiting a random() time between 0 and 3600 before initially contacting the server assuming NO PROLOG_FREQ has been set. Once PROLOG_FREQ has been set, it uses that number at the top end of it's random setting. Useful for pre-setting a deployed agent's initial start time (so you don't jam the server all at once, but don't have to wait an hour to make sure the deployment worked).
-f, --force
The agent ask first the server if it should send an inventoroy of the machine. If the server doesn't know the machine or has outdated informations, it will request it. With this option, the agent ignore the server anwser and send an inventory.
-i, --info
Turn the verbose mode on. The flag is ignored if --debug is enable.
Do not contact the server more than one time during the PROLOG_FREQ and do an exit if there is nothing to do. Useful if you want to start the agent script regulary from the crontab but don't want to overload the server.
-l, --local=DIR
Write an inventory in the DIR directory. A new file will be created if needed.
Log message in FILE and turn off STDERR
Disable the software deployment.
Do not generate inventory.
Do not use the wakeonlan.
Do not inventory the software installed on the machine.
-p, --password=PASSWORD
Use PASSWORD for an HTTP identification with the server.
-P, --proxy=PROXY
Use PROXY to specify a proxy HTTP server. By default, the agent uses HTTP_PROXY environment variable.
-r, --realm=REALM
Use REALM for an HTTP identification with the server. For example, the value can be 'Restricted Area'. You can find it in the login popup of your Internet browser.
The IP address of the interface to use for the P2P exchange. The default is 'all' the IP addresses with a mask except
Should the VirtualMachine inventory include users own VM?
-s, --server=URI
The uri of the server. If URI doesn't start with http:// or https://, the assume the parameter is a hostname and rewrite it like that:
     % --server=http://servername/ocsinventory

If you want to use https or another virtual directory (e.g: /ocsinventory2) you need to enter the full path.

You can declare more than one server if you use the ',' delimiter.

     % --server=http://servername/ocsinventory,server2

--server is ignored if --local is in use.

Print the inventory on stdout.
     % fusioninventory-agent --stdout > /tmp/report.xml
     # prepare an inventory and write it in the /tmp/report.xml file.
     # A file will be created.
Authorized the agent to scan home directories to increase the Virtual Machine inventory.
Mark the machine with the TAG tag. Once the initial inventory is accepted by the server this value is ignored and you've to change the information directly on the server. The server do so in order to centralize the administration of the machine.
Do now validate HTTPS certificat with the servers. Please never use this option in production. This is just a very bad idea.
-u USER, --user=USER
Use USER for the server authentication.
Print the version and exit.
Wait during a random period between 0 and DURATION second before initializing the connexion with the server.
     % fusioninventory-agent --wait 5 --server localhost


The agent try to initialize the settings from the agent.cfg config file.

It looks for the file in these location:



The maintainer is Goneri LE BOUDER <>

Please read the AUTHORS, Changes and THANKS files to see who is behind FusionInventory.


FusionInventory website: <>
LaunchPad project page: <>
the Mailing lists and IRC


Please, use the mailing lists as much as possible. You can open your own bug tickets. Patches are welcome. You can also use LaunchPad bugtracker or push your Bazaar branch on LaunchPad and do a merge request. Copyright (C) 2006-2010 OCS Inventory contributors Copyright (C) 2010 FusionInventory Team
  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License as published by
  the Free Software Foundation; either version 2 of the License, or
  (at your option) any later version.
  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  GNU General Public License for more details.
  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
Pour traverser le Chili du nord au sud, on prend le train.
Et selon qu'on veut la traverser d'est en ouest ou d'ouest en est,
On descend voie 1 ou voie 2.
-+- Philippe Geluck, Le chat -+-