FUSIONI...VENTORY(1p)

πŸ“¦
version 2.6 Β· 3 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

πŸ’– fusioninventory-netinventory(1p) πŸ’–

okay bestie, sit down, hydrate, because we're about to learn the standalone network inventory tool and honestly? it ate. ✨

this is a User Contributed Perl Documentation page for the 1p manual section, and it's literally your girl fusioninventory-netinventory. no GLPI server required, we're going rogue (respectfully). πŸ¦‹


✨ NAME ✨

fusioninventory-netinventory β€” Standalone network inventory πŸ’…


🌸 SYNOPSIS 🌸

fusioninventory-netinventory [options] [--host <host>|--file <file>]

  Options:
    --host <HOST>          target host
    --port <PORT[,PORT2]>  SNMP port (161)
    --protocol <PROT[,P2]> SNMP protocol/domain (udp/ipv4)
    --file <FILE>          snmpwalk output file
    --community <STRING>   community string (public)
    --credentials <STRING> SNMP credentials (version:1,community:public)
    --timeout <TIME>       SNMP timeout, in seconds (15)
    --type <TYPE>          force device type
    --threads <COUNT>      number of inventory threads (1)
    --control              output control messages
    --debug                debug output
    -h --help              print this message and exit
    --version              print the task version and exit

like, yes, that's the whole vibe check in one code block. copy it, don't touch it, it's perfect. πŸŽ€


πŸ’œ DESCRIPTION πŸ’œ

fusioninventory-netinventory can be used to run a network inventory task without a GLPI server.

that's it. that's the pitch. no server, no problem, main character energy. πŸ‘‘


🫢 OPTIONS 🫢

  • --host HOST β€” run an online inventory against the given host. you can use this multiple times if you've got multiple hosts, because why settle for one. ✨
  • --port PORT[,PORT2] β€” the list of ports to try, and it defaults to: 161

set it to 161,16100 to first try the default port and then try 16100. yes, it tries them in order, it's polite like that. πŸ’–

  • --protocol PROTOCOL[,PROTOCOL2] β€” the list of protocols to try, defaulting to: udp/ipv4

possible values are: udp/ipv4,udp/ipv6,tcp/ipv4,tcp/ipv6 β€” pick your fighter. 🌈

  • --file FILE β€” run an offline inventory against snmpwalk output stored in the given file. multiple usage allowed, for multiple files. ngl this is the cozy offline mode. πŸ“
  • --communty STRING β€” use the given string as the SNMP community (this assumes SNMPv1).
bestie, real talk: the flag is spelled --communty in this manual, missing an i, and no we are not fixing it. it's iconic, it's canon, we leave it exactly as written. don't come for me. πŸ™ˆ
  • --credentials STRING β€” use the given string as an SNMP credentials specification. this spec is a comma-separated list of key:value authentication parameters, such as:
    • version:2c,community:public
    • version:3,username:admin,authprotocol:sha,authpassword:s3cr3t
    • etc.

the way that's just a little config language inside one flag… obsessed. πŸ’…

  • --timeout TIME β€” set the SNMP timeout, in seconds. no default listed here in the options, but the synopsis above says (15), so. you know. iykyk. ⭐
  • --type TYPE β€” force the device type instead of letting it do its little automatic identification thing. currently allowed types are:
    • COMPUTER
    • NETWORKING
    • PRINTER
    • STORAGE
    • POWER
    • PHONE

pick one, be decisive, slay. πŸ”₯

  • --threads count β€” use the given number of inventory threads. parallelize, queen. 🌸
  • --control β€” output server-agent control messages in addition to the inventory result itself. bonus content fr fr. 😭
  • --debug β€” turn debug mode on. multiple usage allowed, for additional verbosity. yes you can stack it. yes that's a little unhinged. no you don't have to. πŸ’€

🧚 EXAMPLES 🧚

run an inventory against a network device, using SNMP version 2c authentication:

$> fusioninventory-netinventory --host 192.168.0.1 \
--credentials version:2c,community:public

run an inventory against a network device, using SNMP version 3 authentication and forcing its type:

$> fusioninventory-netinventory --host my.device --type NETWORKING \
--credentials version:3,username:admin,authprotocol:sha,authpassword:s3cr3t

look at those backslashes. look at that indentation. immaculate. no cap. πŸŽ€βœ¨


okay so that's genuinely everything, bestie. go inventory something. πŸ’–

this page was brought to you by perl v5.38.2 and dated 2024-05-15, and yes that's your footer energy, we're mentioning it here instead of copying a boring line at the bottom. bye bestie!! πŸ‘‘πŸ¦‹πŸŒˆ

πŸ“¦ where this page comes from