Browse Source

Add first version of README

Sven Slootweg 10 years ago
  1. 32


@ -0,0 +1,32 @@
# pyLSA
A simple server statistics agent for Linux. Serves statistics over HTTP.
The goal is to keep it small and not require anything but the Python
standard libraries.
## Current status
**In development.** Most is already there, but it still needs stuff
like configuration file reading, authentication, etc.
## How does it work?
PySFX is used to create a self-extracting 'transparent' installer that
compiles psutil locally (without installing it system-wide), and then
puts all the files for pyLSA (including your config!) in place. It
automatically starts pyLSA afterwards, and if you run the installer
again, it'll detect that pyLSA is already installed, and run the
existing installation.
## How can I use it?
1. (in the future) Modify the `pylsa.conf` file in the `installer/`
2. Run ``.
3. Upload the created `` file to any server that you'd like
to run your statistics agent on.
4. Run the SFX on each of those servers. If you are root, it will create
an unprivileged user for PyLSA and run it as that user. If you are an
unprivileged user, it will run it as your user. Future attempts to start
pyLSA using the installer will behave the same.
5. Done!