Wrapper for Symcon function calls to be executed via JSON API.
This wrapper helps you to execute scripts written for Symcon also on other PHP boxes using Symcon JSON API. It defines all known functions and map this to a JSON call. ips_wrapper.php will be generated using gen_ips_wrapper.php
Download: GitHub Branch 7.0
Usage:
if (!function_exists('IPS_GetKernelVersion')) {
include('ips_wrapper.php');
}
print $version;
IPS_GetKernelVersion()
IPS_GetKernelVersion.
Definition ips_wrapper.php:4589
- Precondition
- Prepare
- download IPS_JSON.php and gen_ips_wrapper.php from GitHub
- install MBString and JSON extension for PHP
- enable IPS remote access from IPS Tray
- create a new script object with the content of gen_ips_wrapper.php in Symcon console
- run this script as usual
- grab the generated ips_wrapper.php file from Symcon scripts folder
- All ips function headers are listed in ips_wrapper.php. You need to include the class file IPS_JSON.php as well.
- you may create an additional file IPS_JSON_config.cfg which will summarize your JSON API settings as below. This will have precedence over the generated values.
$config='IPS_JSON_config.cfg';
$host='localhost';
$port='3777';
$user='license username/email';
$password='remote-access';
Examples:
general examples
- test_ips_wrapper.php: simple test function call
- IPS_JSON_config.cfg: configuration file example
- run_ips_script.pl: Perl example to start an IPS internalscript
- run_ips_script.php: PHP example to start an IPS internalscript
Icinga/Nagios examples:
- check_ips_json.php: simple php check script for Icinga/Nagios
- check_ips_json.pl: simple perl check script for Icinga/Nagios
- check_ips_temperature_json.pl: read an IPS temperature sensor for Icinga/Nagios
- check_ips_sample_json.txt: icinga/nagios check configuration steps
More readings (in german):