# openlavaMonitor

**Repository Path**: siwen1017/openlavaMonitor

## Basic Information

- **Project Name**: openlavaMonitor
- **Description**: A toop for openlava data-collection, data-analysis and information display.
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2020-03-21
- **Last Updated**: 2020-12-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

openlavaMonitor is an open source software for openlava data-collection,
data-analysis and information-display.


The tool use flow is as below:
install -> configuration -> sampling -> bmonitor


INSTALL:
Come into install directory, then execute below command.

    python setup.py development.

For more details please see file "INSTALL".


CONFIGURATION:
After installing the tool, come into <INSTALL>/monitor/conf directory,
then update file config.py for your own configuration.

    installPath = "***"
    dbPath      = "***/db"
    tempPath    = "***/temp"

"installPath" is the install path, don't edit it.
"dbPath" is used to save database files, default is on <INSTALL>/db,
you can re-point it into your own path.
"tempPath" is used to save temporary files, default is on
<INSTALL_PATH>/temp, you can re-point it into your own path.


SAMPLING:
Use monitor/bin/bsample.py sample job/queue data first, then bmonitor
can show the job/queue info with saved data base.
Below is the suggested crontab setting on sampling data.

SHELL=/bin/csh
PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
*/10 * * * * <INSTALL_PATH>/monitor/bin/bsample.py -j
*/10 * * * * <INSTALL_PATH>/monitor/bin/bsample.py -q

Suggested sampling frequency is 10 minutes.
You can also sample host/load/user info with bsample.py.


BMONITOR:
Execute below command to start openlava monitor function.
<INSTALL_PATH>/monitor/bin/bmonitor


LICENSE:
This tool use "MIT" license.
For more details please see file "LICENSE".


DOC:
For more documents please see files under "docs".