Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ocsinventory-ng/unixagent

This is the OCS unified agent for Unix operating systems
https://github.com/ocsinventory-ng/unixagent

agent deployment ocs ocs-deployment ocs-inventory ocsinventory unix

Last synced: 1 day ago
JSON representation

This is the OCS unified agent for Unix operating systems

Host: GitHub
URL: https://github.com/ocsinventory-ng/unixagent
Owner: OCSInventory-NG
License: gpl-2.0
Created: 2015-06-02T13:29:00.000Z (over 9 years ago)
Default Branch: master
Last Pushed: 2024-10-21T09:10:55.000Z (2 months ago)
Last Synced: 2024-10-21T12:57:46.464Z (2 months ago)
Topics: agent, deployment, ocs, ocs-deployment, ocs-inventory, ocsinventory, unix
Language: Perl
Homepage: http://www.ocsinventory-ng.org/en/
Size: 29.3 MB
Stars: 89
Watchers: 26
Forks: 84
Open Issues: 17
Metadata Files:
- Readme: README.md
- Changelog: Changes
- Contributing: .github/Contributing.md
- License: LICENSE
- Authors: AUTHORS

Awesome Lists containing this project

README

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

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

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

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.