diff --git a/DASHBOARD.README b/DASHBOARD.README index 7dc32b7..b4730c6 100644 --- a/DASHBOARD.README +++ b/DASHBOARD.README @@ -1,5 +1,15 @@ ##### DASHBOARD.README ##### +-------------------------------------------------------------------------- + IMPORTANT! +This document describes how to install a dashboard server based on a php +mini-server and should not be used to publish a QnetGateway dashboard on +the world-wide-web. This mini-server for operating behind a firewall on +a local network. If you need your QnetGateway dashboard on the WWW, install +a real web server, like apache2. The mini-server described here is not +suitable for the WWW! +-------------------------------------------------------------------------- + A web-based dashboard can be enabled. The dashboard has several sections that you can display in any order. You can also control the refresh rate and how many rows you want in the Last Heard section. You can configure these @@ -13,6 +23,10 @@ cp system/qndash.service.80 system/qndash.service and edit your new file *before* installing the dashboard. +You also need several php libraries: + +sudo apt install -y php-common php-fpm sqlite3 php-sqlite3 dnsutils + To install the dashboard system, run the following command: sudo make installdash @@ -53,7 +67,3 @@ The responsive dashboard currently has the following features hidden, however, simply rotate your mobile device to landscape view and they should appear * QnRemote section (aka URCall section) has improved design for mobile device use - -Future improvements will be made to - * The layout to respect order of the dash_show_order configuration item - * Misc performance enhancements diff --git a/Makefile b/Makefile index 0da5bd5..cb2fcdb 100644 --- a/Makefile +++ b/Makefile @@ -99,8 +99,6 @@ installbase : $(BASE_PROGRAMS) gwys.txt qn.cfg /bin/cp -f qngateway $(BINDIR) /bin/cp -f qnremote qnvoice $(BINDIR) /bin/ln -f -s $(shell pwd)/qn.cfg $(CFGDIR) - /bin/ln -f -s $(shell pwd)/index.php $(WWWDIR) - /bin/ln -f -s $(shell pwd)/dashboardV2 $(WWWDIR) /bin/cp -f defaults $(CFGDIR) /bin/cp -f system/qngateway.service $(SYSDIR) systemctl enable qngateway.service @@ -205,11 +203,9 @@ installdtmf : qndtmf installdash : index.php /usr/bin/apt update - /usr/bin/apt install -y php-common php-fpm sqlite3 php-sqlite3 dnsutils mkdir -p $(WWWDIR) - mkdir -p dashboardV2/jsonData - /bin/ln -f -s $(shell pwd)/index.php $(WWWDIR) - /bin/ln -f -s $(shell pwd)/dashboardV2 $(WWWDIR) + /bin/rm -f $(WWWDIR)/* + /bin/ln -f -s $(shell pwd)/index.php $(shell pwd)/dashboardV2 $(WWWDIR) if [ ! -e system/qndash.service ]; then cp system/qndash.service.80 system/qndash.service; fi /bin/cp -f system/qndash.service $(SYSDIR) systemctl enable qndash.service @@ -328,7 +324,5 @@ uninstalldash : systemctl disable qndash.service /bin/rm -f $(SYSDIR)/qndash.service systemctl daemon-reload - /bin/rm -f $(WWWDIR)/index.php - /bin/rm -f $(WWWDIR)/dashboardV2 - /bin/rm -f $(CFGDIR)/qn.db - /bin/rm -rf dashboardV2/jsonData + /bin/rm -f $(WWWDIR)/* + /bin/rm -f dashboardV2/jsonData/*.json diff --git a/README.md b/README.md index cb1256a..0d6d056 100644 --- a/README.md +++ b/README.md @@ -3,12 +3,19 @@ QnetGateway The QnetGateway is an D-Star IRCDDB gateway application that supports MMDVMHost (and all of its supported repeater modems) as well as the DVAP Dongle, the DVRPTR_V1. It is *incredibly easy* to build and install the system. -QnetGateway now includes a dashboard with a last heard section. The lastheard section uses SQLite3, a light-weight database, so you will need a package to compile the gateway: +QnetGateway includes a dashboard with a last heard section. The lastheard section uses SQLite3, a light-weight database, so you will need a package to compile the gateway: ```bash sudo apt install libsqlite3-dev ``` +If you are going to install the dashboard, you need several libraries for php: + +```bash +sudo apt install -y php-common php-fpm sqlite3 php-sqlite3 dnsutils + +Be sure to read the DASHBOARD.README for more information. + QnetGateway is dual-stack capable. This means it can simultaneously connect to ircv4.openquad.net, which is IPv4 based (using 32-bit internet addresses) and to ircv6.openquad.net which is IPv6 based (using 128-bit internet address). If your hot-spot/reapeater has IPv6 access you can enable dual-stack operation (it's IPv4-only by default) and then take advantage of direct world-routable address. The potential benefit of IPv6 to routing is significant. The QnetGateway program includes support for Icom's Terminal Mode and Access Point mode. For more information, Terminal Mode turns off the RF portion of you radio and just uses the AMBE vocoder to convert between audio and AMBE data and then sends and receives that data through a USB serial cable. Access Point mode turns your Icom radio into a high power, simplex hot-spot. @@ -39,8 +46,6 @@ QnetGateway is free software; you can redistribute it and/or modify it under the Many thanks go to **Colby W1BSB**, **Will W4WWM** and **Carty KA2Y** for recent help, suggestions, discussion and criticisms of the Qnet*/MMDVMHost phase of this long-term project! Also thanks to Jonathan G4KLX for MMDVMHost. It gave QnetGateway access to a large number of D-Star compatible modems! -Finally, QnetGateway is brought to you by the folks at **QuadNet2 USA IRC Network**, but it should work on *any* IRCDDB network. - 73 Tom diff --git a/dashboardV2/jsonData/README b/dashboardV2/jsonData/README new file mode 100644 index 0000000..9731ecc --- /dev/null +++ b/dashboardV2/jsonData/README @@ -0,0 +1 @@ +This folder is for temporary data used by dashboardV2