ServerStatus is a full rewrite of mojeda's ServerStatus script, which in turn is a modified version of BlueVM's script.
There are many things which I dislike about the original script, for example:
- requires webserver and PHP for every client
- querys clients for every user that visits the site
- hangs when said clients don't respond
- loading slow with many servers
- messy codebase
- progress bar animation skips
- setup process complicated
Therefore I made my own ServerStatus which is quite different than the others under the hood, but still looks as nice!
The way my ServerStatus works is as following:
- Master server listens on port 35061 TCP
- Clients connect to the master server
- Clients generate statistics and send it to the master server periodically (eg. every second)
- Master server writes summarized stats to web-dir/json/stats.json
- Users load HTML page with JavaScript, which fetches the stats.json every two seconds and updates the table
Name "sergate" given by Dasiel :)
Switch to a non-privileged user or create one. Port 35601 needs to be free and forwarded/open for running the server.
git clone https://github.com/BotoX/ServerStatus.git
cd ServerStatus/server
make
./sergate
If everything goes well you can move on to the next step!
Simply edit the config.json file, it's self explanatory.
{"servers":
[
{
"username": "s01",
"name": "Mainserver 1",
"type": "Dedicated Server",
"host": "GenericServerHost123",
"location": "Austria",
"password": "some-hard-to-guess-copy-paste-password"
},
]
}
If you want to temporarily disable a server you can add
"disabled": true
There are also some command line switches which you should be aware of. Simply add the -h switch when running the binary to find out!
-h, --help Show this help message and exit
-v, --verbose Verbose output
-c, --config=<str> Config file to use
-d, --web-dir=<str> Location of the web directory
-b, --bind=<str> Bind to address
-p, --port=<int> Listen on port
Also, don't forget to copy/move the web directory (ServerStatus/status) to a place where your webserver can find it.
You could manually run the master server, but using a startup script is preferred.
Copy the init.d script to /etc/init.d
cp ServerStatus/other/sergate.initd /etc/init.d/sergate
Edit it with your favourite text editor and change the following lines according to your setup:
# Change this according to your setup!
DAEMON_PATH="/usr/local/share/ServerStatus/server"
WEB_PATH="/var/www/botox.bz/status"
DAEMON="sergate"
OPTS="-d $WEB_PATH"
RUNAS="www-data"
Start the service by running as root
service sergate start
Add it to the autostart by running as root
update-rc.d sergate defaults
Copy the systemd service to /etc/systemd/system
cp ServerStatus/other/sergate.service /etc/systemd/system/sergate.service
Edit it with your favourite text editor and change the following lines according to your setup:
WorkingDirectory=/usr/local/share/ServerStatus/server
User=botox.bz
Group=http
ExecStart=/usr/local/share/ServerStatus/server/sergate -d /home/botox.bz/status
Start the service by running as root
systemctl start sergate
Add it to the autostart by running as root
systemctl enable sergate
Make sure that the user which runs the master server has access to the web path and can write to $WEB_PATH/json.
There are two client implementations at the moment:
- Python2 [preferred]
- Python2-psutil
- Bash
All three scripts are fully supported and as easy to set up. More implementations will follow, feel free to create one and make a pull request.
While the Python2 and Bash clients only support GNU/Linux, Python2-psutil supports a wide range of operating systems, such as BSD or Windows, see Python2-psutil
The bash script client-setup.sh in other/ is an easy way to set up a new client. You need to have wget and ca-certificates (or use wget --no-check-certificate) installed for it to work. You could run it like this:
wget https://raw.github.com/BotoX/ServerStatus/master/other/client-setup.sh
bash client-setup.sh
The script will also detect wether you're using systemd or SysVinit and ask you wether it should create a service/autostart for the client. You can also use this script to easily update the already installed one.
With your favourite text editor change the following lines according to your setup:
SERVER = "status.botox.bz"
PORT = 35601
USER = "s01"
PASSWORD = "some-hard-to-guess-copy-paste-password"
INTERVAL = 1 # Update interval
SERVER = "status.botox.bz"
PORT = 35601
USER = "s01"
PASSWORD = "some-hard-to-guess-copy-paste-password"
INTERVAL = 1 # Update interval
This client can be run on all operating systems supported by the psutil project.
It will also work on Windows, either use the precompiled and self-contained version or install Python2 and psutil. The precompiled version has been built using py2exe. The setup script is included if you want to build it yourself. After installing all the dependencies run "python setup.py py2exe" and hope.
The windows configuration works different to make the precompiled and self-contained version possible. Edit the client.cfg file according to your setup:
[client]
SERVER = status.botox.bz
PORT = 35601
USER = s01
PASSWORD = some-hard-to-guess-copy-paste-password
INTERVAL = 1
SERVER="status.botox.bz"
PORT=35601
USER="s01"
PASSWORD="some-hard-to-guess-copy-paste-password"
INTERVAL=1 # Update interval
After you've verified that the client configuration is correct, by running it, you can either make it start automatically by a startup script or cronjob, or just start it manually:
nohup ./client.py &> /dev/null &
Simply add something like this to /etc/rc.local:
su -l $USERNAME -c "/path/to/client.py &> /dev/null &"
Create a new systemd service by creating the file /etc/systemd/system/serverstatus.service with similar content:
[Unit]
Description=ServerStatus Client
After=network.target
[Service]
Type=simple
IgnoreSIGPIPE=no
User=$USERNAME
ExecStart=/path/to/client.py
[Install]
WantedBy=multi-user.target
IgnoreSIGPIPE=no is important for the bash client, when this line is missing it wont reconnect and flood the journal with broken pipe errors.
You don't have to worry about the clients in case the master server goes down, they will keep trying to reconnect until they can reach the master server again.
For questions you can contact me via IRC. You can find me under the nick BotoX in the following networks: Freenode, QuakeNet, Rizon, synIRC and StormBit
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
Version 2, December 2004
Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>
Everyone is permitted to copy and distribute verbatim or modified
copies of this license document, and changing it is allowed as long
as the name is changed.
DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
0. You just DO WHAT THE FUCK YOU WANT TO.
If you plan on modifying this project I'd be happy if you let me know!
Obviously the original script from BlueVM and mojeda's fork.
I'd also like to thank the Teeworlds project for some of the code which has been used in this project.