@@ -4,11 +4,39 @@ PythonMiniProbe
44Current Status: BETA
55MiniProbe POC for PRTG Network Monitor written in Python which accesses the MiniProbe Interface on the PRTG Core Server.
66
7+ Build Status
8+ ------------
9+ [ ![ Build Status] ( https://travis-ci.org/PaesslerAG/PythonMiniProbe.svg?branch=development )] ( https://travis-ci.org/PaesslerAG/PythonMiniProbe )
10+
11+ IMPORTANT: Major changes in this branch. Please see Migration Howto below!
12+ Installation for this branch
13+ ----------------------------
14+ - Install python-dev and build-essential (or at least gcc) packages
15+ - Install pip as outlined here https://pip.pypa.io/en/latest/installing.html (pre Python 2.7.9)
16+ - Download either zip or clone repository
17+ - run command 'sudo python setup.py install' which will install all necessary packages
18+
19+ Migration Guide
20+ ---------------
21+ - Copy away file probe.conf
22+ - Stop the mini probe process
23+ - Delete the files /etc/init.d/probe and /etc/logrotate.d/probe (filenames might be prtgprobe as well)
24+ - Remove the /probe folder
25+ - Install python-dev and build-essential (or at least gcc) packages
26+ - Install pip as outlined here https://pip.pypa.io/en/latest/installing.html (pre Python 2.7.9)
27+ - Download either zip or clone repository
28+ - Run command 'sudo python setup.py install' which will install all necessary packages and will run the configuration
29+ - [ optional] Run 'install.sh' to skip the 4 steps above
30+ - Copy the gid line from your old probe.conf to the new probe.conf at /probe/miniprobe/probe.conf
31+ - Start the mini probe process, the mini probe will connect with the previous GID and continue monitoring
32+ IMPORTANT: If replacing the new probe.conf with the old one, make sure the line 'subprocs:10' is present in the file!
33+
34+
735Prerequisites
836-----------------
937Debian based system (tested on Ubuntu, Debian, Raspbian)
1038Python 2.7+
11- Needed modules are delivered with the probe package :
39+ Needed modules are installed using the setup.py install phase :
1240- pyasn1 (https://pypi.python.org/pypi/pyasn1/0.1.7 )
1341- pysnmp (https://pypi.python.org/pypi/pysnmp/4.2.5 )
1442- requests (https://pypi.python.org/pypi/requests/2.5.3 )
@@ -21,7 +49,7 @@ Installation
2149- make sure you can reach the PRTG web interface from the machine the mini probe should run on (e.g. wget https://YOUR_PRTG_SERVER )
2250 - This is tested during the setup
2351- copy the miniprobe folder to your linux machine
24- - run the probe installer (e.g. "python probe_installer .py")
52+ - run the probe installer (e.g. "sudo python setup .py install ")
2553
2654The miniprobe should now be started. You should also be able to start/stop the same using the command
2755
@@ -80,6 +108,17 @@ Changelog
80108=========
81109
82110=======
111+ 11-06-2015
112+ ----------
113+ MAJOR CHANGES:
114+ - restructuring project layout accoriding to pip compliance
115+ - removed included modules
116+ - added support for pip/reqirements.txt
117+ - for installation, see above "Installation for this branch"
118+ - added tests folder for future unit tests
119+ - dropped probe_installer.py, code moved to setup.py
120+ - added release
121+
8312207-05-2015
84123----------
85124- Finished the DNS Sensor for all dns types currently available in a Windows Probe
0 commit comments