diff --git a/README.md b/README.md index 80fce2c..636711b 100644 --- a/README.md +++ b/README.md @@ -63,6 +63,24 @@ sudo systemctl enable 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 ``` git status diff --git a/util/NOTE.md b/util/NOTE.md new file mode 100644 index 0000000..536ea96 --- /dev/null +++ b/util/NOTE.md @@ -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)