Skip to content

Repository to store sysobject.ids file, used for snmp network discovery

License

Notifications You must be signed in to change notification settings

glpi-project/sysobject.ids

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

sysobject.ids

This repository handles the GLPI Agent sysobject.ids file database.

The sysobject.ids file database is a text-based file firstly intended to help to identify network products based on their exposed SNMP values.

Documentation

The sysobject.ids file format is documented in GLPI Agent IDS Databases documentation.

Contribution

Feel free to open an issue if you have any product supporting SNMP and you want to be discovered and inventoried by GLPI Agent NetDiscovery and NetInventory tasks.

The sysobject.ids file is a text database mapping the SysObjectID snmp variable (.1.3.6.1.2.1.1.2) with manufacturer, type and model. It may also map to dedicated external module which can help to handle more complex case.

You can help populating the database by providing the output of following command (if available under linux, or any snmp walk more complete output):

# snmpget -v2c -c public "serverIP" 1.3.6.1.2.1.1.2.0

The following one, from a computer with GLPI Agent installed, can also quickly help us:

# glpi-netinventory --credentials version:2c,community:public --debug --host "serverIP"

As with the SysObjectID snmp variable content, you should provide the device related and expected manufacturer, type and model strings.

The device type can be one of the following types:

  • NETWORKING
  • PRINTER
  • STORAGE

The following types could be set but are not supported on server-side, so they should not be used:

  • COMPUTER
  • POWER
  • PHONE
  • VIDEO
  • KVM

In the case you want to fix a model or a manufacturer which seems wrongly set to you, please justify your request as sometime manufacturer uses a generic sysObjectID OID. In that case, you may also want to open a GLPI Agent issue to request we add a better support for such generic OID with a dedicated MIBSupport plugin.

You can also open a pull request after you have manually updated yourself your sysobject.ids file. When editing manually sysobject.ids file, always use tabulation as field separator or your entry won't even be read as expected. Before submitting, also check to add the entry at the right place to keep a numerically ordered list of supported OIDs.

Release

As GLPI Agent would be released we will tag the incorporated sysobject.ids file starting with 1.0.

Manual update

You can manually update sysobject.ids file into the installed glpi-agent/share folder. You just have to download it, but do that at your own risk and always make a backup before updating manually.

About

Repository to store sysobject.ids file, used for snmp network discovery

Topics

Resources

License

Stars

Watchers

Forks

Languages

  • Makefile 100.0%