admin/cacti
1
0 Fork 0
mirror of https://github.com/Cacti/cacti.git synced 2026-10-27 15:17:05 +09:00
Code Issues Packages Projects Releases Wiki Activity
Files
main
cacti/cli/add_device.php
T

528 lines
15 KiB
PHP
Executable File
Raw Permalink Blame History

#!/usr/bin/env php
<?php
/*
+-------------------------------------------------------------------------+
| Copyright (C) 2004-2023 The Cacti Group |
| |
| 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. |
| |
| This program is distributed in the hope that it will be useful, |
| but WITHOUT ANY WARRANTY; without even the implied warranty of |
| MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
| GNU General Public License for more details. |
+-------------------------------------------------------------------------+
| Cacti: The Complete RRDtool-based Graphing Solution |
+-------------------------------------------------------------------------+
| This code is designed, written, and maintained by the Cacti Group. See |
| about.php and/or the AUTHORS file for specific developer information. |
+-------------------------------------------------------------------------+
| http://www.cacti.net/ |
+-------------------------------------------------------------------------+
*/
require(__DIR__ . '/../include/cli_check.php');
require_once($config['base_path'] . '/lib/api_automation_tools.php');
require_once($config['base_path'] . '/lib/api_device.php');
require_once($config['base_path'] . '/lib/api_data_source.php');
require_once($config['base_path'] . '/lib/api_graph.php');
require_once($config['base_path'] . '/lib/api_tree.php');
require_once($config['base_path'] . '/lib/data_query.php');
require_once($config['base_path'] . '/lib/poller.php');
require_once($config['base_path'] . '/lib/snmp.php');
require_once($config['base_path'] . '/lib/template.php');
require_once($config['base_path'] . '/lib/utility.php');
/* switch to main database for cli's */
if ($config['poller_id'] > 1) {
db_switch_remote_to_main();
}
/* process calling arguments */
$parms = $_SERVER['argv'];
array_shift($parms);
if (cacti_sizeof($parms)) {
/* setup defaults */
$description = '';
$ip = '';
$poller_id = $config['poller_id'];
$site_id = read_config_option('default_site');
$template_id = read_config_option('default_template');
$community = read_config_option('snmp_community');
$snmp_ver = read_config_option('snmp_version');
$disable = 0;
$notes = '';
$location = '';
$external_id = '';
$snmp_username = read_config_option('snmp_username');
$snmp_password = read_config_option('snmp_password');
$snmp_auth_protocol = read_config_option('snmp_auth_protocol');
$snmp_priv_passphrase = read_config_option('snmp_priv_passphrase');
$snmp_priv_protocol = read_config_option('snmp_priv_protocol');
$snmp_context = '';
$snmp_engine_id = '';
$snmp_port = read_config_option('snmp_port');
$snmp_timeout = read_config_option('snmp_timeout');
$avail = 1;
$ping_method = read_config_option('ping_method');
$ping_port = read_config_option('ping_port');
$ping_timeout = read_config_option('ping_timeout');
$ping_retries = read_config_option('ping_retries');
$max_oids = read_config_option('max_get_size');
$bulk_walk_size = -1;
$proxy = false;
$device_threads = read_config_option('device_threads');;
$displayHostTemplates = false;
$displayCommunities = false;
$quietMode = false;
foreach($parms as $parameter) {
if (strpos($parameter, '=')) {
list($arg, $value) = explode('=', $parameter);
} else {
$arg = $parameter;
$value = '';
}
switch ($arg) {
case '-d':
$debug = true;
break;
case '--description':
$description = trim($value);
break;
case '--ip':
$ip = trim($value);
break;
case '--template':
$template_id = $value;
break;
case '--community':
$community = trim($value);
break;
case '--version':
if (cacti_sizeof($parms) == 1) {
display_version();
exit(0);
} else {
$snmp_ver = trim($value);
}
break;
case '--notes':
$notes = trim($value);
break;
case '--location':
$location = trim($value);
break;
case '--site':
$site_id = trim($value);
break;
case '--poller':
$poller_id = trim($value);
break;
case '--disable':
$disable = $value;
break;
case '--external-id':
$external_id = $value;
break;
case '--username':
$snmp_username = trim($value);
break;
case '--password':
$snmp_password = trim($value);
break;
case '--authproto':
$snmp_auth_protocol = trim($value);
break;
case '--privproto':
$snmp_priv_protocol = trim($value);
break;
case '--privpass':
$snmp_priv_passphrase = trim($value);
break;
case '--context':
$snmp_context = trim($value);
break;
case '--engineid':
$snmp_engine_id = trim($value);
break;
case '--port':
$snmp_port = $value;
break;
case '--proxy':
$proxy = true;
break;
case '--timeout':
$snmp_timeout = $value;
break;
case '--ping_timeout':
$ping_timeout = $value;
break;
case '--threads':
$device_threads = $value;
break;
case '--avail':
switch($value) {
case 'none':
$avail = '0'; /* tried to use AVAIL_NONE, but then preg_match fails on validation, sigh */
break;
case 'ping':
$avail = AVAIL_PING;
break;
case 'snmp':
$avail = AVAIL_SNMP;
break;
case 'pingsnmp':
$avail = AVAIL_SNMP_AND_PING;
break;
case 'pingorsnmp':
$avail = AVAIL_SNMP_OR_PING;
break;
default:
print "ERROR: Invalid Availability Parameter: ($value)\n\n";
display_help();
exit(1);
}
break;
case '--ping_method':
switch(strtolower($value)) {
case 'icmp':
$ping_method = PING_ICMP;
break;
case 'tcp':
$ping_method = PING_TCP;
break;
case 'udp':
$ping_method = PING_UDP;
break;
default:
print "ERROR: Invalid Ping Method: ($value)\n\n";
display_help();
exit(1);
}
break;
case '--ping_port':
if (is_numeric($value) && ($value > 0)) {
$ping_port = $value;
} else {
print "ERROR: Invalid Ping Port: ($value)\n\n";
display_help();
exit(1);
}
break;
case '--ping_retries':
if (is_numeric($value) && ($value > 0)) {
$ping_retries = $value;
} else {
print "ERROR: Invalid Ping Retries: ($value)\n\n";
display_help();
exit(1);
}
break;
case '--max_oids':
if (is_numeric($value) && ($value > 0)) {
$max_oids = $value;
} else {
print "ERROR: Invalid Max OIDS: ($value)\n\n";
display_help();
exit(1);
}
break;
case '--bulk_walk':
if (is_numeric($value) && $value >= -1 && $value != 0) {
$bulk_walk_size = $value;
} else {
print "ERROR: Invalid Bulk Walk Size: ($value)\n\n";
display_help();
exit(1);
}
case '--version':
case '-V':
case '-v':
display_version();
exit(0);
case '--help':
case '-H':
case '-h':
display_help();
exit(0);
case '--list-communities':
$displayCommunities = true;
break;
case '--list-host-templates':
$displayHostTemplates = true;
break;
case '--quiet':
$quietMode = true;
break;
default:
print "ERROR: Invalid Argument: ($arg)\n\n";
display_help();
exit(1);
}
}
if ($displayCommunities) {
displayCommunities($quietMode);
exit(0);
}
if ($displayHostTemplates) {
displayHostTemplates(getHostTemplates(), $quietMode);
exit(0);
}
/* process the various lists into validation arrays */
$host_templates = getHostTemplates();
$hosts = getHostsByDescription();
$addresses = getAddresses();
/* process templates */
if (!isset($host_templates[$template_id])) {
print "ERROR: Unknown template id ($template_id)\n";
exit(1);
}
/* process host description */
if (isset($hosts[$description])) {
db_execute("UPDATE host SET hostname='$ip' WHERE deleted = '' AND id=" . $hosts[$description]);
print "This host already exists in the database ($description) device-id: (" . $hosts[$description] . ")\n";
exit(1);
}
if ($description == '') {
print "ERROR: You must supply a description for all hosts!\n";
exit(1);
}
if ($ip == '') {
print "ERROR: You must supply an IP address for all hosts!\n";
exit(1);
}
if ($snmp_ver > 3 || $snmp_ver < 0 || !is_numeric($snmp_ver)) {
print "ERROR: The snmp version must be between 0 and 3. If you did not specify one, goto Configuration > Settings > Device Defaults and resave your defaults.\n";
exit(1);
}
/* process ip */
if (isset($addresses[$ip])) {
$id = $addresses[$ip];
$phost = db_fetch_row_prepared('SELECT * FROM host WHERE id = ?', array($id));
$fail = false;
if ($phost['snmp_version'] < '3' && $snmp_ver < '3') {
if ($snmp_ver == 0 && $proxy) {
// proxy but for no snmp
} elseif ($phost['snmp_community'] != $community || $phost['snmp_port'] != $snmp_port) {
if ($proxy) {
// assuming an snmp-proxy
} else {
print "ERROR: This IP ($id) already exists in the database and --proxy was not specified.\n";
exit(1);
}
} else {
$fail = true;
}
} elseif ($phost['snmp_version'] != $snmp_ver) {
// assuming a proxy
} elseif ($phost['snmp_version'] == '3' && $snmp_ver == '3') {
$changed = 0;
$changed += ($phost['snmp_username'] != $username ? 1:0);
$changed += ($phost['snmp_context'] != $snmp_context ? 1:0);
$changed += ($phost['snmp_engine_id'] != $snmp_engine_id ? 1:0);
$changed += ($phost['snmp_auth_protocol'] != $snmp_auth_protocol ? 1:0);
$changed += ($phost['snmp_priv_protocol'] != $snmp_priv_protocol ? 1:0);
if ($changed > 0) {
if ($proxy) {
// assuming a proxy
} else {
print "ERROR: This IP ($id) already exists in the database and --proxy was not specified.\n";
exit(1);
}
} else {
$fail = true;
}
} else {
$fail = true;
}
if ($fail) {
db_execute("UPDATE host SET description = '$description' WHERE deleted = '' AND id = " . $addresses[$ip]);
print "ERROR: This IP already exists in the database ($ip) device-id: (" . $addresses[$ip] . ")\n";
exit(1);
}
}
if (!is_numeric($site_id) || $site_id < 0) {
print "ERROR: You have specified an invalid site id!\n";
exit(1);
}
if (!is_numeric($poller_id) || $poller_id < 0) {
print "ERROR: You have specified an invalid poller id!\n";
exit(1);
}
/* process snmp information */
if ($snmp_ver < 0 || $snmp_ver > 3) {
print "ERROR: Invalid snmp version ($snmp_ver)\n";
exit(1);
} elseif ($snmp_ver > 0) {
if ($snmp_port <= 1 || $snmp_port > 65534) {
print "ERROR: Invalid port. Valid values are from 1-65534\n";
exit(1);
}
if ($snmp_timeout <= 0 || $snmp_timeout > 20000) {
print "ERROR: Invalid timeout. Valid values are from 1 to 20000\n";
exit(1);
}
}
/* community/user/password verification */
if ($snmp_ver < 3) {
/* snmp community can be blank */
} else {
if ($snmp_username == "" || $snmp_password == "") {
print "ERROR: When using snmpv3 you must supply an username and password\n";
exit(1);
}
}
/* validate the disable state */
if ($disable != 1 && $disable != 0) {
print "ERROR: Invalid disable flag ($disable)\n";
exit(1);
}
if ($disable == 0) {
$disable = "";
} else {
$disable = "on";
}
print "Adding $description ($ip) as \"" . $host_templates[$template_id] . "\" using SNMP v$snmp_ver with community \"$community\"\n";
$host_id = api_device_save('0', $template_id, $description, $ip,
$community, $snmp_ver, $snmp_username, $snmp_password,
$snmp_port, $snmp_timeout, $disable, $avail, $ping_method,
$ping_port, $ping_timeout, $ping_retries, $notes,
$snmp_auth_protocol, $snmp_priv_passphrase,
$snmp_priv_protocol, $snmp_context, $snmp_engine_id, $max_oids, $device_threads,
$poller_id, $site_id, $external_id, $location, $bulk_walk_size);
if (is_error_message()) {
print "ERROR: Failed to add this device\n";
exit(1);
} else {
print "Success - new device-id: ($host_id)\n";
exit(0);
}
} else {
display_help();
exit(0);
}
/* display_version - displays version information */
function display_version() {
$version = get_cacti_cli_version();
print "Cacti Add Device Utility, Version $version, " . COPYRIGHT_YEARS . "\n";
}
function display_help() {
display_version();
print "\nusage: add_device.php --description=[description] --ip=[IP] --template=[ID] [--notes=\"[]\"] [--disable]\n";
print " [--poller=[id]] [--site=[id] [--external-id=[S]] [--proxy] [--threads=[1]\n";
print " [--avail=[ping]] --ping_method=[icmp] --ping_port=[N/A, 1-65534] --ping_timeout=[N] --ping_retries=[2]\n";
print " [--version=[0|1|2|3]] [--community=] [--port=161] [--timeout=500]\n";
print " [--username= --password=] [--authproto=] [--privpass= --privproto=] [--context=] [--engineid=]\n";
print " [--quiet]\n\n";
print "Required:\n";
print " --description the name that will be displayed by Cacti in the graphs\n";
print " --ip self explanatory (can also be a FQDN)\n\n";
print "Optional:\n";
print " --proxy if specified, allows adding a second host with same ip address\n";
print " --template 0, is a number (read below to get a list of templates)\n";
print " --location '', The physical location of the Device.\n";
print " --notes '', General information about this host. Must be enclosed using double quotes.\n";
print " --external-id '', An external ID to align Cacti devices with devices from other systems.\n";
print " --disable 0, 1 to add this host but to disable checks and 0 to enable it\n";
print " --poller 0, numeric poller id that will perform data collection for the device.\n";
print " --site 0, numeric site id that will be associated with the device.\n";
print " --threads 1, numeric number of threads to poll device with.\n";
print " --avail pingsnmp, [ping][none, snmp, pingsnmp, pingorsnmp]\n";
print " --ping_method tcp, icmp|tcp|udp\n";
print " --ping_port '', 1-65534\n";
print " --ping_retries 2, the number of time to attempt to communicate with a host\n";
print " --ping_timeout N, the ping timeout in milliseconds. Defaults to database setting.\n";
print " --version 1, 0|1|2|3, snmp version. 0 for no snmp\n";
print " --community '', snmp community string for snmpv1 and snmpv2. Leave blank for no community\n";
print " --port 161\n";
print " --timeout 500\n";
print " --username '', snmp username for snmpv3\n";
print " --password '', snmp password for snmpv3\n";
print " --authproto '', snmp authentication protocol for snmpv3\n";
print " --privpass '', snmp privacy passphrase for snmpv3\n";
print " --privproto '', snmp privacy protocol for snmpv3\n";
print " --context '', snmp context for snmpv3\n";
print " --engineid '', snmp engineid for snmpv3\n";
print " --max_oids 10, 1-60, the number of OIDs that can be obtained in a single SNMP Get request\n\n";
print " --bulk_walk -1, 1-60, the bulk walk chunk size that will be used for bulk walks. Use -1 for auto-tune.\n\n";
print "List Options:\n";
print " --list-host-templates\n";
print " --list-communities\n";
print " --quiet - batch mode value return\n\n";
}
Reference in new issue View Git Blame Copy Permalink