Most of the options are available in a short form and a long form. For example, the two lines below are
all equivalent:
% ocsinventory-agent -s localhost
% ocsinventory-agent --server localhost
--backend-collect-timeout=SECONDS_BEFORE_KILL
Time before OCS kills modules processing which don't end before the timeout.
--basevardir=DIR
Indicate the place where the agent should store its files.
-d, --daemon
Launch ocsinventory-agent in background. Proc::Daemon is needed.
--debug
Turn the debug mode on.
--devlib
This option is designed for backend module developer. With it enabled, ocsinventry-agent won't try to
load the Backend module installed on the system. Instead it will scan the ./lib directory.
--delaytime=SECONDS_TO_WAIT
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 will first contact the server during the PROLOG period. If the server doesn't know the
machine or has outdated information, it will ask for an inventory. With this option, the agent
doesn't run the PROLOG with the server first but directly sends an inventory.
-i, --info
Turn the verbose mode on. The flag is ignored if --debug is enable.
--lazy
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.
--logfile=FILE
Log message in FILE and turn off STDERR
-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.
-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:
% http://servername/ocsinventory
If you want to use https or another virtual directory you need to enter the full path.
--server is ignored if --local is in use.
--stdout
Print the inventory on stdout.
% ocsinventory-agent --stdout > /tmp/report.xml
# prepare an inventory and write it in the /tmp/report.xml file.
# A file will be created.
--scan-homedirs
Authorized OCS to scan home directories to increase the Virtual Machine inventory. WARNING: beware
with user privacy by using this option because it may encounter private data scans (even if it's not
designed for !).
--ssl=0|1
Check SSL communications using a certificate. Set to 0 if you want to disable certificate check or 1
to enable (needs CA certificates file path in this case) . Default is set to 1.
--ca=FILE
Path to CA certificates file in PEM format, for server SSL certificate validation. Set to <your
server configuration directory>/cacert.pem by default.
--tag=TAG
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.
-uUSER, --user=USER
Use USER for the server authentication.
--version=USER
Print the version and exit.
-wDURATION, --wait=DURATION
Wait before initializing the connexion with the server. If DURATION equal server the agent will use
the PROLOG_FREQ of the server to determine the duration of this periode. Exactly like it would had
done if it was in --daemon mode. Else if duration is a numerical value, it will be used directly.
% ocsinventory-agent --wait 5 --server localhost
--nosoftware
Do not inventory the software installed on the machine. --nosoft also works but is deperecated.
--nolocal
Deactivate local mode even if it is set in config file or command line
Install Now
PNG Icons
