Cactidocumentation/Devices.md

Device Management

This section will describe Device management in Cacti.

Adding a device to Cacti can be done in a few differnt ways either via the GUI,Automation,CLI

GUI option

To add a device via the gui first click on Console >> Managment >> Devices

you will see the below device console window which will show exisiting devices if any

You will now select the + on the top right hand corner

Once you select the + otherwise known as the add device button you will see the below screen which will ask you for device specific information

Some of the most important information about the device will be required in this window which includes -Device Name -IP/Hostname -Template i.e Cisco,Linux etc -SNMP information -Device Notes

Cacti requires this basic information to be able to monitor the device once you have entered the basic information click save on the bottom right corner The device is now created you will need to add graphs for the device which can be done by clicking Create graphs for this device on the top right hand corner. to see more information about Graph creation see .....

Creating devices via cli script

You can also create device by using the cli script located at /cactidir/cli/

usage: add_device.php --description=[description] --ip=[IP] --template=[ID] [--notes="[]"] [--disable]
    [--poller=[id]] [--site=[id] [--external-id=[S]] [--proxy] [--threads=[1]
    [--avail=[ping]] --ping_method=[icmp] --ping_port=[N/A, 1-65534] --ping_timeout=[N] --ping_retries=[2]
    [--version=[0|1|2|3]] [--community=] [--port=161] [--timeout=500]
    [--username= --password=] [--authproto=] [--privpass= --privproto=] [--context=] [--engineid=]
    [--quiet]

Required:
    --description  the name that will be displayed by Cacti in the graphs
    --ip           self explanatory (can also be a FQDN)

To add a device using the bare minimum information would look something like this

bmfmancini@localhost:/var/www/html/cacti/cli$ php add_device.php --description=test --ip=192.168.1.15
Adding test (192.168.1.15) as "Cacti Stats" using SNMP v3 with community "public"
Success - new device-id: (45)
bmfmancini@localhost:/var/www/html/cacti/cli$

---

Copyright (c) 2004-2019 The Cacti Group