mirror of
https://github.com/librenms/librenms.git
synced 2024-10-07 16:52:45 +00:00
VVelox
06b85f5b07
* clean 1-Minute-Polling.md formatting * cleanup formatting for Adding-a-Device.md * clean up formatting of Cleanup-options.md * cleanup formatting some for CLI-Tools.md * cleanup formatting for Syslog.md and Configuration.md * cleanup formatting for Device-Sensors.md * cleanup formatting for Device-Troubleshooting.md * cleanup Discovery Support.md * cleanup Environment-Variables.md * cleanup Example-Hardware-Setup.md and FAQ.mg * update Features.md, Install Validation.md, Perfermance.md, Poller Support.md, and index.md * cleanup Remote-Monitoring-VPN.md, SNMP-Configuration-Examples.md, and SSL-Configuration.md * lots of updates for Installation docs * more installation doc cleanup * more formatting cleanup * clean Work-Map.md up some
60 lines
1.8 KiB
Markdown
60 lines
1.8 KiB
Markdown
source: Support/Adding-a-Device.md
|
|
path: blob/master/doc/
|
|
|
|
# Adding Device
|
|
|
|
You have two options for adding a new device into LibreNMS. You can
|
|
add a device via the `cli` or by using the `WebUI`.
|
|
|
|
## CLI
|
|
|
|
Using the command line via ssh you can add a new device by changing to
|
|
the directory of your LibreNMS install and typing (be sure to put the
|
|
correct details).
|
|
|
|
```bash
|
|
./addhost.php yourhostname [community] [v1|v2c] [port] [udp|udp6|tcp|tcp6]
|
|
```
|
|
|
|
As an example, if your device with the name `mydevice.example.com` is
|
|
configured to use the community `my_company` using snmp `v2c` then you
|
|
would enter:
|
|
|
|
```bash
|
|
./addhost.php mydevice.example.com my_company v2c
|
|
```
|
|
|
|
> Please note that if the community contains special characters such
|
|
> as `$` then you will need to wrap it in `'`. I.e: `'Pa$$w0rd'`.
|
|
|
|
## WebUI
|
|
|
|
Using the web interface, go to Devices and click Add Device. Enter the
|
|
details required for the device that you want to add and then click
|
|
'Add Host'. As an example, if your device is configured to use the
|
|
community `my_company` using snmp `v2c` then you would enter: SNMP
|
|
Port defaults to 161
|
|
|
|
|
|
|
|
### Ping Only Device
|
|
|
|
You can add ping only devices into LibreNMS through the WebUI. When
|
|
adding the device switch the SNMP button to "off". Device will be
|
|
added into LibreNMS as Ping Only Device and will show ICMP Response Graph.
|
|
|
|
- Hostname: IP address or DNS name.
|
|
- Hardware: Optional you can type in whatever you like.
|
|
- OS: Optional this will add the Device's OS Icon.
|
|
|
|
[How to add ping only devices](https://youtu.be/cjuByubg-uk)
|
|
|
|
|
|
|
|
If you would like to add devices automatically then you will probably
|
|
want to read the [Auto-discovery
|
|
Setup](../Extensions/Auto-Discovery.md) guide.
|
|
|
|
You may also want to add devices programatically, if so, take a look
|
|
at our [API documentation](../API/index.md)
|