DESCRIPTION

Ocsinventory-Agent is an agent for ocsinventory NG. It supports Linux, Solaris and AIX. *BSD support is in progress. A port to non UNIX system is also possible (e.g: Win32).

PREREQUISITES

Perl 5.8.
Those modules are needed:
Digest::MD5

XML::Simple

Net::IP: optional, it is only needed to compute the network information

LWP

dmidecode on Linux and *BSD (i386, amd64, ia64) dmidecode is required to read the BIOS stats.

lspci on Linux and *BSD (pciutils package) is required to list PCI devices.

Mac::SysProfile 0.0.3 is need on MacOSX to collect the device informations.

sneep on Solaris/sparc, you must install sneep and record the Serial Number with it :

(download it from http://www.sun.com/download/products.xml?id=4304155a)

Those modules are optional

Proc::Daemon Daemon mode

Proc::PID::File brings the pid file support if Proc::Daemon is installed

ipmitoolif you want to collect information about IPMI

Compress::Zlib needed for OCS server prior 1.02

To get the serial number of the screen you will need one of these tools:

• monitor-edid from Mandriva is needed to fetch the monitor. A package is avalaible in Fedora repository. information http://wiki.mandriva.com/en/Tools/monitor-edid
• get-edid from the read-edid package

If avalaible, Net::CUPS is used to detect the printer

BUILDING/INSTALLING

Once the archive is unpacked, use these commands:

      perl Makefile.PL
      make
      make install

You can also run the agent from the tarball directory.

The agent needs some directories to store internal settings.

mkdir -p /etc/ocsinventory-agent
mkdir -p /var/lib/ocsinventory-agent mkdir -p /var/log/ocsinventory-agent mkdir -p /var/run

you can choose other directories by changing the default settings directly in the ocsinventory-agent file.

You need to launch the agent with root privilege. For debugging you can try to launch it with the -l flag:
eg: ocsinventory-agent -l /tmp --debug

It's also possible to run directly from the tarball directory:

sudo ./ocsinventory-agent --devlib --server http://foo/ocsinventory

PATCHES
If you want to improve OCS Inventory, please use the Bazaar branch directly, publish you changes and ask for the merge http://wiki.ocsinventory-ng.org/index.php/Developers:Bazaar

The source of the agent can be download with this command:

bzr branch lp:ocsinventory-unix-agent

NOTE

Solaris

Sun Studio seems to be needed to build the dependency. The generated Makefile needs gmake to be exectuted The default installation will install the binary in /usr/perl5/5.XXXXX/bin, set you $PATH variable according to that.

Crontab

If you use the crontab to launch the agent you'll probably have to redefine the PATH. For example, just add something like: PATH=/usr/local/sbin:/usr/local/bin:/sbin:/bin:/usr/sbin:/usr/bin At the begining of the cron file.

SOURCES
You can prepare a tarball from the Bazaar devel branch with those commands:

bzr branch lp:ocs-unix-agent
cd ocs-unix-agent
perl Makefile.PL
make manifest
make dist

COPYRIGHT

Copyright © 2006-2009 OCS Inventory Contributor released under GNU GPL 2 license

AUTHORS
See AUTHORS file.

The memconf script is maintained by Tom Schmidt http://myweb.cableone.net/4schmidts/memconf.html Copyright © 1996-2009 Tom Schmidt

memconf 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.

Ocsinventory::Agent::Backend::Virtualization::Vmsystem uses code from imvirt:

Authors

Thomas Liske <liske@ibh.de>

Copyright Holder:
2008 (C) IBH IT-Service GmbH [http://www.ibh.de/]

License

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 package; if not, write to the Free Software
     Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301
     USA