You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
70 lines
3.0 KiB
70 lines
3.0 KiB
##### 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
|
|
features with the ./qnconfig menu. Don't set the refresh time faster than about
|
|
10 seconds. If you do, it will become difficult to use the Send URCall button.
|
|
|
|
By default, the installed web server will use ip/port 0.0.0.0:80. If you want
|
|
to use something else, the copy the qndash service file:
|
|
|
|
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
|
|
|
|
Note that this will install a php web server and all necessary packages needed
|
|
for the server.
|
|
|
|
To uninstall, run the following:
|
|
|
|
sudo make uninstalldash
|
|
|
|
These installed "necessary packages" are not uninstalled by the uninstall script.
|
|
It will only shut down the php web server.
|
|
|
|
Once the dashboard server is running, simply point a browser at the Hotspot's IP
|
|
address or at http://<hostname>.local/ (on the same subnet).
|
|
|
|
Please note that this is a very simple server and is not recommended for the
|
|
world wide web. If you want a robust dashboard accessible from the web, you
|
|
will want to use a hardened server, like apache, and a different index.php file.
|
|
|
|
Please note that if you are typing in a URCALL when the webpage is refreshing,
|
|
the entry field will loose focus and you'll have to try again.
|
|
|
|
#### DASHBOARD V2 ####
|
|
|
|
A new responsive dashboard built on the Bootstrap 4.5 framework has been
|
|
added. If you have configured the dashboard with the commands above you can
|
|
access the new dashboard by appending "/dashboardV2" to the URL. For example
|
|
http://<hostname>.local/dashboardV2
|
|
|
|
Notes:
|
|
The responsive dashboard currently has the following features
|
|
* Page does not have to reload to refresh its data solving the URCall focus issue
|
|
* Dashboard refresh is suggested to be set at 10 seconds. Any value less than 8 will
|
|
have no effect.
|
|
* Mobile design friendly. On smaller screens some columns in the tables will be
|
|
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
|