The following information has been obtained from *fusioninventory-agent\_windows-x64\_2.3.2.exe*, the installer for x64 architectures, but it's also valid for *fusioninventory-agent\_windows-x86\_2.3.2.exe*, the installer for x86 architectures.

NAME

fusioninventory-agent_windows-x64_2.3.2.exe – FusionInventory Agent 2.3.2 (x64 edition) Setup

SYNOPSIS

fusioninventory-agent_windows-x64_2.3.2.exe [/Option[ /Option[ …]]]

DESCRIPTION

fusioninventory-agent_windows-x64_2.3.2.exe installs FusionInventory Agent 2.3.2 in your Microsoft Windows operative system.

fusioninventory-agent_windows-x64_2.3.2.exe has two types of installation; the from-scratch type, that allows to perform an installation of FusionInventory Agent from the beginning, based on the options’ default values (see below), and the from-current-config type, that allows to perform an installation based on the options values of the FusionInventory Agent previously installed on the system, whether it exists (see /installtype). (Bear in mind that, with independence of the type of installation you choose, any existing release of FusionInventory Agent will be uninstalled automatically immediately before installing FusionInventory Agent 2.3.2)

fusioninventory-agent_windows-x64_2.3.2.exe also has two modes of installation; the silent mode (see /S), that allows to perform the installation of FusionInventory Agent in a non-interactive or unattended way, and the visual mode, that allows to perform the installation of FusionInventory Agent in a graphical and interactive way.

fusioninventory-agent_windows-x64_2.3.2.exe is provided with a series of options (see below) that allows to adapt the installation to practically any environment or need. To use these options properly it is essential to know the order in which values are taken into account. That order is as follows (the higher the number, the greater the priority).

  1. Default values

  2. Values from the current FusionInventory Agent (from-current-config installation type only)

  3. Values from the command line

  4. Values from graphic user interface (graphic mode installation only)

You should bear in mind the following when using the command line:

  • There are two types of options; those that act as a switch (/option), and those that have a value (/option=value).

  • The name of the options is case sensitive (/html is not the same that /HTML).

  • The value of the options, unless otherwise specified, is not case sensitive (/local=C:\Temp is the same that /local=c:\temp).

  • In the options that have a value,

    • there should be no separation around the equal sign (/local = c:\temp is incorrect).

    • if the value contains a space or the (/) character, should go between single (‘) or double (“) quotes (/local=’C:\FusionInventory Agent’).

    • if you want to set a empty value, you must indicate a empty string (/local=’‘).

These are the command line options available:

/acceptlicense

You accept and acknowledge that you have read, and understood, the terms and conditions of FusionInventory Agent 2.3.2 license. (By default: No)

You must use this option if you perform the installation in silent mode (see /S).

If you indicate this option on the command line, but not the /S option, the visual mode installation will omit any question about the license.

/add-firewall-exception

Adds FusionInventory Agent to the Windows Firewall exception list. (By default: No)

ToDo

/backend-collect-timeout=timeout

Timeout for task Inventory modules execution. (By default: 180 seconds)

/ca-cert-dir=pathname

Absolute path to the standard certificate directory of certificate authorities (CA). (By default: “”)

The use of this option is incompatible with the use of the /ca-cert-file option. The /ca-cert-dir and /ca-cert-file options are mutually exclusive.

A standard certificate directory must contain the certificate files corresponding to different certificate authorities in Privacy Enhanced Mail (PEM) format, and their names must correspond to the hash value of the certificate’s subject field, with extension *.0.

For example, if you want to include the certificate file FICert_Class1.crt in the directory pathname, you must calculate the hash value of the certificate’s subject field using, for example, OpenSSL

C:\OpenSSL> openssl.exe x509 -in C:\FICert_Class1.crt -subject_hast -noout
b760f1ce

and afterwards, move or copy the certificate file to the directory pathname with the name b760f1ce.0.

C:\OpenSSL> move.exe C:\FICert_Class1.crt *pathname*\b760f1ce.0

/ca-cert-file=filename

Full path to the certificates file of certification authorities (CA). (By default: “”)

The use of this option is incompatible with the use of the /ca-cert-dir option. The /ca-cert-dir and /ca-cert-file options are mutually exclusive.

filename must have extension *.pem (Privacy Enhanced Mail) and can contain one or more certificates of certificate authorities. To concatenate multiple certificate files into one file you can make use, for example, of the command copy.

C:\> copy.exe FICert_Class1.crt+FICert_Class2.crt FICerts.pem

/ca-cert-uri=URI

URI from where to obtain the file or files of certificate of authorities (CA). (By default: “”)

The use of this option requires the joint use of the /ca-cert-dir or /ca-cert-file options, but not both.

ToDo

/debug=level

Sets the debug level of the agent. (By default: 0)

level can be any of the following values:

  • 0: Debug off

  • 1: Normal debug

  • 2: Full debug

/delaytime=limit

Sets an initial delay before first contact with a remote destination (see /server). This delay is calculated at random between limit/2 and limit seconds. (Default: 3600 seconds)

This option is ignored for remote destinations after the first contact with each one, in favor of the specific server parameter (PROLOG_FREQ).

The /delaytime option comes into play only if FusionInventory Agent runs in server mode (see /execmode).

/dumphelp

See /help.

/execmode=mode

Sets the agent execution mode. (By default: Current)

mode can be any of the following values:

  • Service: The agent runs as a Windows Service (always running)

  • Task: The agent runs as a Windows Task (runs at intervals)

  • Manual: The agent doesn’t run automatically (no Service, no Task)

  • Current: The agent runs in the same way that the agent already installed runs

The mode Service is known also as server mode.

The mode Task is only available on Windows XP (or higher) and Windows Server 2003 (or higher) operative systems.

In the case of an installation from-scratch (see /installtype), the Current mode is a synonym of Service.

/help

This help. If the /help option is present, shows the help and aborts the installation.

You could prefer make use of the /dumphelp option instead of the /help option to get information. The /dumphelp option creates a RTF file with this help, and aborts the installation.

/html

Save the inventory as HTML instead of XML. (By default: No)

The /html option comes into play only if you have also indicated a value for the /local option.

/httpd

This option is the opposite of /no-httpd. See /no-httpd for more information.

/httpd-ip=ip

IP address by which the embedded web server should listen. (By default: 0.0.0.0)

/httpd-port=port

IP port by which the embedded web server should listen. (By default: 62354)

/httpd-trust={ip range hostname}[,{ip range hostname}[…]]

Trusted IP addresses that do not require authentication token by the integrated web server. (By default: 127.0.0.1/32)

ip is an IP address in dot-decimal notation (ex. “127.0.0.1”) or in CIDR notation (ex. “127.0.0.1/32”)

range is an IP address range in dot-decimal notation (ex. “192.168.0.0

  • 192.168.0.255” or “192.168.0.0 + 255”) or in CIDR notation (ex. “192.168.0.0/24”)

hostname is the name of a host (ex. “itms.acme.org”)

Bear in mind that /httpd-trust does not have to include the hostname part of those URIs that are set up in /server because they are tacitly included. The following is an example; both configurations are equal.

/httpd-trust="127.0.0.1/32,itms.acme.org"
/server="http://itms.acme.org/glpi/plugins/fusioninventory/"

----

/httpd-trust="127.0.0.1/32"
/server="http://itms.acme.org/glpi/plugins/fusioninventory/"

/installdir=pathname

Sets the installation base directory of the agent. (By default: C:\Program Files\FusionInventory-Agent)

pathname must be an absolute path.

ToDo

/installtasks={task[,task[…]] macro}

Selects the tasks to install. (By default: Default)

task can be any of the following values:

  • Deploy: Task Deploy

  • ESX: Task ESX

  • Inventory: Task Inventory

  • NetDiscovery: Task NetDiscovery

  • NetInventory: Task NetInventory

  • WakeOnLan: Task WakeOnLan

There are three macros defined to simplify the mission, are the following:

  • Minimal: Inventory

  • Default: Inventory

  • Full: Deploy,ESX,Inventory,NetDiscovery,NetInventory,WakeOnLan

It should be noted that the Inventory task will be always installed and that the NetDiscovery and NetInventory tasks are inter-dependent. Nowadays Minimal and Default are the same configuration.

/installtype={from-scratch from-current-config}

Selects between an installation from the beginning (from-scratch) or, whether the system has a previously installed agent, an installation based on the current configuration (from-current-config). (By default: from-current-config)

The installer automatically switches from from-current-config to from-scratch whether it’s not able to detect a FusionInventory Agent previously installed on the system. This behaviour makes unnecesary to have to indicate /installtype=from-scratch to perform a FusionInventory Agent installation on those systems in which it doesn’t exist previously and, at the same time, facillitates the update of FusionInventory Agent on those systems in which it exists.

/local=pathname

Writes the results of tasks execution into the given directory. (By default: “”)

You must indicate an absolute pathname or an empty string (“”). If you indicate an empty string, the results of tasks execution will not be written locally.

You can use the /local and /server options simultaneously.

/logfile=filename

Writes log messages into the file filename. (By default: C:\Program Files\FusionInventory-Agent\fusioninventory-agent.log)

You must indicate a full path in filename. The /local option comes into play only if you have also indicated File as a value of the /logger option.

/logfile-maxsize=size

Sets the maximum size of logfile (see /logfile) to size . (By default: 16 MBytes)

/logger=backend[,backend]

Sets the logger backends. (By default: File)

backend can be any of the following values:

  • File: Sends the log messages to a file (see /logfile)

  • Stderr: Sends the log messages to the console

/no-category=category[,category[…]]

Do not inventory the indicated categories of elements. (By default: “”)

category can be any of the following values:

  • Environment: Environment variables

  • Printer: Printers

  • Process: System’s processes (has no effect on Microsoft Windows systems)

  • Software: Software

  • User: Users

If you indicate an empty string (“”), all categories of elements will be inventoried.

/no-html

This option is the opposite of /html. See /html for more information.

/no-httpd

Disables the embedded web server. (By default: No)

/no-p2p

Do not use peer to peer to download files. (By default: No)

/no-scan-homedirs

This option is the opposite of /scan-homedirs. See /scan-homedirs for more information.

/no-ssl-check

Do not check server certificate. (By default: No)

/no-start-menu

Do not create the FusionInventory Agent folder on the Start Menu. (By default: No)

The FusionInventory Agent folder, whether it is created, it is for all users.

/no-task=task[,task[…]]

Disables the given tasks. (By default: “”)

task can be any of the following values:

  • Deploy: Task Deploy

  • ESX: Task ESX

  • Inventory: Task Inventory

  • NetDiscovery: Task NetDiscovery

  • NetInventory: Task NetInventory

  • WakeOnLan: Task WakeOnLan

If you indicate an empty string (“”), all tasks will be executed.

/p2p

This option is the opposite of /no-p2p. See /no-p2p for more information.

/password=password

Uses password as password for server authentication. (By default: “”)

The /password comes into play only if you have also indicated a value for the /server option.

/proxy=URI

Uses URI as HTTP/S proxy server. (By default: “”)

/runnow

Launches the agent immediately after its installation. (By default: No)

/S

Silent installation. (By default: No)

You must accept the license in a explicit way (see /acceptlicense) if you perform the installation in silent mode.

/scan-homedirs

Allows the agent to scan home directories for virtual machines. (By default: No)

/server=URI[,URI[…]]

Sends results of tasks execution to given servers. (By default: “”)

If you indicate an empty string (“”), the results of tasks execution will not be written remotely.

You can use the /server and /local options simultaneously.

/ssl-check

This option is the opposite of /no-ssl-check. See /no-ssl-check for more information.

/start-menu

This option is the opposite of /no-start-menu. See /no-start-menu for more information.

/tag=tag

Marks the computer with the tag tag . (By default: “”)

/task-daily-modifier=modifier

Daily task schedule modifier. (By default: 1 day)

modifier can take values between 1 and 30, both included.

The /task-daily-modifier option comes into play only if you have also indicated Daily as value of the /task-frequency option.

/task-frequency=frequency

Frequency for task schedule. (By default: Hourly)

frequency can be any of the following values:

  • Minute: At minute intervals (see option /task-minute-modifier)

  • Hourly: At hour intervals (see option /task-hourly-modifier)

  • Daily: At day intervals (see option /task-daily-modifier)

/task-hourly-modifier=modifier

Hourly task schedule modifier. (By default: 1 hour)

modifier can take values between 1 and 23, both included.

The /task-hourly-modifier option comes into play only if you have also indicated Hourly as value of the /task-frequency option.

/task-minute-modifier=modifier

Minute task schedule modifier. (By default: 15 minutes)

modifier can take the following values: 15, 20 or 30.

The /task-minute-modifier option comes into play only if you have also indicated Minute as value of the /task-frequency option.

/timeout=timeout

Sets the limit time (in seconds) to connect with the server. (By default: 180 seconds)

The /timeout option comes into play only if you have also indicated a value for the /server option.

/user=user

Uses user as user for server authentication. (By default: “”)

The /user option comes into play only if you have also indicated a value for the /server option.

EXAMPLES

ToDo

VERSION

This help is current for version 2.2.9903 of FusionInventory Agent’s installer for Microsoft Windows.

REPORTING BUGS

User Mailing List

  • http://lists.alioth.debian.org/mailman/listinfo/fusioninventory-user

Devel Mailing List

  • http://lists.alioth.debian.org/mailman/listinfo/fusioninventory-devel

Project Manager

  • http://forge.fusioninventory.org/projects/fusioninventory-agent-windows-installer

COPYRIGHT

Copyright 2012-2013 FusionInventory Team. GNU GPL version 2 or (at your option) any later version <http://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html>. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.

SEE ALSO

FusionInventory Web Site

  • http://www.fusioninventory.org/

AUTHOR

Tomás Abad <tabadgp@gmail.com>


You can download the PDF version of this document

You can download it here.