A remake of LowEndPing, now with better code!
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
app
bootstrap
daemon
public
.gitignore
artisan
composer.json
composer.lock
index.php
phpunit.xml
readme.md
server.php

readme.md

LowEndPing Network Status

LowEndPing is a simple network query script.

Installation:

  • Install Composer
  • Download the contents and extract into a directory
  • Run "composer install" in that directory
  • Run "php artisan migrate" to initialize the database
  • Install the python script on the servers you want (see below)
  • Edit app/config/lowendping.php and add the servers (Numeric keys are required, and it is recommended to keep them in order), and optionally disable the archive
  • Add "cd /path/to/lowendping; php artisan lowendping:archive" to a cron job, every hour or daily would be fine. This is required even without the archive to clean up old queries.
  • Edit your webserver configuration and set the document root to (install dir)/public, then add a rewrite rule for laravel (Use google, there's plenty out there)
  • Try it out!

Python script installation:

  • Install python, python-pip, and mtr-tiny
  • Run 'pip install sh' (the required shell wrapper) and 'pip install ipaddress' (required only if python 2.7 instead of python 3)
  • Update the information in lepconf.py to point to your server and define an auth token
  • Run 'python lep.py' (It is recommended to run it as a user other than root of course)

Websockets

Websockets will allow LowEndPing to give instant responses. It requires a bit more configuration, and is probably only really worth it when running a LowEndPing installation with more than 10 servers or a lot of traffic.

To use Websockets, install the following packages (along with a c compiler, gcc will work just fine):

Debian:

apt-get install libzmq1 libzmq-dev

Then, install php-zmq

git clone git://github.com/mkoppanen/php-zmq.git
cd php-zmq
phpize && ./configure
make && make install
echo "extension=zmq.so" > /etc/php5/conf.d/zmq.ini

To install the libraries needed in PHP you must add the following to composer.json's "require" section, and run "composer update"

"cboden/Ratchet": "0.3.*",
"react/zmq": "0.2.*"

And then start "php artisan lowendping:websocket" and restart your webserver/php5.

Then, set websocket.enabled to "true" in app/config/lowendping.php, and modify the port if you wish. Websockets should now work, verify it by opening your url and the Network console in Chrome/Firefox, and watch for "Switching Protocols" when submitting a query.

It is also suggested to start the server using supervisord, just any standard config running the above command will work.

License

The Laravel framework is open-sourced software licensed under the MIT license

LowEndPing is also open-source and licensed under the same license.