ocsinventory-agent.1p

Langue: en

Version: 2008-11-23 (ubuntu - 07/07/09)

Section: 1 (Commandes utilisateur)

NAME

ocsinventory-agent - Unified client for OCS-Inventory

SYNOPSIS

ocsinventory-agent-fhilpruw ] [ --server server | --local /tmp ]...

EXAMPLES

     % ocsinventory-agent --server localhost
     # sent an inventory to the OCS server
     
     % ocsinventory-agent --server http://localhost/ocsinventory2
     # sent an inventory over http to a server with a non standard
     # virtual directory
 
     % ocsinventory-agent --server https://localhost/ocsinventory
     # sent an inventory over https to the OCS server
 
     % ocsinventory-agent --local /tmp
     # write an inventory in the /tmp directory
     
     % ocsinventory-agent --server localhost --user=toto --password=pw --realm="Restricted Area"
     # send a report to a server protected by a basic authentification 
     % ocsinventory-agent --lazy
     # send an inventory only if the a random delay between 0 and PROLOG_FREQ had been run over. Usefull for package maintainer.
 
 

DESCRIPTION

ocsinventory-agent creates inventory and sent or write them. This agent is the successor of the former linux_agent which was release with OCS 1.01 and prior. It also replaces the Solaris/AIX/BSD unofficial agents. It supports the following operating systems:
Linux 2.4 and 2.6
any distribution on x86, x86_64/AMD64, Sparc64, ARM and PowerPC. Other architectures may work.
Solaris
tested on Solaris 8, 9 and 10 (x86 and Sparc)
FreeBSD
x86 and Sparc
NetBSD
x86 and Sparc
OpenBSD
x86 and Sparc
AIX
tested on AIX 5.1, 5.2 and 5.3 (PPC)

OPTIONS

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
 
 
--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.
-f, --force
The agent will first contact the server during the PROLOG period. If the server doesn't know the machin or have outdated information, it will ask for an inventory. With this option, the agent doesn't run the PROLOG with the server first but directly send 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. This option is useful for package. Thanks to it they can start the script regulary from the crontab.
-l, --local=DIR
Write an inventory in the DIR directory. A new file will be created if needed.
--logfile=FILE
Log message in FILE.
-p, --password=PASSWORD
Use PASSWORD for an HTTP identification with the server.
-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.
 
 
--tag=TAG
Mark the machin 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.
-u USER, --user=USER
Use USER for the server authentification.
--version=USER
Print the version and exit.
-w DURATION, --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
 
 
--nosoft
Do not inventory the software installed on the machin.

AUTHORS

Goneri LE BOUDER (maintainer), Pascal DANEK, Olivier ANDREOTTI, Thierry LACOSTE, Didier LIROULET

SEE ALSO

OCS-Inventory website,
  http://www.ocsinventory-ng.org/
 
 
forum,
  http://forums.ocsinventory-ng.org/
 
 
and wiki
  http://wiki.ocsinventory-ng.org/
 
 

BUGS

Please, use the forum as much as possible. You can send your patches to <goneri@rulezlan.org>. Copyright (C) 2006 2007 GonA~Xri LE BOUDER <goneri@rulezlan.org>

Copyright (C) 2005 2006 Pascal DANEK <pascal@ocsinventory-ng.org>

Copyright (C) 2007 Olivier ANDREOTTI <olivier.andreotti@gmail.com>

Copyright (C) 2007 Thierry LACOSTE <lacoste@univ-paris12.fr>

Copyright (C) 2007 Didier LIROULET <dliroulet@users.sourceforge.net>

  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
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  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
 
 

POD ERRORS

Hey! The above document had some coding errors, which are explained below:
Around line 541:
You forgot a '=back' before '=head1'
Around line 633:
You forgot a '=back' before '=head1'
Around line 639:
'=item' outside of any '=over'
Around line 651:
You forgot a '=back' before '=head1'