Added documentation

only_http
John Hays 9 months ago
parent e5508058d6
commit c3b2a8574d

@ -63,6 +63,24 @@ sudo systemctl enable dsgwdashboard
sudo systemctl start dsgwdashboard sudo systemctl start dsgwdashboard
``` ```
Please read [note](util/NOTE.md) for some additional operational detail.
Some routine maintenance can be automated by copying [reloadhosts](util/reloadhosts) into */usr/local/bin*
```
cp util/reloadhosts /usr/local/bin
```
then modify your crontab
```
sudo crontab -e
```
and adding the lines
```
0 0 * * * : > /var/log/dstargateway/Headers.log
0 0 * * * /usr/local/bin/reloadhosts
```
What this does is, at midnight every night, it truncates the /var/log/dstargateway/Headers.log, which will grow very long overtime and slow down the initial population of the dashboard. Then reloadhosts, will pull down current updated files for reflectors and their associated addresses, and restart the gateway so that the new addresses are cached.
This program is still under development, but you are welcome to try it out. Consider it alpha code and refresh it periodically by going into the dsgwdashboard directory and This program is still under development, but you are welcome to try it out. Consider it alpha code and refresh it periodically by going into the dsgwdashboard directory and
``` ```
git status git status

@ -0,0 +1,39 @@
I have localized all of the configuration files in **/usr/local/etc:
**dashboard.ini** - configuration for the dashboard (with some values also take from dstargateway.cfg)
**dgwremotecontrol.cfg** - configure remote control port and password
**dgwtimeserver.cfg** - this controls time announcements and other parameters
**dstargateway.cfg** - configure the gateway itself**
The program **systemctl** is how your manage these services (as root using sudo) there are five functions which you will typically control
**enable** - turning on automatic startup when you reboot the system
**status** - tells you the current status of the service
**start** - start up a service that is currently inactive
**stop** - stop an active service
**restart** - issues a stop followed by a start
**disable** - turning off automatic startup when reboot
for example:
**sudo systemctl status dsgwdashboard
sudo systemctl enable dsgwdashboard
sudo systemctl start dsgwdashboard
sudo systemctl stop dsgwdashboard
sudo systemctl restart dsgwdashboard
sudo systemctl disable dsgwdashboard**
sudo systemctl status dgwtimeserver
**sudo systemctl enable dgwtimeserver
sudo systemctl start dgwtimeserver
sudo systemctl stop dgwtimeserver
sudo systemctl restart dgwtimeserver
sudo systemctl disable dgwtimeserver**
and so forth.
To view the systemctl manual - type
**man systemctl**
Also spend some time with https://github.com/F4FXL/DStarGateway/README.md (and the README.md in each subdirectory)
Loading…
Cancel
Save