Skip to content

Latest commit

 

History

History
135 lines (98 loc) · 5.7 KB

README.md

File metadata and controls

135 lines (98 loc) · 5.7 KB
Raw

Banner

OCS Inventory UnixAgent

Some Links:
Ask question | Source installation | RPM/DEB installation | Website | OCS Professional

Ocsinventory-Agent is an agent for ocsinventory NG. It supports Linux, Solaris and AIX. *BSD support is in progress.

Prerequisites

- Perl 5.8 minimum

The following modules are needed:

- Digest::MD5
- XML::Simple
- Net::IP optional, it is only needed to compute the network information
- LWP
- Mac::SysProfile 0.0.5 : this module is need on MacOSX to collect the device informations.
- To get SSL communications working (for packages deployment or HTTPS communications to OCS server), you need these modules:
  - Crypt::SSLeay if you use LWP prior to version 6
  - LWP::Protocol::https if you use LWP version 6 or more
- Net::CUPS is used to detect the printer
- Net::SNMP to scan network devices using SNMP
- To enhance SNMP feature with custom networks scans, you need these modules:
  - Net::Netmask
  - Net::Ping or Nmap::Parser
- Data::UUID is used to create a unique id for every machine
- Parse::EDID is used to inventory monitor and will replace monitor-edid from Mandriva.

The following commands are needed:

- dmidecode on Linux and *BSD (i386, amd64, ia64) => dmidecode is required to read the BIOS stats.
- lspci on Linux and *BSD (pciutils package) => lspci is required to list PCI devices.
- 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)
- 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 available in Fedora repository. information http://wiki.mandriva.com/en/Tools/monitor-edid
  - get-edid from the read-edid package
- ipmitool if you want to collect information about IPMI
- Nmap (v3.90 or superior) to scan network devices for Ipdiscover

The following PERL modules are optional:

- Proc::Daemon Daemon mode
- Proc::PID::File brings the pid file support if Proc::Daemon is installed
- Compress::Zlib

The following module is needed if you plan to prepare a tarball or install directly from the Bazaar devel branch. (See SOURCES below.):

- Module::Install

Build / Install

Once the archive is unpacked, use these commands:

perl Makefile.PL
make
make install

If you want to turn off the interactive post install script, just do (instead of perl Makefile.PL)

PERL_AUTOINSTALL=1 perl Makefile.PL

You can also run the agent from the tarball directory. In this case, use the --devlib flag to load the library from the local directory.

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

Ex: ocsinventory-agent -l /tmp --debug

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

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

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 your $PATH variable according to that.

Crontab:

  • If you use 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 beginning of the cron file.

Contributing

  1. Fork it!
  2. Create your feature branch: git checkout -b my-new-feature
  3. Add your changes: git add folder/file1.php
  4. Commit your changes: git commit -m 'Add some feature'
  5. Push to the branch: git push origin my-new-feature
  6. Submit a pull request !

License

OCS Inventory is GPLv2 licensed

The memconf script is maintained by Tom Schmidt http://www.4schmidts.com/memconf.html Copyright © 1996-2017 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.

Ocsinventory::Agent::Backend::OS::Linux::Storages::Adaptec uses code from Parse-Arcconf:

https://github.com/kumy/Parse-Arcconf

License and Copyright: Copyright (C) 2012 Mathieu Alorent

This program is free software; you can redistribute it and/or modify it under the terms of either: the GNU General Public License as published by the Free Software Foundation; or the Artistic License. See http://dev.perl.org/licenses/ for more information.