fusioninventory-agent_windows_2.3.11.1_en.html

English help in HTML - Tomás Abad, 09/26/2014 12:31 AM

Download (32.4 KB)

 
1
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2
<html xmlns="http://www.w3.org/1999/xhtml">
3
<head>
4
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
5
  <meta http-equiv="Content-Style-Type" content="text/css" />
6
  <meta name="generator" content="pandoc" />
7
  <meta name="author" content="Tomás Abad Gómez-Pastrana" />
8
  <title>FusionInventory Agent Windows Installer  User’s Guide for v2.3.11  (Draft v0.1)</title>
9
  <style type="text/css">code{white-space: pre;}</style>
10
</head>
11
<body>
12
<div id="header">
13
<h1 class="title">FusionInventory Agent Windows Installer<br /> User’s Guide for v2.3.11<br /> (Draft v0.1)</h1>
14
<h2 class="author">Tomás Abad Gómez-Pastrana</h2>
15
<h3 class="date">Sep 25, 2014</h3>
16
</div>
17
<div id="TOC">
18
<ul>
19
<li><a href="#synopsys">Synopsys</a></li>
20
<li><a href="#description">Description</a></li>
21
<li><a href="#using-fusioninventory-agent-windows-installer">Using <em>FusionInventory Agent Windows Installer</em></a></li>
22
<li><a href="#command-line-options">Command line options</a><ul>
23
<li><a href="#specific-options-of-the-installer">Specific options of the installer</a></li>
24
<li><a href="#specific-options-of-the-agent">Specific options of the agent</a></li>
25
</ul></li>
26
<li><a href="#graphic-user-interface">Graphic user interface</a></li>
27
<li><a href="#the-fusioninventory-agent-configuration">The <em>FusionInventory Agent</em> configuration</a></li>
28
<li><a href="#version">Version</a></li>
29
<li><a href="#reporting-bugs">Reporting bugs</a></li>
30
<li><a href="#authors">Authors</a></li>
31
<li><a href="#copyright">Copyright</a></li>
32
<li><a href="#see-also">See also</a></li>
33
</ul>
34
</div>
35
<hr />
36
<div id="synopsys" class="section level1">
37
<h1>Synopsys</h1>
38
<blockquote>
39
<p><code>fusioninventory-agent_windows-x86_2.3.11.exe [/Option [/Option [...]]]</code></p>
40
<p><code>fusioninventory-agent_windows-x64_2.3.11.exe [/Option [/Option [...]]]</code><a href="#fn1" class="footnoteRef" id="fnref1"><sup>1</sup></a></p>
41
</blockquote>
42
</div>
43
<div id="description" class="section level1">
44
<h1>Description</h1>
45
<p><a href="http://www.fusioninventory.org/documentation/agent/installation/windows/">FusionInventory Agent Windows Installer</a><a href="#fn2" class="footnoteRef" id="fnref2"><sup>2</sup></a> installs <a href="http://www.fusioninventory.org/documentation/">FusionInventory Agent</a><a href="#fn3" class="footnoteRef" id="fnref3"><sup>3</sup></a> on Microsoft Windows operating systems.</p>
46
<p>It has two types of installation; the <em>from-scratch</em> type, that allows to perform an installation of FusionInventory Agent from the beginning, based on the default values of <a href="#command-line-options">options</a>, and the <em>from-current-config</em> type, that allows to perform an installation based on the values of options of the current FusionInventory Agent present on the system, whether it exists<a href="#fn4" class="footnoteRef" id="fnref4"><sup>4</sup></a>. Besides these types of installation, it also has two modes of installation; the <em>silent mode</em>, that allows to perform the installation of FusionInventory Agent in a non-interactive or unattended way, and the <em>visual mode</em>, that allows to perform the installation of FusionInventory Agent in a graphical and interactive way.</p>
47
<p>It is needed to bear in mind that, with independence of the type of installation choosed, any existing release of FusionInventory Agent present on the system will be uninstalled automatically just before installing FusionInventory Agent v2.3.11. It is also noteworthy that, in the case of a <em>from-current-config</em> installation, any deprecated option will not be taken into account, and that any other change regarding options —renaming, splitting or grouping— will be managed automatically.</p>
48
</div>
49
<div id="using-fusioninventory-agent-windows-installer" class="section level1">
50
<h1>Using <em>FusionInventory Agent Windows Installer</em></h1>
51
<p>This section describes some of the most typical uses of FusionInventory Agent Windows Installer.</p>
52
<p><em>ToDo</em></p>
53
</div>
54
<div id="command-line-options" class="section level1">
55
<h1>Command line options</h1>
56
<p>FusionInventory Agent Windows Installer is provided with a series of options 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—.</p>
57
<blockquote>
58
<ol style="list-style-type: decimal">
59
<li>Default values</li>
60
<li>Values from the current FusionInventory Agent (whether it exists and only in the case of <em>from-current-config</em> installation type)</li>
61
<li>Values from the command line (whether they exist)</li>
62
<li>Values from graphic user interface (only in the case of <em>graphic mode</em> installation)</li>
63
</ol>
64
</blockquote>
65
<p>You should bear in mind the following when using the command line:</p>
66
<blockquote>
67
<ul>
68
<li>There are two types of options; those that act as a <em>Yes/No</em>, <em>On/Off</em> or <em>True/False</em> switch (<em><code>/option</code></em>), and those that have a value (<em><code>/option=value</code></em>)</li>
69
<li>The name of the options is case sensitive (<code>/html</code> is not the same that <code>/HTML</code>)</li>
70
<li>The value of the options, unless otherwise specified, is not case sensitive (<code>/local=C:\Temp</code> is the same that <code>/local=c:\temp</code>)</li>
71
<li>There should be no separation around the equal sign (<code>/local = c:\temp</code> is incorrect)</li>
72
<li>Those values which contain a space, tabulator or the “<code>/</code>” character, should go between single “<code>'</code>” or double “<code>&quot;</code>” quotes (<code>/local='C:\FusionInventory Agent'</code>)</li>
73
<li>An empty string is need to indicate an empty value (<code>/local=''</code> is correct, <code>/local=</code> would generate an error)</li>
74
</ul>
75
</blockquote>
76
<p>The two following sections contain, on one hand, the <a href="#specific-options-of-the-installer">specific options of the installer</a> and, on the other hand, those <a href="#specific-options-of-the-agent">options which change the FusionInventory Agent behaviour</a>.</p>
77
<div id="specific-options-of-the-installer" class="section level2">
78
<h2>Specific options of the installer</h2>
79
<dl>
80
<dt><code id="acceptlicense">/acceptlicense</code></dt>
81
<dd><p>You accept and acknowledge that you have read, and understood, the terms and conditions of the license. (By default: <code>No</code>)</p>
82
<p>You must use this option if you perform the installation in <em>silent mode</em> (see <a href="#S"><code>/S</code></a>).</p>
83
<p>If you indicate this option on the command line, but not the <a href="#S"><code>/S</code></a> option, the <em>visual mode</em> installation will omit any question about the license.</p>
84
</dd>
85
<dt><code id="add-firewall-exception">/add-firewall-exception</code></dt>
86
<dd><p>Adds FusionInventory Agent to the Windows Firewall exception list. (By default: <code>No</code>)</p>
87
<p><em>It is not implemented yet</em>.</p>
88
</dd>
89
<dt><code id="ca-cert-uri">/ca-cert-uri</code>=<em>URI</em></dt>
90
<dd><p><em>URI</em> from where to obtain the file or files of certificate of authorities (CA). (By default: <code>''</code>)</p>
91
<p>The use of this option requires the joint use of the <code>/ca-cert-dir</code> or <code>/ca-cert-file</code> options, but not both.</p>
92
<p><em>It is not implemented yet</em>.</p>
93
</dd>
94
<dt><code id="dumphelp">/dumphelp</code></dt>
95
<dd><p>This option has been deprecated in FusionInventory Agent Windows Installer v2.3.11.</p>
96
</dd>
97
<dt><code id="execmode">/execmode</code>=<em>mode</em></dt>
98
<dd><p>Sets the agent execution mode. (By default: <code>Current</code>)</p>
99
<p><em>mode</em> can be any of the following values:</p>
100
<blockquote>
101
<dl>
102
<dt><code>Service</code> <a href="#fn5" class="footnoteRef" id="fnref5"><sup>5</sup></a></dt>
103
<dd>The agent runs as a Windows Service (always running)
104
</dd>
105
<dt><code>Task</code> <a href="#fn6" class="footnoteRef" id="fnref6"><sup>6</sup></a></dt>
106
<dd>The agent runs as a Windows Task (runs at intervals)
107
</dd>
108
<dt><code>Manual</code></dt>
109
<dd>The agent doesn’t run automatically (no <code>Service</code>, no <code>Task</code>)
110
</dd>
111
<dt><code>Current</code> <a href="#fn7" class="footnoteRef" id="fnref7"><sup>7</sup></a></dt>
112
<dd>The agent runs in the same way that the agent already installed runs
113
</dd>
114
</dl>
115
</blockquote>
116
<p>When <em>mode</em> is <code>Service</code> or <code>Task</code>, FusionInventory Agent Windows Installer creates a Windows Service called <em>FusionInventory-Agent</em> or a Windows Task called <em>FusionInventory-Agent</em> respectively.</p>
117
</dd>
118
<dt><code id="help">/help</code></dt>
119
<dd><p>This help. If the <code>/help</code> option is present, shows this help and aborts the installation.</p>
120
</dd>
121
<dt><code id="installdir">/installdir</code>=<em>pathname</em></dt>
122
<dd><p>Sets the installation base directory of the agent. (By default: <code>%ProgramFiles%\FusionInventory-Agent</code>)</p>
123
<p><em>pathname</em> must be an absolute path.</p>
124
<p><em>It is not implemented yet</em>.</p>
125
</dd>
126
<dt><code id="installtasks">/installtasks</code>={<em>task</em>[,<em>task</em>[…]] | <em>macro</em>}</dt>
127
<dd><p>Selects the tasks to install. (By default: <code>Default</code>)</p>
128
<p><em>task</em> can be any of the following values:</p>
129
<blockquote>
130
<dl>
131
<dt><code>Deploy</code></dt>
132
<dd>Deploy task
133
</dd>
134
<dt><code>ESX</code></dt>
135
<dd>ESX task
136
</dd>
137
<dt><code>Inventory</code></dt>
138
<dd>Inventory task
139
</dd>
140
<dt><code>NetDiscovery</code></dt>
141
<dd>Network discovery task
142
</dd>
143
<dt><code>NetInventory</code></dt>
144
<dd>Network inventory task
145
</dd>
146
<dt><code>WakeOnLan</code></dt>
147
<dd>Wake on LAN task
148
</dd>
149
</dl>
150
</blockquote>
151
<p>There are three macros defined to simplify the mission, are the following:</p>
152
<blockquote>
153
<dl>
154
<dt><code>Minimal</code></dt>
155
<dd><code>Inventory</code>
156
</dd>
157
<dt><code>Default</code></dt>
158
<dd><code>Inventory</code>
159
</dd>
160
<dt><code>Full</code></dt>
161
<dd><code>Deploy</code>,<code>ESX</code>,<code>Inventory</code>,<code>NetDiscovery</code>,<code>NetInventory</code>,<code>WakeOnLan</code>
162
</dd>
163
</dl>
164
</blockquote>
165
<p>It should be noted that the <code>Inventory</code> task will be always installed and that the <code>NetDiscovery</code> and <code>NetInventory</code> tasks are inter-dependent. Nowadays <code>Minimal</code> and <code>Default</code> are the same configuration.</p>
166
</dd>
167
<dt><code id="installtype">/installtype</code>={<code>from-scratch</code> | <code>from-current-config</code>}</dt>
168
<dd><p>Selects between an installation from the beginning (<code>from-scratch</code>) or, whether the system has a previously installed agent, an installation based on the current configuration (<code>from-current-config</code>). (By default: <code>from-current-config</code>)</p>
169
<p>The installer automatically switches from <code>from-current-config</code> to <code>from-scratch</code> whether it’s not able to detect a FusionInventory Agent previously installed on the system. This behaviour makes unnecesary to have to indicate <code>/installtype=from-scratch</code> 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.</p>
170
</dd>
171
<dt><code id="no-start-menu">/no-start-menu</code></dt>
172
<dd><p>Do not create the <em>FusionInventory Agent</em> folder on the Start Menu. (By default: <code>No</code>)</p>
173
<p>The <em>FusionInventory Agent</em> folder, whether it is created, it is for all users.</p>
174
</dd>
175
<dt><code id="runnow">/runnow</code></dt>
176
<dd><p>Launches the agent immediately after its installation. (By default: <code>No</code>)</p>
177
</dd>
178
<dt><code id="S">/S</code></dt>
179
<dd><p>Silent installation. (By default: <code>No</code>)</p>
180
<p>You must accept the license in a explicit way if you perform the installation in silent mode (see <a href="#acceptlicense"><code>/acceptlicense</code></a>).</p>
181
</dd>
182
<dt><code id="start-menu">/start-menu</code></dt>
183
<dd><p>This option is the opposite of <code>/no-start-menu</code>. See <a href="#no-start-menu"><code>/no-start-menu</code></a> for more information.</p>
184
</dd>
185
<dt><code id="task-daily-modifier">/task-daily-modifier</code>=<em>modifier</em></dt>
186
<dd><p>Daily task schedule modifier. (By default: <code>1</code>)</p>
187
<p><em>modifier</em> can take values between 1 and 30 (days), both included.</p>
188
<p>The <code>/task-daily-modifier</code> option comes into play only if you have also indicated <code>Daily</code> as value of the <a href="#task-frequency"><code>/task-frequency</code></a> option.</p>
189
</dd>
190
<dt><code id="task-frequency">/task-frequency</code>=<em>frequency</em></dt>
191
<dd><p>Frequency for task schedule. (By default: <code>Hourly</code>)</p>
192
<p><em>frequency</em> can be any of the following values:</p>
193
<blockquote>
194
<dl>
195
<dt><code>Minute</code></dt>
196
<dd>At minute intervals (see option <a href="#task-minute-modifier"><code>/task-minute-modifier</code></a>)
197
</dd>
198
<dt><code>Hourly</code></dt>
199
<dd>At hour intervals (see option <a href="#task-hourly-modifier"><code>/task-hourly-modifier</code></a>)
200
</dd>
201
<dt><code>Daily</code></dt>
202
<dd>At day intervals (see option <a href="#task-daily-modifier"><code>/task-daily-modifier</code></a>)
203
</dd>
204
</dl>
205
</blockquote>
206
</dd>
207
<dt><code id="task-hourly-modifier">/task-hourly-modifier</code>=<em>modifier</em></dt>
208
<dd><p>Hourly task schedule modifier. (By default: <code>1</code>)</p>
209
<p><em>modifier</em> can take values between 1 and 23 (hours), both included.</p>
210
<p>The <code>/task-hourly-modifier</code> option comes into play only if you have also indicated <code>Hourly</code> as value of the <a href="#task-frequency"><code>/task-frequency</code></a> option.</p>
211
</dd>
212
<dt><code id="task-minute-modifier">/task-minute-modifier</code>=<em>modifier</em></dt>
213
<dd><p>Minute task schedule modifier. (By default: <code>15</code>)</p>
214
<p><em>modifier</em> can take the following values: 15, 20 or 30 (minutes).</p>
215
<p>The <code>/task-minute-modifier</code> option comes into play only if you have also indicated <code>Minute</code> as value of the <a href="#task-frequency"><code>/task-frequency</code></a> option.</p>
216
</dd>
217
</dl>
218
</div>
219
<div id="specific-options-of-the-agent" class="section level2">
220
<h2>Specific options of the agent</h2>
221
<p>This set of options is actually a subset of FusionInventory Agent options to which FusionInventory Agent Windows Installer adds some others<a href="#fn8" class="footnoteRef" id="fnref8"><sup>8</sup></a> to be able to realize <em>from-current-config</em> installations. It is interesting to note that, except for those already commented above, there is a direct relationship between the names of FusionInventory Agent Windows Installer specific options for FusionInventory Agent and the names of FusionInventory Agent options —<code>/server</code> and <code>--server</code>, <code>/ca-cert-dir</code> and <code>--ca-cert-dir</code>, <code>/no-category</code> and <code>--no-category</code>, etc.—, and that they are the only options used by <a href="#the-fusioninventory-agent-configuration"><em>FusionInventory Agent</em> configuration</a>. Please, visit the <a href="http://www.fusioninventory.org/documentation/agent/man/agent.cfg/">official documentation about FusionInventory Agent configuration</a> for more information.</p>
222
<dl>
223
<dt><code id="backend-collect-timeout">/backend-collect-timeout</code>=<em>timeout</em></dt>
224
<dd><p>Timeout for task <code>Inventory</code> modules execution. (By default: <code>180</code>)</p>
225
<p><em>timeout</em> is expressed in seconds.</p>
226
<blockquote>
227
<p><em>This option will be renamed to <code>/collect-timeout</code> in the next FIAWI v2.4.0</em></p>
228
</blockquote>
229
</dd>
230
<dt><code id="ca-cert-dir">/ca-cert-dir</code>=<em>pathname</em></dt>
231
<dd><p>Absolute path to the standard certificate directory <a href="#fn9" class="footnoteRef" id="fnref9"><sup>9</sup></a> of certificate authorities (CA). (By default: <code>''</code>)</p>
232
<p>The use of this option is incompatible with the use of the <a href="#ca-cert-file"><code>/ca-cert-file</code></a> option.</p>
233
</dd>
234
<dt><code id="ca-cert-file">/ca-cert-file</code>=<em>filename</em></dt>
235
<dd><p>Full path to the certificates file of certification authorities (CA). (By default: <code>''</code>)</p>
236
<p><em>filename</em> must be in PEM (Privacy Enhanced Mail) encoding and its extension must be <em>*.pem</em>. Also, <em>filename</em> can contain one or more certificates of certificate authorities. <a href="#fn10" class="footnoteRef" id="fnref10"><sup>10</sup></a></p>
237
<p>The use of this option is incompatible with the use of the <a href="#ca-cert-dir"><code>/ca-cert-dir</code></a> option.</p>
238
</dd>
239
<dt><code id="debug">/debug</code>=<em>level</em></dt>
240
<dd><p>Sets the debug level of the agent. (By default: <code>0</code>)</p>
241
<p><em>level</em> can be any of the following values:</p>
242
<blockquote>
243
<dl>
244
<dt><code>0</code></dt>
245
<dd>It records the basic process of FusionInventory Agent
246
</dd>
247
<dt><code>1</code></dt>
248
<dd>It records in depth the process of FusionInventory Agent
249
</dd>
250
<dt><code>2</code></dt>
251
<dd>It records communications of FusionInventory Agent with remote destinations (see <a href="#server"><code>/server</code></a>)
252
</dd>
253
<dt><code>3</code></dt>
254
<dd>It records additional traces for some external Perl libraries (as <em>Net::SSLeay</em> and others)
255
</dd>
256
</dl>
257
</blockquote>
258
<p>Note that higher values of <em>level</em> carry implicit the lower ones and that <em>level</em> <code>3</code> only has sense whether <a href="#logger"><code>/logger</code></a> is set to <code>Stderr</code>.</p>
259
</dd>
260
<dt><code id="delaytime">/delaytime</code>=<em>limit</em></dt>
261
<dd><p>Sets an initial delay before first contact with a remote destination (see <a href="#server"><code>/server</code></a>). This delay is calculated at random between <em>limit/2</em> and <em>limit</em> seconds. (Default: <code>3600</code>)</p>
262
<p>This option is ignored for remote destinations after the first contact with each one, in favor of the specific server parameter (<code>PROLOG_FREQ</code>).</p>
263
<p>The <code>/delaytime</code> option comes into play only if FusionInventory Agent runs in <em>server mode</em> (see <a href="#execmode"><code>/execmode</code></a>).</p>
264
<p><em>limit</em> is expressed in seconds.</p>
265
</dd>
266
<dt><code id="html">/html</code></dt>
267
<dd><p>Save the result of Inventory task as HTML instead of XML. (By default: <code>No</code>)</p>
268
<blockquote>
269
<p><em>This option will be deprecated in the next FIAWI v2.4.0</em></p>
270
</blockquote>
271
</dd>
272
<dt><code id="httpd">/httpd</code></dt>
273
<dd><p>This option is the opposite of <code>/no-httpd</code>. See <a href="#ho-httpd"><code>/no-httpd</code></a> for more information.</p>
274
</dd>
275
<dt><code id="httpd-ip">/httpd-ip</code>=<em>ip</em></dt>
276
<dd><p>IP address by which the embedded web server should listen. (By default: <code>0.0.0.0</code>)</p>
277
</dd>
278
<dt><code id="httpd-port">/httpd-port</code>=<em>port</em></dt>
279
<dd><p>IP port by which the embedded web server should listen. (By default: <code>62354</code>)</p>
280
</dd>
281
<dt><code id="httpd-trust">/httpd-trust</code>={<em>ip</em> | <em>range</em> | <em>hostname</em>}[,{<em>ip</em> | <em>range</em> | <em>hostname</em>}[…]]</dt>
282
<dd><p>Trusted IP addresses that do not require authentication token by the integrated web server. (By default: <code>127.0.0.1/32</code>)</p>
283
<p><em>ip</em> is an IP address in dot-decimal notation (ex. <code>'127.0.0.1'</code>) or in CIDR notation (ex. <code>'127.0.0.1/32'</code>)</p>
284
<p><em>range</em> is an IP address range in dot-decimal notation (ex. <code>'192.168.0.0 - 192.168.0.255'</code> or <code>'192.168.0.0 + 255'</code>) or in CIDR notation (ex. <code>'192.168.0.0/24'</code>)</p>
285
<p><em>hostname</em> is the name of a host (ex. <code>'itms.acme.org'</code>)</p>
286
<p>Bear in mind that <code>/httpd-trust</code> does not have to include the hostname part of those URIs that are set up in <a href="#server"><code>/server</code></a> because they are tacitly included. The following is an example; both configurations are equal.</p>
287
<blockquote>
288
<p><code>/httpd-trust='127.0.0.1/32,itms.acme.org'</code><br /><code>/server='http://itms.acme.org/glpi/plugins/fusioninventory/'</code></p>
289
<p><code>/httpd-trust='127.0.0.1/32'</code><br /><code>/server='http://itms.acme.org/glpi/plugins/fusioninventory/'</code></p>
290
</blockquote>
291
</dd>
292
<dt><code id="local">/local</code>=<em>pathname</em></dt>
293
<dd><p>Writes the results of tasks execution into the given directory. (By default: <code>''</code>)</p>
294
<p>You must indicate an absolute pathname or an empty string. If you indicate an empty string (<code>''</code>), the default value, the results of tasks execution will not be written locally.</p>
295
<p>You can use the /local and <a href="#server"><code>/server</code></a> options simultaneously.</p>
296
<blockquote>
297
<p><em>This option will be deprecated in the next FIAWI v2.4.0</em></p>
298
</blockquote>
299
</dd>
300
<dt><code id="logfile">/logfile</code>=<em>filename</em></dt>
301
<dd><p>Writes log messages into the file <em>filename</em>. (By default: <code>C:\Program Files\FusionInventory-Agent\fusioninventory-agent.log</code>)</p>
302
<p>You must indicate a full path in <em>filename</em>. The <a href="#local"><code>/local</code></a> option comes into play only if you have also indicated <code>File</code> as a value of the <a href="#loger"><code>/logger</code></a> option.</p>
303
</dd>
304
<dt><code id="logfile-maxsize">/logfile-maxsize</code>=<em>size</em></dt>
305
<dd><p>Sets the maximum size of <a href="#logfile"><code>logfile</code></a> to <em>size</em>. (By default: <code>16</code>)</p>
306
<p><em>size</em> is expressed in MBytes.</p>
307
</dd>
308
<dt><code id="logger">/logger</code>=<em>backend</em>[,<em>backend</em>]</dt>
309
<dd><p>Sets the logger backends. (By default: <code>File</code>)</p>
310
<p><em>backend</em> can be any of the following values:</p>
311
<blockquote>
312
<dl>
313
<dt><code>File</code></dt>
314
<dd>Sends the log messages to a file (see <a href="#logfile"><code>/logfile</code></a>)
315
</dd>
316
<dt><code>Stderr</code></dt>
317
<dd>Sends the log messages to the console
318
</dd>
319
</dl>
320
</blockquote>
321
</dd>
322
<dt><code id="no-category">/no-category</code>=<em>category</em>[,<em>category</em>[…]]</dt>
323
<dd><p>Do not inventory the indicated categories of elements. (By default: <code>''</code>)</p>
324
<p><em>category</em> can be any of the following values:</p>
325
<blockquote>
326
<dl>
327
<dt><code>Battery</code></dt>
328
<dd>Batteries
329
</dd>
330
<dt><code>Controller</code></dt>
331
<dd>Motherboard controllers
332
</dd>
333
<dt><code>CPU</code></dt>
334
<dd>Processors
335
</dd>
336
<dt><code>Drive</code></dt>
337
<dd>Unit drives
338
</dd>
339
<dt><code>Environment</code></dt>
340
<dd>Environment variables
341
</dd>
342
<dt><code>Input</code></dt>
343
<dd>Input devices (<em>keyboard</em>, <em>mouse</em>, <em>smart card reader</em>, <em>fingerprint scanner</em>, etc.)
344
</dd>
345
<dt><code>License</code></dt>
346
<dd>Software licenses
347
</dd>
348
<dt><code>Local_Group</code></dt>
349
<dd>User’s local groups
350
</dd>
351
<dt><code>Local_User</code></dt>
352
<dd>Local users
353
</dd>
354
<dt><code>LVM</code></dt>
355
<dd>Logic Volume Manager (has no effect on Microsoft Windows systems)
356
</dd>
357
<dt><code>Memory</code></dt>
358
<dd>Memory modules
359
</dd>
360
<dt><code>Modem</code></dt>
361
<dd>Modem devices
362
</dd>
363
<dt><code>Monitor</code></dt>
364
<dd>Monitors
365
</dd>
366
<dt><code>Network</code></dt>
367
<dd>Network devices
368
</dd>
369
<dt><code>Printer</code></dt>
370
<dd>Printers
371
</dd>
372
<dt><code>Process</code></dt>
373
<dd>System processes (has no effect on Microsoft Windows systems)
374
</dd>
375
<dt><code>Slot</code></dt>
376
<dd>Slots
377
</dd>
378
<dt><code>Software</code></dt>
379
<dd>Software
380
</dd>
381
<dt><code>Sound</code></dt>
382
<dd>Sound subsystem
383
</dd>
384
<dt><code>Storage</code></dt>
385
<dd>Storage subsystem
386
</dd>
387
<dt><code>USB</code></dt>
388
<dd>USB devices
389
</dd>
390
<dt><code>User</code></dt>
391
<dd>Users
392
</dd>
393
<dt><code>Video</code></dt>
394
<dd>Video devices
395
</dd>
396
<dt><code>VirtualMachine</code></dt>
397
<dd>Virtual machines
398
</dd>
399
</dl>
400
</blockquote>
401
<p>If you indicate an empty string (<code>''</code>), the default value, all categories of elements will be inventoried.</p>
402
</dd>
403
<dt><code id="no-html">/no-html</code></dt>
404
<dd><p>This option is the opposite of <code>/html</code>. See <a href="#html"><code>/html</code></a> for more information.</p>
405
<blockquote>
406
<p><em>This option will be deprecated in the next FIAWI v2.4.0</em></p>
407
</blockquote>
408
</dd>
409
<dt><code id="no-httpd">/no-httpd</code></dt>
410
<dd><p>Disables the embedded web server. (By default: <code>No</code>)</p>
411
</dd>
412
<dt><code>/no-p2p</code></dt>
413
<dd><p>Do not use peer to peer to download files. (By default: <code>No</code>)</p>
414
</dd>
415
<dt><code id="no-scan-homedirs">/no-scan-homedirs</code></dt>
416
<dd><p>This option is the opposite of <code>/scan-homedirs</code>. See <a href="#scan-homedirs"><code>/scan-homedirs</code></a> for more information.</p>
417
</dd>
418
<dt><code id="no-scan-profiles">/no-scan-profiles</code></dt>
419
<dd><p>This option is the opposite of <code>/scan-profiles</code>. See <a href="#scan-profiles"><code>/scan-profiles</code></a> for more information.</p>
420
</dd>
421
<dt><code id="no-ssl-check">/no-ssl-check</code></dt>
422
<dd><p>Do not check server certificate. (By default: <code>No</code>)</p>
423
</dd>
424
<dt><code id="no-task">/no-task</code>=<em>task</em>[,<em>task</em>[…]]</dt>
425
<dd><p>Disables the given tasks. (By default: <code>''</code>)</p>
426
<p><em>task</em> can be any of the following values:</p>
427
<blockquote>
428
<dl>
429
<dt><code>Deploy</code></dt>
430
<dd>Deploy task
431
</dd>
432
<dt><code>ESX</code></dt>
433
<dd>ESX task
434
</dd>
435
<dt><code>Inventory</code></dt>
436
<dd>Inventory task
437
</dd>
438
<dt><code>NetDiscovery</code></dt>
439
<dd>Network discovery task
440
</dd>
441
<dt><code>NetInventory</code></dt>
442
<dd>Network inventory task
443
</dd>
444
<dt><code>WakeOnLan</code></dt>
445
<dd>Wake on LAN task
446
</dd>
447
</dl>
448
</blockquote>
449
<p>If you indicate an empty string (<code>''</code>), the default value, all tasks will be executed.</p>
450
</dd>
451
<dt><code id="p2p">/p2p</code></dt>
452
<dd><p>This option is the opposite of <code>/no-p2p</code>. See <a href="#no-p2p"><code>/no-p2p</code></a> for more information.</p>
453
</dd>
454
<dt><code id="password">/password</code>=<em>password</em></dt>
455
<dd><p>Uses <em>password</em> as password for server authentication. (By default: <code>''</code>)</p>
456
<p>The <code>/password</code> option comes into play only if you have also indicated a value for the <a href="#server"><code>/server</code></a> option.</p>
457
</dd>
458
<dt><code id="proxy">/proxy</code>=<em>URI</em></dt>
459
<dd><p>Uses <em>URI</em> as HTTP/S proxy server. (By default: <code>''</code>)</p>
460
</dd>
461
<dt><code id="scan-homedirs">/scan-homedirs</code></dt>
462
<dd><p>Allows the agent to scan home directories for virtual machines. (By default: <code>No</code>)</p>
463
</dd>
464
<dt><code id="scan-profiles">/scan-profiles</code></dt>
465
<dd><p>Allows the agent to scan user profiles for software. (By default: <code>No</code>)</p>
466
</dd>
467
<dt><code id="server">/server</code>=<em>URI</em>[,<em>URI</em>[…]]</dt>
468
<dd><p>Sends results of tasks execution to given servers. (By default: <code>''</code>)</p>
469
<p>If you indicate an empty string (<code>''</code>), the default value, the results of tasks execution will not be written remotely.</p>
470
<p>You can use the <code>/server</code> and <a href="#local"><code>/local</code></a> options simultaneously.</p>
471
</dd>
472
<dt><code id="ssl-check">/ssl-check</code></dt>
473
<dd><p>This option is the opposite of <code>/no-ssl-check</code>. See <a href="#no-ssl-check"><code>/no-ssl-check</code></a> for more information.</p>
474
</dd>
475
<dt><code>/tag</code>=<em>tag</em></dt>
476
<dd><p>Marks the computer with the tag <em>tag</em> . (By default: <code>''</code>)</p>
477
</dd>
478
<dt><code id="timeout">/timeout</code>=<em>timeout</em></dt>
479
<dd><p>Sets the limit time (in seconds) to connect with the server. (By default: <code>180</code>)</p>
480
<p>The <code>/timeout</code> option comes into play only if you have also indicated a value for the <a href="#server"><code>/server</code></a> option.</p>
481
<p><em>timeout</em> is expressed in MBytes.</p>
482
</dd>
483
<dt><code id="user">/user</code>=<em>user</em></dt>
484
<dd><p>Uses <em>user</em> as user for server authentication. (By default: <code>''</code>)</p>
485
<p>The <code>/user</code> option comes into play only if you have also indicated a value for the <a href="#server"><code>/server</code></a> option.</p>
486
</dd>
487
</dl>
488
</div>
489
</div>
490
<div id="graphic-user-interface" class="section level1">
491
<h1>Graphic user interface</h1>
492
<p><em>ToDo</em></p>
493
</div>
494
<div id="the-fusioninventory-agent-configuration" class="section level1">
495
<h1>The <em>FusionInventory Agent</em> configuration</h1>
496
<p>This section describes where the FusionInventory Agent Windows Installer stores the FusionInventory Agent configuration and how to it is possible to change it.</p>
497
<p><em>ToDo</em></p>
498
</div>
499
<div id="version" class="section level1">
500
<h1>Version</h1>
501
<p>This help is current for version 2.2.9903 of FusionInventory Agent’s installer for Microsoft Windows.</p>
502
</div>
503
<div id="reporting-bugs" class="section level1">
504
<h1>Reporting bugs</h1>
505
<p>User Mailing List</p>
506
<p>http://lists.alioth.debian.org/mailman/listinfo/fusioninventory-user</p>
507
<p>Devel Mailing List</p>
508
<p>http://lists.alioth.debian.org/mailman/listinfo/fusioninventory-devel</p>
509
<p>Project Manager</p>
510
<p>http://forge.fusioninventory.org/projects/fusioninventory-agent-windows-installer</p>
511
</div>
512
<div id="authors" class="section level1">
513
<h1>Authors</h1>
514
<p>Tomás Abad Gómez-Pastrana &lt;tabadgp@gmail.com&gt;</p>
515
</div>
516
<div id="copyright" class="section level1">
517
<h1>Copyright</h1>
518
<p>Copyright 2012-2014 FusionInventory Team. <a href="http://www.gnu.org/licenses/old-licenses/gpl-2.0-standalone.html">GNU GPL version 2</a> or (at your option) any later version. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law.</p>
519
</div>
520
<div id="see-also" class="section level1">
521
<h1>See also</h1>
522
<p><a href="http://www.fusioninventory.org/" title="FusionInventory Web Site">FusionInventory</a> Web Site</p>
523
</div>
524
<div class="footnotes">
525
<hr />
526
<ol>
527
<li id="fn1"><p><em><code>fusioninventory-agent_windows-x64_2.3.11.exe</code></em> can only be installed on systems with 64bits (X86_64).<a href="#fnref1"></a></p></li>
528
<li id="fn2"><p>FusionInventory Agent Windows Installer is also known as FIAWI. The terms “FusionInventory Agent Windows Installer” or “FIAWI” will be used interchangeably.<a href="#fnref2"></a></p></li>
529
<li id="fn3"><p>FusionInventory Agent is also known as FIA. The terms “FusionInventory Agent” or “FIA” will be used interchangeably.<a href="#fnref3"></a></p></li>
530
<li id="fn4"><p>If a <em>from-current-config</em> installation has been specified, and FIAWI has not been able to detect a previous FIA installation, the installation type is automatically switched from <em>from-current-config</em> to <em>from-scratch</em>.<a href="#fnref4"></a></p></li>
531
<li id="fn5"><p><code>Service</code> mode is known also as <em>server mode</em>.<a href="#fnref5"></a></p></li>
532
<li id="fn6"><p><code>Task</code> mode is only available on Windows XP (or higher) and Windows Server 2003 (or higher) operating systems.<a href="#fnref6"></a></p></li>
533
<li id="fn7"><p><code>Current</code> mode changes its behaviour in the case of an installation <em>from-scratch</em> (see <a href="#installtype"><code>/installtype</code></a>). In that case, <code>Current</code> mode is a synonym of <code>Service</code>.<a href="#fnref7"></a></p></li>
534
<li id="fn8"><p>Options <a href="#httpd"><code>/httpd</code></a>, <a href="#no-html"><code>/no-html</code></a>, <a href="#no-scan-homedirs"><code>/no-scan-homedirs</code></a>, <a href="#no-scan-profiles"><code>/no-scan-profiles</code></a>, <a href="#p2p"><code>/p2p</code></a> and <a href="#ssl-check"><code>/ssl-check</code></a>.<a href="#fnref8"></a></p></li>
535
<li id="fn9"><p>A <em>standard certificate directory</em> 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 <em>subject</em> field, with extension <em>*.0</em>.</p>
536
<p>For example, if you want to include the certificate file <em>FICert_Class1.crt</em> in the directory <em>pathname</em>, you must calculate the hash value of the certificate’s <em>subject</em> field using, for example, OpenSSL</p>
537
<p>C:\OpenSSL&gt; openssl.exe x509 -in C:\FICert_Class1.crt -subject_hast -noout b760f1ce</p>
538
<p>and afterwards, move or copy the certificate file to the directory <em>pathname</em> with the name <em>b760f1ce.0</em>.</p>
539
<p>C:\OpenSSL&gt; move.exe C:\FICert_Class1.crt <em>pathname</em>\b760f1ce.0<a href="#fnref9"></a></p></li>
540
<li id="fn10"><p>To concatenate multiple certificate files into one file you can make use, for example, of the command <em>copy</em>.</p>
541
<p>C:\&gt; copy.exe FICert_Class1.crt+FICert_Class2.crt FICerts.pem<a href="#fnref10"></a></p></li>
542
</ol>
543
</div>
544
</body>
545
</html>