HBMonv2/README.md

118 lines
4.4 KiB
Markdown
Raw Normal View History

2020-12-31 09:15:44 -05:00
**HBmonitor is a "web dashboard" for HBlink by N0MJS.**
2021-01-01 04:45:28 -05:00
***This is version of HBMonitor V2 by SP2ONG 2019-2021***
2020-12-31 09:15:44 -05:00
2021-01-01 08:23:07 -05:00
The main difference between HBMonitor v1 and v2 is the layout, i.e. the main page shows condensed
information and on the subpages, you can see the individual content that was shown on v1
2020-12-31 09:15:44 -05:00
I recommend not running HBmonitor on the same computer as HBlink3
2021-01-01 04:45:28 -05:00
HBmonitor tested on Debian v9 and v10
2020-12-31 09:15:44 -05:00
2021-05-18 11:15:53 -04:00
This version of HBMonv2 requires a web server like apache2, lighttpd and
2021-05-21 01:02:20 -04:00
php support running on the server.
2021-05-18 11:15:53 -04:00
2020-12-31 09:15:44 -05:00
cd /opt
git clone https://github.com/sp2ong/HBMonv2.git
cd HBMonv2
chmod +x install.sh
./install.sh
cp config-SAMPLE.py config.py
edit config.py and change what you necessary
2021-05-18 11:15:53 -04:00
You need to copy the contents of the /opt/HBMonv2/html directory to
the web server directory. Suppose your web server is available
as http://dmrserver.org, copy the file to for example /var/www/html
If you copy files to /var/www/html/hbmon, HBMonitor will be
accessible from http://dmrserver.org/hbmon
You can copy to /var/www/hbmon and start HBMonitor access by configuring
2021-05-19 01:08:11 -04:00
virtual the web server for subdomains e.g. hbmon.dmrserver.org
2021-05-18 11:15:53 -04:00
the access will then be http://hbmon.dmrserver.org
In the html/include/ directory there is a config.php file in which you
set the color theme and name for your Dashboard.
In the html/include/config.php you can defined height of Server Activity
2021-06-03 14:13:39 -04:00
window: 45px; 1 row, 60px 2 rows, 80px 3 rows:
define("HEIGHT_ACTIVITY","45px");
2021-05-18 11:15:53 -04:00
In the html directory there is a buttons.html file that you can tune to menu keys
2021-05-19 01:14:31 -04:00
The logo image you can replace with file image in html directory img/logo.png
cp utils/lastheard /etc/cron.daily/
chmod +x /etc/cron.daily/lastherad
2020-12-31 09:15:44 -05:00
cp utils/hbmon.service /lib/systemd/system/
systemctl enable hbmon
systemctl start hbmon
systemctl status hbmon
2021-05-18 11:15:53 -04:00
forward TCP port 9000 and web server port in firewall
2020-12-31 09:15:44 -05:00
2021-02-22 07:15:46 -05:00
Please setup your SYSTEM INFO subpage with the following instruction:
2021-02-16 07:02:11 -05:00
https://github.com/sp2ong/HBMonv2/tree/main/sysinfo
2021-05-19 01:14:31 -04:00
Please remember the table lastheard displays only station transmissions
2021-06-07 10:45:57 -04:00
that are longer than 2 sec.
use >=0 instead of >2 if you want to record all activities in line:
if int(float(p[9])) > 2:
2021-05-18 11:15:53 -04:00
2020-12-31 09:15:44 -05:00
If you want to have more than the last 15 entries in the Lastherad table
2021-05-20 03:33:44 -04:00
change in the monitor.py file line from:
# maximum number of lists in lastheard on the main page
2021-06-07 10:32:30 -04:00
if n == 15:
2020-12-31 09:15:44 -05:00
to for example:
2021-05-20 03:33:44 -04:00
if n == 25:
2021-01-06 11:46:52 -05:00
2021-05-19 01:14:31 -04:00
I recommend that you do not use the BRIDGE_INC = True option to display bridge information
(if you have multiple bridges displaying this information will increase the CPU load,
try to use BRIDGES_INC = False in config.py)
2021-05-21 00:55:42 -04:00
***************************************************************************************
2021-06-01 07:37:58 -04:00
The HBMonv2 version without use external web server like apache2 etc is still available:
2021-05-21 00:55:42 -04:00
cd /opt
git clone https://github.com/sp2ong/HBMonv2.git
cd HBMonv2
git checkout webserver-python
chmod +x install.sh
./install.sh
cp config-SAMPLE.py config.py
edit config.py and change what you necessary
cp utils/hbmon.service /lib/systemd/system/
systemctl enable hbmon
systemctl start hbmon
systemctl status hbmon
forward TCP port 9000 and web server port 8080 in firewall
*****************************************************************************************
2020-12-31 09:15:44 -05:00
2021-01-01 04:45:28 -05:00
---
**hbmonitor3 by KC1AWV**
Python 3 implementation of N0MJS HBmonitor for HBlink https://github.com/kc1awv/hbmonitor3
---
Copyright (C) 2013-2018 Cortney T. Buffington, N0MJS <n0mjs@me.com>
2021-05-18 11:15:53 -04:00
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 3 of
the License, or (at your option) any later version.
2021-01-01 04:45:28 -05:00
2021-05-18 11:15:53 -04:00
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.
2021-01-01 04:45:28 -05:00
2021-05-18 11:15:53 -04:00
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
02110-1301 USA
2021-01-01 04:45:28 -05:00
---