admin/cacti
1
0 Fork 0
mirror of https://github.com/Cacti/cacti.git synced 2026-11-03 02:27:13 +09:00
Code Issues Packages Projects Releases Wiki Activity
Files
32d56ddfec6829949c01face7f211ff8d7aa87ea
cacti/lib/api_device.php
T
TheWitness 32d56ddfec Fixing Issue #5414 - Plugin control of change device settings 
Plugins are unable to modify fields in the setting 'Change Device Settings'
2023-07-23 09:51:54 -04:00

1629 lines
57 KiB
PHP
Raw Blame History

<?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/ |
+-------------------------------------------------------------------------+
*/
/**
* api_device_crc_update - update hash stored in settings table to inform
* remote pollers to update their caches
*
* @param (int) The id of the poller impacted by hash update
* @param (string) The hash variable prefix for the replication setting.
*
* @return (void)
*/
function api_device_cache_crc_update($poller_id, $variable = 'poller_replicate_device_cache_crc') {
$hash = hash('ripemd160', date('Y-m-d H:i:s') . rand() . $poller_id);
db_execute_prepared("REPLACE INTO settings SET value = ?, name='$variable" . "_" . "$poller_id'", array($hash));
}
/**
* api_device_remove - removes a device
*
* @param $device_id - the id of the device to remove
*/
function api_device_remove($device_id) {
global $config;
$poller_id = db_fetch_cell_prepared('SELECT poller_id
FROM host WHERE id = ?',
array($device_id));
api_plugin_hook_function('device_remove', array($device_id));
if ($poller_id == 1) {
db_execute_prepared('DELETE FROM host WHERE id = ?', array($device_id));
} else {
db_execute_prepared('UPDATE host SET deleted = "on" WHERE id = ?', array($device_id));
}
db_execute_prepared('DELETE FROM host_graph WHERE host_id = ?', array($device_id));
db_execute_prepared('DELETE FROM host_snmp_query WHERE host_id = ?', array($device_id));
db_execute_prepared('DELETE FROM host_snmp_cache WHERE host_id = ?', array($device_id));
db_execute_prepared('DELETE FROM poller_item WHERE host_id = ?', array($device_id));
db_execute_prepared('DELETE FROM poller_reindex WHERE host_id = ?', array($device_id));
db_execute_prepared('DELETE FROM graph_tree_items WHERE host_id = ?', array($device_id));
db_execute_prepared('DELETE FROM reports_items WHERE host_id = ?', array($device_id . ':%'));
db_execute_prepared('DELETE FROM poller_command WHERE command LIKE ?', array($device_id . ':%'));
if ($poller_id > 1) {
api_device_purge_from_remote($device_id, $poller_id);
}
$graphs = array_rekey(
db_fetch_assoc_prepared('SELECT id
FROM graph_local
WHERE host_id = ?',
array($device_id)),
'id', 'id'
);
if (cacti_sizeof($graphs)) {
api_delete_graphs($graphs, 2);
}
api_device_cache_crc_update($poller_id);
/**
* Save the last time a device/site was created/updated
* for Caching.
*/
set_config_option('time_last_change_device', time());
set_config_option('time_last_change_site_device', time());
}
/**
* api_device_purge_from_remote - removes a device from a remote data collectors
*
* @param $device_ids - device id or an array of device_ids of a host or hosts
* @param $poller_id - the previous poller if it changed
*/
function api_device_purge_from_remote($device_ids, $poller_id = 0) {
if (!is_array($device_ids)) {
$device_ids = array($device_ids);
}
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($poller_id, true)) !== false) {
db_execute('DELETE FROM host WHERE id IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
db_execute('DELETE FROM host_graph WHERE host_id IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
db_execute('DELETE FROM host_snmp_query WHERE host_id IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
db_execute('DELETE FROM host_snmp_cache WHERE host_id IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
db_execute('DELETE FROM poller_item WHERE host_id IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
db_execute('DELETE FROM poller_reindex WHERE host_id IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
db_execute('DELETE FROM graph_tree_items WHERE host_id IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
db_execute('DELETE FROM reports_items WHERE host_id IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
db_execute('DELETE FROM poller_command
WHERE SUBSTRING_INDEX(command, ":", 1) IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
db_execute('DELETE FROM data_local WHERE host_id IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
db_execute('DELETE FROM graph_local WHERE host_id IN (' . implode(', ', $device_ids) . ')', true, $rcnn_id);
} else {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
} else {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
foreach($device_ids as $id) {
db_execute_prepared('INSERT INTO poller_command
(poller_id, time, action, command)
VALUES (?, NOW(), ?, ?)
ON DUPLICATE KEY UPDATE time=VALUES(time)',
array($poller_id, POLLER_COMMAND_PURGE, $id));
}
}
}
/**
* api_device_purge_deleted_devices - Remove any devices from the database that are
* marked for deletion.
*
* @return (void)
*/
function api_device_purge_deleted_devices() {
$devices = db_fetch_assoc_prepared('SELECT id, poller_id
FROM host
WHERE deleted = "on"
AND UNIX_TIMESTAMP(last_updated) < UNIX_TIMESTAMP()-500');
if (cacti_sizeof($devices)) {
foreach($devices as $d) {
db_execute_prepared('DELETE FROM host WHERE id = ?', array($d['id']));
db_execute_prepared('DELETE FROM host_graph WHERE host_id = ?', array($d['id']));
db_execute_prepared('DELETE FROM host_snmp_query WHERE host_id = ?', array($d['id']));
db_execute_prepared('DELETE FROM host_snmp_cache WHERE host_id = ?', array($d['id']));
db_execute_prepared('DELETE FROM poller_item WHERE host_id = ?', array($d['id']));
db_execute_prepared('DELETE FROM poller_reindex WHERE host_id = ?', array($d['id']));
db_execute_prepared('DELETE FROM graph_tree_items WHERE host_id = ?', array($d['id']));
db_execute_prepared('DELETE FROM reports_items WHERE host_id = ?', array($d['id'] . ':%'));
db_execute_prepared('DELETE FROM poller_command WHERE command LIKE ?', array($d['id'] . ':%'));
db_execute_prepared('DELETE FROM data_local WHERE host_id = ?', array($d['id']));
db_execute_prepared('DELETE FROM graph_local WHERE host_id = ?', array($d['id']));
api_device_purge_from_remote($d['id'], $d['poller_id']);
}
}
}
/**
* api_device_remove_multi - removes multiple devices in one call
*
* @param (array) An array of device id's to remove
* @param (int) Boolean to keep data source and graphs or remove
*
* @return (void)
*/
function api_device_remove_multi($device_ids, $delete_type = 2) {
global $config;
$devices_to_delete = '';
$i = 0;
if (cacti_sizeof($device_ids)) {
api_plugin_hook_function('device_remove', $device_ids);
$data_sources = array();
$graphs = array();
$data_sources = array_rekey(
db_fetch_assoc('SELECT id
FROM data_local
WHERE host_id IN (' . implode(', ', $device_ids) . ')'),
'id', 'id'
);
$graphs = array_rekey(
db_fetch_assoc('SELECT id
FROM graph_local
WHERE host_id IN (' . implode(', ', $device_ids) . ')'),
'id', 'id'
);
/* build the list */
foreach($device_ids as $device_id) {
if ($i == 0) {
$devices_to_delete .= $device_id;
} else {
$devices_to_delete .= ', ' . $device_id;
}
/* poller commands go one at a time due to trashy logic */
db_execute_prepared('DELETE FROM poller_item WHERE host_id = ?', array($device_id));
db_execute_prepared('DELETE FROM poller_reindex WHERE host_id = ?', array($device_id));
db_execute_prepared('DELETE FROM poller_command WHERE command LIKE ?', array($device_id . ':%'));
$poller_id = db_fetch_cell_prepared('SELECT poller_id
FROM host
WHERE id = ?',
array($device_id));
$i++;
}
$poller_ids = get_remote_poller_ids_from_devices($devices_to_delete);
// handle removal or mark for removal as required
db_execute("DELETE FROM host WHERE id IN ($devices_to_delete) AND poller_id = 1");
db_execute("UPDATE host SET deleted = 'on' WHERE id IN ($devices_to_delete) AND poller_id != 1");
db_execute("DELETE FROM host_graph WHERE host_id IN ($devices_to_delete)");
db_execute("DELETE FROM host_snmp_query WHERE host_id IN ($devices_to_delete)");
db_execute("DELETE FROM host_snmp_cache WHERE host_id IN ($devices_to_delete)");
db_execute("DELETE FROM graph_tree_items WHERE host_id IN ($devices_to_delete)");
db_execute("DELETE FROM reports_items WHERE host_id IN ($devices_to_delete)");
if ($delete_type == 2) {
api_delete_graphs($graphs, $delete_type);
} else {
api_data_source_disable_multi($data_sources);
db_execute("UPDATE graph_local SET host_id = 0 WHERE host_id IN($devices_to_delete)");
db_execute("UPDATE data_local SET host_id = 0 WHERE host_id IN($devices_to_delete)");
}
if (cacti_sizeof($poller_ids)) {
foreach($poller_ids as $poller_id) {
api_device_cache_crc_update($poller_id);
api_device_purge_from_remote($device_ids, $poller_id);
}
}
/**
* Save the last time a device/site was created/updated
* for Caching.
*/
set_config_option('time_last_change_device', time());
set_config_option('time_last_change_site_device', time());
}
}
/**
* api_device_disable_devices - Disable an array of device ids
*
* @param (array) An array of device ids
*
* @return (void)
*/
function api_device_disable_devices($device_ids) {
global $config;
$raised = array();
foreach ($device_ids as $device_id) {
db_execute_prepared("UPDATE host
SET disabled = 'on', status = 0
WHERE id = ?
AND (deleted = '' OR (deleted = 'on' AND disabled = ''))",
array($device_id));
$poller_id = db_fetch_cell_prepared('SELECT poller_id FROM host WHERE id = ?', array($device_id));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared("UPDATE host
SET disabled='on'
WHERE id = ?
AND (deleted = '' OR (deleted = 'on' AND disabled = ''))",
array($device_id), true, $rcnn_id);
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
}
}
}
/**
* api_device_enable_devices - Enable an array of device ids
*
* @param (array) An array of device ids
*
* @return (void)
*/
function api_device_enable_devices($device_ids) {
global $config;
$raised = array();
foreach ($device_ids as $device_id) {
$poller_id = db_fetch_cell_prepared('SELECT poller_id
FROM host
WHERE id = ?',
array($device_id));
db_execute_prepared("UPDATE host
SET disabled = ''
WHERE id = ?
AND deleted = ''",
array($device_id));
if ($poller_id > 1) {
$poller_cache = 0;
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared("UPDATE host
SET disabled = ''
WHERE id = ?",
array($device_id), true, $rcnn_id);
$poller_cache = db_fetch_cell_prepared('SELECT COUNT(local_data_id)
FROM poller_item
WHERE host_id = ?',
array($device_id), '', true, $rcnn_id);
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
} else {
$poller_cache = db_fetch_cell_prepared('SELECT COUNT(local_data_id)
FROM poller_item
WHERE host_id = ?',
array($device_id));
}
/**
* Only reprime poller cache if empty this allows support for pre 1.2.16
* enable behavior.
*/
if (!cacti_sizeof($poller_cache)) {
/* update poller cache */
$data_sources = db_fetch_assoc_prepared('SELECT id
FROM data_local
WHERE host_id = ?',
array($device_id));
$poller_items = $local_data_ids = array();
if (cacti_sizeof($data_sources)) {
foreach ($data_sources as $data_source) {
$local_data_ids[] = $data_source['id'];
$poller_items = array_merge($poller_items, update_poller_cache($data_source['id']));
}
}
if (cacti_sizeof($local_data_ids)) {
poller_update_poller_cache_from_buffer($local_data_ids, $poller_items, $poller_id);
}
}
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
poller_push_reindex_data_to_poller($device_id, 0, true, $rcnn_id);
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
}
}
}
/**
* api_device_change_options - Given an array of device ids and the
* post variable, update a series of Device settings.
*
* @param (array) An array of device ids
* @param (array) An array representing the $_POST variable
*
* @return (void)
*/
function api_device_change_options($device_ids, $post) {
global $config, $fields_host_edit;
$previous_poller = -1;
$poller_ids = array();
$raised = array();
foreach ($device_ids as $device_id) {
foreach ($fields_host_edit as $field_name => $field_array) {
if (isset($post["t_$field_name"])) {
if ($field_name == 'poller_id') {
$old_poller = db_fetch_cell_prepared('SELECT poller_id
FROM host
WHERE id = ?',
array($device_id));
if ($old_poller > 1 && $old_poller != get_nfilter_request_var($field_name)) {
$previous_poller = get_nfilter_request_var($field_name);
api_device_purge_from_remote($device_id, $old_poller);
}
// Update the local device and replicate
if ($old_poller != get_nfilter_request_var($field_name && get_nfilter_request_var($field_name) > 1)) {
api_device_replicate_out($device_id, get_nfilter_request_var($field_name));
}
}
db_execute_prepared("UPDATE host
SET $field_name = ?
WHERE id = ?
AND deleted = ''",
array(get_nfilter_request_var($field_name), $device_id));
if (!isset($poller_ids[$device_id])) {
$poller_ids[$device_id] = db_fetch_cell_prepared('SELECT poller_id FROM host WHERE id = ?', array($device_id));
}
$poller_id = $poller_ids[$device_id];
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared("UPDATE host
SET $field_name = ?
WHERE id = ?
AND deleted = ''",
array(get_nfilter_request_var($field_name), $device_id), true, $rcnn_id);
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
}
if ($field_name == 'host_template_id') {
api_device_update_host_template($device_id, get_nfilter_request_var($field_name));
}
}
}
push_out_host($device_id);
}
}
/**
* api_device_clear_statistics - Clear all device level statistics and reset as if the
* device was new in Cacti
*
* @param (array) An array of device ids
*
* @return (void)
*/
function api_device_clear_statistics($device_ids) {
global $config;
$raised = array();
foreach ($device_ids as $device_id) {
db_execute_prepared("UPDATE host
SET min_time = '9.99999', max_time = '0', cur_time = '0', avg_time = '0',
total_polls = '0', failed_polls = '0', availability = '100.00'
WHERE id = ?
AND deleted = ''",
array($device_id));
$poller_id = db_fetch_cell_prepared('SELECT poller_id FROM host WHERE id = ?', array($device_id));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared("UPDATE host
SET min_time = '9.99999', max_time = '0', cur_time = '0', avg_time = '0',
total_polls = '0', failed_polls = '0', availability = '100.00'
WHERE id = ?
AND deleted = ''",
array($device_id), true, $rcnn_id);
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
}
}
}
/**
* api_device_sync_device_templates - Sync an array of device ids with their
* parent Device Template
*
* @param (array) An array of device ids
*
* @return (void)
*/
function api_device_sync_device_templates($device_ids) {
global $config;
foreach ($device_ids as $device_id) {
$device_template_id = db_fetch_cell_prepared('SELECT host_template_id
FROM host
WHERE id = ?',
array($device_id));
if ($device_template_id > 0) {
api_device_update_host_template($device_id, $device_template_id);
}
}
}
/**
* api_device_dq_add - adds a device->data query mapping
* @param (int) The id of the device which contains the mapping
* @param (int) The id of the data query to remove the mapping for
* @param (int) The reindex method to user when adding the data query
*
* @return (void)
*/
function api_device_dq_add($device_id, $data_query_id, $reindex_method) {
global $config;
db_execute_prepared('REPLACE INTO host_snmp_query
(host_id, snmp_query_id, reindex_method)
VALUES (?, ?, ?)',
array($device_id, $data_query_id, $reindex_method));
$poller_id = db_fetch_cell_prepared('SELECT poller_id FROM host WHERE id = ?', array($device_id));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared('REPLACE INTO host_snmp_query
(host_id, snmp_query_id, reindex_method)
VALUES (?, ?, ?)',
array($device_id, $data_query_id, $reindex_method), true, $rcnn_id);
} else {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
} else {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
}
/* recache snmp data */
run_data_query($device_id, $data_query_id);
}
/**
* api_device_dq_remove - removes a device->data query mapping
*
* @param (int) The id of the device which contains the mapping
* @param (int) The id of the data query to remove the mapping for
*
* @return (void)
*/
function api_device_dq_remove($device_id, $data_query_id) {
global $config;
db_execute_prepared('DELETE FROM host_snmp_cache
WHERE snmp_query_id = ?
AND host_id = ?',
array($data_query_id, $device_id));
db_execute_prepared('DELETE FROM host_snmp_query
WHERE snmp_query_id = ?
AND host_id = ?',
array($data_query_id, $device_id));
db_execute_prepared('DELETE FROM poller_reindex
WHERE data_query_id = ?
AND host_id = ?',
array($data_query_id, $device_id));
$poller_id = db_fetch_cell_prepared('SELECT poller_id FROM host WHERE id = ?', array($device_id));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared('DELETE FROM host_snmp_cache
WHERE snmp_query_id = ?
AND host_id = ?',
array($data_query_id, $device_id), true, $rcnn_id);
db_execute_prepared('DELETE FROM host_snmp_query
WHERE snmp_query_id = ?
AND host_id = ?',
array($data_query_id, $device_id), true, $rcnn_id);
db_execute_prepared('DELETE FROM poller_reindex
WHERE data_query_id = ?
AND host_id = ?',
array($data_query_id, $device_id), true, $rcnn_id);
} else {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
} else {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
}
}
/**
* api_device_dq_change - changes a device->data query mapping
*
* @param (int) The id of the device which contains the mapping
* @param (int) The id of the data query to remove the mapping for
* @param (int) The reindex method to use when changing the data query
*
* @return (void)
*/
function api_device_dq_change($device_id, $data_query_id, $reindex_method) {
global $config;
db_execute_prepared('INSERT INTO host_snmp_query
(host_id, snmp_query_id, reindex_method)
VALUES (?, ?, ?)
ON DUPLICATE KEY UPDATE reindex_method=VALUES(reindex_method)',
array($device_id, $data_query_id, $reindex_method));
db_execute_prepared('DELETE FROM poller_reindex
WHERE data_query_id = ?
AND host_id = ?', array($data_query_id, $device_id));
$poller_id = db_fetch_cell_prepared('SELECT poller_id FROM host WHERE id = ?', array($device_id));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared('INSERT INTO host_snmp_query
(host_id, snmp_query_id, reindex_method)
VALUES (?, ?, ?)
ON DUPLICATE KEY UPDATE reindex_method=VALUES(reindex_method)',
array($device_id, $data_query_id, $reindex_method), true, $rcnn_id);
db_execute_prepared('DELETE FROM poller_reindex
WHERE data_query_id = ?
AND host_id = ?', array($data_query_id, $device_id), true, $rcnn_id);
} else {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
} else {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
}
/* finally rerun the data query */
run_data_query($device_id, $data_query_id);
}
/**
* api_device_gt_remove - removes a device->graph template mapping
*
* @param (int) The id of the device which contains the mapping
* @param (int) The id of the graph template to remove the mapping for
*
* @return (void)
*/
function api_device_gt_remove($device_id, $graph_template_id) {
global $config;
db_execute_prepared('DELETE FROM host_graph
WHERE graph_template_id = ?
AND host_id = ?',
array($graph_template_id, $device_id));
$poller_id = db_fetch_cell_prepared('SELECT poller_id FROM host WHERE id = ?', array($device_id));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared('DELETE FROM host_graph
WHERE graph_template_id = ?
AND host_id = ?',
array($graph_template_id, $device_id), true, $rcnn_id);
} else {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
} else {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
}
}
/**
* api_device_replicate_out - Replace device settings to the remote data collectors
*
* @param (int) The id of the device
* @param (int) The poller id of the device. If null, we determine it
*
* @return (void)
*/
function api_device_replicate_out($device_id, $poller_id = 1) {
global $config;
$rcnn_id = false;
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
$rcnn_id = poller_connect_to_remote($poller_id);
}
}
if ($rcnn_id === false) {
return false;
}
// Update poller id where applicable
db_execute_prepared('UPDATE host
SET poller_id = ?
WHERE id = ?
AND deleted = ""',
array($poller_id, $device_id));
db_execute_prepared('UPDATE poller_item
SET poller_id = ?
WHERE host_id = ?',
array($poller_id, $device_id));
// Start Push Replication
$data = db_fetch_assoc_prepared('SELECT hsq.*
FROM host_snmp_query AS hsq
INNER JOIN host AS h
ON h.id=hsq.host_id
WHERE h.id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'host_snmp_query', $poller_id);
}
$data = db_fetch_assoc_prepared('SELECT pi.*
FROM poller_item AS pi
WHERE pi.host_id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'poller_item', $poller_id);
}
$data = db_fetch_assoc_prepared('SELECT h.*
FROM host AS h
WHERE h.id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'host', $poller_id);
}
$data = db_fetch_assoc_prepared('SELECT hsc.*
FROM host_snmp_cache AS hsc
INNER JOIN host AS h
ON h.id=hsc.host_id
WHERE h.id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'host_snmp_cache', $poller_id);
}
$data = db_fetch_assoc_prepared('SELECT pri.*
FROM poller_reindex AS pri
INNER JOIN host AS h
ON h.id=pri.host_id
WHERE h.id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'poller_reindex', $poller_id);
}
$data = db_fetch_assoc_prepared('SELECT dl.*
FROM data_local AS dl
INNER JOIN host AS h
ON h.id=dl.host_id
WHERE h.id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'data_local', $poller_id);
}
$data = db_fetch_assoc_prepared('SELECT gl.*
FROM graph_local AS gl
INNER JOIN host AS h
ON h.id=gl.host_id
WHERE h.id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'graph_local', $poller_id);
}
$data = db_fetch_assoc_prepared('SELECT dtd.*
FROM data_template_data AS dtd
INNER JOIN data_local AS dl
ON dtd.local_data_id=dl.id
INNER JOIN host AS h
ON h.id=dl.host_id
WHERE h.id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'data_template_data', $poller_id);
}
$data = db_fetch_assoc_prepared('SELECT dtr.*
FROM data_template_rrd AS dtr
INNER JOIN data_local AS dl
ON dtr.local_data_id=dl.id
INNER JOIN host AS h
ON h.id=dl.host_id
WHERE h.id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'data_template_rrd', $poller_id);
}
$data = db_fetch_assoc_prepared('SELECT gti.*
FROM graph_templates_item AS gti
INNER JOIN graph_local AS gl
ON gti.local_graph_id=gl.id
INNER JOIN host AS h
ON h.id=gl.host_id
WHERE h.id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'graph_templates_item', $poller_id);
}
$data = db_fetch_assoc_prepared('SELECT did.*
FROM data_input_data AS did
INNER JOIN data_template_data AS dtd
ON did.data_template_data_id=dtd.id
INNER JOIN data_local AS dl
ON dl.id=dtd.local_data_id
INNER JOIN host AS h
ON h.id=dl.host_id
WHERE h.id = ?',
array($device_id));
if ($poller_id > 1) {
replicate_table_to_poller($rcnn_id, $data, 'data_input_data', $poller_id);
}
api_plugin_hook_function('replicate_out', $poller_id);
$stats = db_fetch_row_prepared('SELECT
SUM(CASE WHEN action=0 THEN 1 ELSE 0 END) AS snmp,
SUM(CASE WHEN action=1 THEN 1 ELSE 0 END) AS script,
SUM(CASE WHEN action=2 THEN 1 ELSE 0 END) AS server
FROM poller_item
WHERE poller_id = ?',
array($poller_id));
if (cacti_sizeof($stats)) {
db_execute_prepared('UPDATE poller
SET snmp = ?, script = ?, server = ?
WHERE id = ?',
array($stats['snmp'], $stats['script'], $stats['server'], $poller_id));
}
return true;
}
/**
* api_device_save - Save a device and update the poller cache for the device is required.
* The function will determine if the poller cache needs updating by reviewing the changed
* settings. If no settings changed that require an update of the poller cache, the
* device level settings will simply be updated, otherwise the poller cache will be refreshed
* for the device.
*
* @param (int) The id of the device
* @param (int) The device template for the device
* @param (string) A device description
* @param (string) The devices hostname
* @param (string) The devices snmp community in the case of v1/v2c
* @param (int) The devices snmp_version 1|2|3
* @param (string) The devices snmp username in the case of v3
* @param (string) The devices snmp auth password in the case of v3
* @param (int) The devices snmp port if in use. Default to 161
* @param (int) The devices snmp timeout in milliseconds
* @param (bool) True of 'on' if the device is disabled
* @param (int) The devices availability/reachability type
* @param (int) The devices availability/reachability test ping method
* @param (int) The devices ping port to be used in the case of TCP or UDP
* @param (int) The ping timeout in milliseconds
* @param (int) The number of times to retry the ping of the device
* @param (strong) Operator notes for the device. Can be used by plugins
* @param (int) The snmp authentication protocol
* @param (string) The snmp privilege protocol passphrase
* @param (int) The snmp privilege protocol to use
* @param (string) The snmp context to use to reach the device
* @param (string) The snmp engine id if required to reach the devices
* @param (int) The maximum number of OID's to gather in a single snmpget request
* @param (int) When using spine, the number of threads to use to collect data source information
* @param (int) The id of the data collector. The default is 1
* @param (int) The id of the site that the device belongs to
* @param (string) External ID's to be used by plugins and other cmdb like functions
* @param (string) A location attribute such as rack and enclosure, closet location within a site.
* @param (int) A variable that tells cacti to find detect the optimal bulk walk size for the device
*
* @return (int) The id of the device
*/
function api_device_save($id, $device_template_id, $description, $hostname, $snmp_community, $snmp_version,
$snmp_username, $snmp_password, $snmp_port, $snmp_timeout, $disabled,
$availability_method, $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 = 5, $device_threads = 1, $poller_id = 1, $site_id = 1, $external_id = '', $location = '', $bulk_walk_size = -1) {
global $config;
include_once($config['base_path'] . '/lib/utility.php');
include_once($config['base_path'] . '/lib/variables.php');
include_once($config['base_path'] . '/lib/data_query.php');
if ($id > 0) {
$previous_poller = db_fetch_cell_prepared('SELECT poller_id
FROM host
WHERE id = ?',
array($id));
} else {
$previous_poller = 0;
}
/* fetch some cache variables */
if (empty($id)) {
$_host_template_id = 0;
} else {
$_host_template_id = db_fetch_cell_prepared('SELECT host_template_id
FROM host
WHERE id = ?',
array($id));
}
$raised = false;
$save['id'] = form_input_validate($id, 'id', '^[0-9]+$', false, 3);
$save['host_template_id'] = form_input_validate($device_template_id, 'host_template_id', '^[0-9]+$', true, 3);
$save['poller_id'] = form_input_validate($poller_id, 'poller_id', '^[0-9]+$', true, 3);
$save['site_id'] = form_input_validate($site_id, 'site_id', '^[0-9]+$', true, 3);
$save['external_id'] = form_input_validate($external_id, 'external_id', '', true, 3);
$save['description'] = form_input_validate($description, 'description', '', false, 3);
$save['hostname'] = form_input_validate(trim($hostname), 'hostname', '', false, 3);
$save['notes'] = form_input_validate($notes, 'notes', '', true, 3);
$save['location'] = form_input_validate($location, 'location', '', true, 3);
$save['snmp_version'] = form_input_validate($snmp_version, 'snmp_version', '', true, 3);
$save['snmp_community'] = form_input_validate($snmp_community, 'snmp_community', '', true, 3);
if ($save['snmp_version'] == 3) {
$save['snmp_username'] = form_input_validate($snmp_username, 'snmp_username', '', true, 3);
$save['snmp_password'] = form_input_validate($snmp_password, 'snmp_password', '', true, 3);
$save['snmp_auth_protocol'] = form_input_validate($snmp_auth_protocol, 'snmp_auth_protocol', "^\[None\]|MD5|SHA|SHA224|SHA256|SHA392|SHA512$", true, 3);
$save['snmp_priv_passphrase'] = form_input_validate($snmp_priv_passphrase, 'snmp_priv_passphrase', '', true, 3);
$save['snmp_priv_protocol'] = form_input_validate($snmp_priv_protocol, 'snmp_priv_protocol', "^\[None\]|DES|AES128|AES192|AES256$", true, 3);
$save['snmp_context'] = form_input_validate($snmp_context, 'snmp_context', '', true, 3);
$save['snmp_engine_id'] = form_input_validate($snmp_engine_id, 'snmp_engine_id', '', true, 3);
if (strlen($save['snmp_password']) < 8 && $snmp_auth_protocol != '[None]') {
raise_message(32);
$_SESSION['sess_error_fields']['snmp_password'] = 'snmp_password';
}
} else {
$save['snmp_username'] = '';
$save['snmp_password'] = '';
$save['snmp_auth_protocol'] = '';
$save['snmp_priv_passphrase'] = '';
$save['snmp_priv_protocol'] = '';
$save['snmp_context'] = '';
$save['snmp_engine_id'] = '';
}
$save['snmp_port'] = form_input_validate($snmp_port, 'snmp_port', '^[0-9]+$', false, 3);
$save['snmp_timeout'] = form_input_validate($snmp_timeout, 'snmp_timeout', '^[0-9]+$', false, 3);
/* disabled = 'on' => regexp '^on$'
* not disabled = '' => no regexp, but allow nulls */
$save['disabled'] = form_input_validate($disabled, 'disabled', '^on$', true, 3);
if ($save['disabled'] == 'on') {
if ($save['id'] > 0) {
api_device_disable_devices(array($save['id']));
}
}
$quick_save = api_device_quick_save($save);
$save['availability_method'] = form_input_validate($availability_method, 'availability_method', '^[0-9]+$', false, 3);
$save['ping_method'] = form_input_validate($ping_method, 'ping_method', '^[0-9]+$', false, 3);
$save['ping_port'] = form_input_validate($ping_port, 'ping_port', '^[0-9]+$', true, 3);
$save['ping_timeout'] = form_input_validate($ping_timeout, 'ping_timeout', '^[0-9]+$', true, 3);
$save['ping_retries'] = form_input_validate($ping_retries, 'ping_retries', '^[0-9]+$', true, 3);
$save['max_oids'] = form_input_validate($max_oids, 'max_oids', '^[0-9]+$', false, 3);
$save['bulk_walk_size'] = form_input_validate($bulk_walk_size, 'bulk_walk_size', '^[-0-9]+$', false, 3);
$save['device_threads'] = form_input_validate($device_threads, 'device_threads', '^[0-9]+$', true, 3);
$device_id = 0;
if (!is_error_message()) {
$save = api_plugin_hook_function('api_device_save', $save);
$device_id = sql_save($save, 'host');
if ($device_id) {
if ($previous_poller > 1 && $poller_id != $previous_poller) {
if (remote_poller_up($previous_poller)) {
api_device_purge_from_remote($device_id, $previous_poller);
} else {
raise_message('poller_down_' . $save['id'], __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $previous_poller), MESSAGE_LEVEL_WARN);
$raised = true;
}
}
raise_message(1);
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
$save['id'] = $device_id;
sql_save($save, 'host', 'id', true, $rcnn_id);
} elseif (!$raised) {
raise_message('poller_down_' . $save['id'], __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised = true;
}
} elseif (!$raised) {
raise_message('poller_down_' . $save['id'], __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised = true;
}
}
/* clear the host session data for poller cache repopulation */
if (isset($_SESSION['sess_host_cache_array'][$device_id])) {
unset($_SESSION['sess_host_cache_array'][$device_id]);
}
/* change reindex method for 'None' for non-snmp devices */
if ($save['snmp_version'] == 0) {
db_execute_prepared('UPDATE host_snmp_query
SET reindex_method = 0
WHERE host_id = ?',
array($device_id));
db_execute_prepared('DELETE FROM poller_reindex
WHERE host_id = ?',
array($device_id));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared('UPDATE host_snmp_query
SET reindex_method = 0
WHERE host_id = ?',
array($device_id), true, $rcnn_id);
db_execute_prepared('DELETE FROM poller_reindex
WHERE host_id = ?',
array($device_id), true, $rcnn_id);
} elseif (!$raised) {
raise_message('poller_down_' . $save['id'], __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
} elseif (!$raised) {
raise_message('poller_down_' . $save['id'], __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
}
}
}
api_device_cache_crc_update($save['poller_id']);
/* push out relevant fields to data sources using this host */
if (!$quick_save) {
push_out_host($device_id, 0);
}
/* the host substitution cache is now stale; purge it */
kill_session_var('sess_host_cache_array');
/* update title cache for graph and data source */
update_data_source_title_cache_from_host($device_id);
update_graph_title_cache_from_host($device_id);
if (empty($id)) {
/**
* Save the last time a device/site was created/updated
* for Caching.
*/
set_config_option('time_last_change_device', time());
set_config_option('time_last_change_site_device', time());
}
} else {
raise_message(2);
}
/* if the user changes the host template, add each snmp query associated with it */
if ($device_template_id > 0 && $device_template_id != $_host_template_id) {
api_device_update_host_template($device_id, $device_template_id);
}
}
if ($device_id > 0) {
if (read_config_option('extended_paths') == 'on'){
$host_dir = $config['rra_path'] . '/' . $device_id;
if (!is_dir($host_dir)){
if (is_writable($config['rra_path'])) {
if (mkdir($host_dir, 0775)) {
if ($config['cacti_server_os'] != 'win32') {
$owner_id = fileowner($config['rra_path']);
$group_id = filegroup($config['rra_path']);
if ((chown($host_dir, $owner_id)) &&
(chgrp($host_dir, $group_id))) {
/* permissions set ok */
} else {
cacti_log("ERROR: Unable to set directory permissions for '" . $host_dir . "'", false);
}
}
} else {
cacti_log("ERROR: Unable to create directory '" . $host_dir . "'", false);
}
} else {
cacti_log("ERROR: Unable to create directory due to missing write permissions '" . $host_dir . "'", false);
}
}
}
# now that we have the id of the new host, we may plugin postprocessing code
$save['id'] = $device_id;
snmpagent_api_device_new($save);
automation_execute_device_create_tree($device_id);
api_plugin_hook_function('api_device_new', $save);
}
return $device_id;
}
/**
* api_device_quick_save - checks if the poller cache needs to be
* rebuilt as a part of a device save.
*
* @param (array) The devices "save" structure for the device
*
* @return (bool) If the device can be quickly saved, or will the device have to be pushed out
*/
function api_device_quick_save(&$save) {
if ($save['id'] > 0) {
$device = db_fetch_row_prepared('SELECT *
FROM host
WHERE id = ?',
array($save['id']));
$compare = array(
'poller_id',
'disabled',
'hostname',
'snmp_community',
'snmp_version',
'snmp_username',
'snmp_password',
'snmp_auth_protocol',
'snmp_priv_passphrase',
'snmp_priv_protocol',
'snmp_context',
'snmp_engine_id',
'snmp_port',
'snmp_timeout'
);
foreach($compare as $c) {
if ($save[$c] != $device[$c]) {
return false;
}
}
return true;
} else {
return false;
}
}
/**
* api_device_update_host_template - changes the host template of a host
*
* @param (int) The id of the device which contains the mapping
* @param (int) The id of the device template alter the device to
*
* @return (void)
*/
function api_device_update_host_template($device_id, $device_template_id) {
global $config;
static $raised = array();
db_execute_prepared('UPDATE host
SET host_template_id = ?
WHERE id = ?
AND deleted = ""',
array($device_template_id, $device_id));
$poller_id = db_fetch_cell_prepared('SELECT poller_id FROM host WHERE id = ?', array($device_id));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared('UPDATE host
SET host_template_id = ?
WHERE id = ?
AND deleted = ""',
array($device_template_id, $device_id), true, $rcnn_id);
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
}
/* add all new snmp queries assigned to the device template */
$snmp_queries = db_fetch_assoc_prepared('SELECT snmp_query_id
FROM host_template_snmp_query AS htsq
WHERE host_template_id = ?
AND htsq.snmp_query_id NOT IN (SELECT snmp_query_id FROM host_snmp_cache WHERE host_id = ?)',
array($device_template_id, $device_id));
if (cacti_sizeof($snmp_queries)) {
foreach ($snmp_queries as $snmp_query) {
db_execute_prepared('REPLACE INTO host_snmp_query
(host_id, snmp_query_id, reindex_method)
VALUES (?, ?, ?)',
array($device_id, $snmp_query['snmp_query_id'], read_config_option('reindex_method')));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared('REPLACE INTO host_snmp_query
(host_id, snmp_query_id, reindex_method)
VALUES (?, ?, ?)',
array($device_id, $snmp_query['snmp_query_id'], read_config_option('reindex_method')), true, $rcnn_id);
} elseif ($raised[$poller_id]) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
}
/* recache snmp data */
run_data_query($device_id, $snmp_query['snmp_query_id']);
}
}
/* add all graph templates assigned to the device template */
$graph_templates = db_fetch_assoc_prepared('SELECT graph_template_id
FROM host_template_graph AS hg
WHERE host_template_id = ?
AND hg.graph_template_id NOT IN (SELECT graph_template_id FROM host_graph WHERE host_id = ?)',
array($device_template_id, $device_id));
if (cacti_sizeof($graph_templates)) {
foreach ($graph_templates as $graph_template) {
db_execute_prepared('REPLACE INTO host_graph
(host_id, graph_template_id)
VALUES (?, ?)',
array($device_id, $graph_template['graph_template_id']));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared('REPLACE INTO host_graph
(host_id, graph_template_id)
VALUES (?, ?)',
array($device_id, $graph_template['graph_template_id']), true, $rcnn_id);
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
}
automation_hook_graph_template($device_id, $graph_template['graph_template_id']);
api_plugin_hook_function('add_graph_template_to_host',
array('host_id' => $device_id, 'graph_template_id' => $graph_template['graph_template_id']));
}
}
/* remove unused graph templates not assigned to the device template */
$unused_graph_templates = db_fetch_assoc_prepared('SELECT DISTINCT
hg.graph_template_id AS id, gt.name, result.gtid
FROM host_graph AS hg
LEFT JOIN graph_templates AS gt
ON gt.id=hg.graph_template_id
LEFT JOIN (
SELECT DISTINCT graph_template_id AS gtid
FROM graph_local AS gl
WHERE gl.host_id = ?
AND snmp_query_id = 0
UNION
SELECT DISTINCT graph_template_id AS gtid
FROM host_template_graph AS htg
WHERE htg.host_template_id = ?
) AS result
ON hg.graph_template_id=result.gtid
WHERE gt.id NOT IN (SELECT graph_template_id FROM snmp_query_graph)
HAVING gtid IS NULL
ORDER BY gt.name',
array($device_id, $device_template_id)
);
if (cacti_sizeof($unused_graph_templates)) {
foreach ($unused_graph_templates as $unused_graph_template) {
db_execute_prepared('DELETE
FROM host_graph
WHERE host_id = ?
AND graph_template_id = ?',
array($device_id, $unused_graph_template['id']));
if ($poller_id > 1) {
if (remote_poller_up($poller_id)) {
if (($rcnn_id = poller_push_to_remote_db_connect($device_id)) !== false) {
db_execute_prepared('DELETE
FROM host_graph
WHERE host_id = ?
AND graph_template_id = ?',
array($device_id, $unused_graph_template['id']), true, $rcnn_id);
} elseif (!isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
} elseif (!$isset($raised[$poller_id])) {
raise_message('poller_down_' . $poller_id, __('Remote Poller %s is Down, you will need to perform a FullSync once it is up again', $poller_id), MESSAGE_LEVEL_WARN);
$raised[$poller_id] = true;
}
}
}
}
$data = array('device_id' => $device_id, 'device_template_id' => $device_template_id);
api_plugin_hook_function('device_template_change', $data);
}
/**
* api_device_change_field_match - Checks the global $device_change_fileds array
* against the field name and returns true or false if it matches the rule
*
* This function can be used by plugins to allow the modification of additional
* device fields from the change device rule.
*
* @param string The field name to check
*
* @return bool True or false if it matches one of the rules
*/
function api_device_change_field_match($field_name) {
global $device_change_fields;
$matches = false;
foreach($device_change_fields as $rule_type => $rules) {
foreach($rules as $field_rule) {
if ($rule_type == 'preg_field') {
if (preg_match($field_rule, $field_name)) {
$matches = true;
break 2;
}
} elseif ($rule_type == 'match_field') {
if ($field_rule == $field_name) {
$matches = true;
break 2;
}
}
}
}
return $matches;
}
/**
* api_device_template_sync_template - updates the device template mapping for all devices mapped to a template
*
* @param (int) The device template to synchronize
* @param (int|array) An array of device_ids or a string with a single device_id
* @param (bool) Also update mapping of down devices
*
* @return (void)
*/
function api_device_template_sync_template($device_template, $device_ids = '', $down_devices = false) {
if ($down_devices == true) {
$status_where = '';
} else {
$status_where = ' AND status IN(3,2)';
}
if (is_array($device_ids)) {
$device_ids = implode(',', $device_ids);
}
if ($device_ids != '') {
$status_where .= ' AND host.id IN(' . $device_ids . ')';
}
$devices = array_rekey(
db_fetch_assoc_prepared('SELECT id
FROM host
WHERE host_template_id = ?' .
$status_where,
array($device_template)),
'id', 'id'
);
if (cacti_sizeof($devices)) {
foreach($devices as $device) {
api_device_update_host_template($device, $device_template);
}
}
}
/**
* api_device_ping_device - given a device id and optional indicator of where the ping request
* came from, ping the device. The ping results are echoed to standard output for the browser
*
* @param (int) The device id in question
* @param (bool) Whether the source of the ping request is coming from a remote data collector.
*
* @return (void)
*/
function api_device_ping_device($device_id, $from_remote = false) {
global $config, $snmp_error;
if (empty($device_id)) {
print __('ERROR: Device ID is Blank');
return;
}
$host = db_fetch_row_prepared('SELECT *
FROM host
WHERE id = ?',
array($device_id));
if (!cacti_sizeof($host)) {
if ($from_remote) {
print __('ERROR: Device[' . $device_id . '] not found. Please perform Full Sync!');
} else {
print __('ERROR: Device[' . $device_id . '] not found. Please check database for errors.');
}
return;
}
$am = $host['availability_method'];
$anym = false;
if ($config['poller_id'] != $host['poller_id'] && $from_remote == false) {
$hostname = db_fetch_cell_prepared('SELECT hostname
FROM poller
WHERE id = ?',
array($host['poller_id']));
$fgc_contextoption = get_default_contextoption();
$fgc_context = stream_context_create($fgc_contextoption);
$results = @file_get_contents(get_url_type() .'://' . $hostname . $config['url_path'] . 'remote_agent.php?action=ping&host_id=' . $host['id'], false, $fgc_context);
if ($results != '') {
print $results;
} else {
print __('ERROR: Failed to connect to remote collector.');
}
return;
}
if ($host['disabled'] == 'on') {
print __('Device is Disabled') . '<br>';
print __('Device Availability Check Bypassed') . '<br>';
} elseif ($am == AVAIL_SNMP || $am == AVAIL_SNMP_GET_NEXT ||
$am == AVAIL_SNMP_GET_SYSDESC || $am == AVAIL_SNMP_AND_PING ||
$am == AVAIL_SNMP_OR_PING) {
$anym = true;
print __('SNMP Information') . '<br>';
print "<span class='monoSpace'>";
if (($host['snmp_community'] == '' && $host['snmp_username'] == '') || $host['snmp_version'] == 0) {
print "<span style='color: #ab3f1e; font-weight: bold;'>" . __('SNMP not in use') . '</span>';
} else {
$snmp_error = '';
$session = cacti_snmp_session($host['hostname'], $host['snmp_community'], $host['snmp_version'],
$host['snmp_username'], $host['snmp_password'], $host['snmp_auth_protocol'], $host['snmp_priv_passphrase'],
$host['snmp_priv_protocol'], $host['snmp_context'], $host['snmp_engine_id'], $host['snmp_port'],
$host['snmp_timeout'], $host['ping_retries'], $host['max_oids']);
if ($session === false || $snmp_error != '') {
print "<span class='hostDown'>" . __('Session') . ' ' . __('SNMP error');
if ($snmp_error != '') {
print " - $snmp_error";
}
print '</span>';
} else {
$snmp_system = cacti_snmp_session_get($session, '.1.3.6.1.2.1.1.1.0');
if ($snmp_system === false || $snmp_system == 'U' || $snmp_error != '') {
print "<span class='hostDown'>" . __('System') . ' ' . __('SNMP error');
if ($snmp_error != '') {
print " - $snmp_error";
}
print '</span>';
} else {
/* modify for some system descriptions */
/* 0000937: System output in host.php poor for Alcatel */
if (substr_count($snmp_system, '00:')) {
$snmp_system = str_replace('00:', '', $snmp_system);
$snmp_system = str_replace(':', ' ', $snmp_system);
}
if ($snmp_system == '') {
print "<span class='hostDown'>" . __('Host') . ' ' . __('SNMP error');
if ($snmp_error != '') {
print " - $snmp_error";
}
'</span>';
} else {
$snmp_uptime = cacti_snmp_session_get($session, '.1.3.6.1.6.3.10.2.1.3.0');
if (!empty($snmp_uptime)) {
$snmp_uptime *= 100;
} else {
$snmp_uptime = cacti_snmp_session_get($session, '.1.3.6.1.2.1.1.3.0');
}
$snmp_hostname = cacti_snmp_session_get($session, '.1.3.6.1.2.1.1.5.0');
$snmp_location = cacti_snmp_session_get($session, '.1.3.6.1.2.1.1.6.0');
$snmp_contact = cacti_snmp_session_get($session, '.1.3.6.1.2.1.1.4.0');
print '<strong>' . __('System:') . '</strong> ' . html_split_string($snmp_system) . '<br>';
$snmp_uptime_ticks = intval($snmp_uptime);
$days = intval($snmp_uptime_ticks / (60*60*24*100));
$remainder = $snmp_uptime_ticks % (60*60*24*100);
$hours = intval($remainder / (60*60*100));
$remainder = $remainder % (60*60*100);
$minutes = intval($remainder / (60*100));
print '<strong>' . __('Uptime:') . "</strong> $snmp_uptime";
print '&nbsp;(' . $days . __('days') . ', ' . $hours . __('hours') . ', ' . $minutes . __('minutes') . ')<br>';
print '<strong>' . __('Hostname:') . "</strong> $snmp_hostname<br>";
print '<strong>' . __('Location:') . "</strong> $snmp_location<br>";
print '<strong>' . __('Contact:') . "</strong> $snmp_contact<br>";
}
}
$session->close();
}
}
print '</span><br>';
}
if ($am == AVAIL_PING || $am == AVAIL_SNMP_AND_PING || $am == AVAIL_SNMP_OR_PING) {
$anym = true;
/* create new ping socket for host pinging */
$ping = new Net_Ping;
$ping->host = $host;
$ping->port = $host['ping_port'];
/* perform the appropriate ping check of the host */
$ping_results = $ping->ping(AVAIL_PING, $host['ping_method'], $host['ping_timeout'], $host['ping_retries']);
if ($ping_results == true) {
$host_down = false;
$class = 'hostUp';
} else {
$host_down = true;
$class = 'hostDown';
}
print __('Ping Results') . "<br>\n";
print "<span class='" . $class . "'>" . $ping->ping_response . "</span>\n";
}
if ($anym == false && $host['disabled'] != 'on') {
print __('No Ping or SNMP Availability Check in Use') . "<br><br>\n";
}
}
Reference in new issue View Git Blame Copy Permalink