# lsfMonitor

**Repository Path**: jevonryan/lsfMonitor

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 2
- **Created**: 2021-11-11
- **Last Updated**: 2021-11-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

Thanks for downloading lsfMonitor.

lsfMonitor is an open source software for LSF data-collection,
data-analysis and information-display.


The tool use flow is as below:
installation -> configuration -> sampling -> monitoring


INSTALLATION:
To install it, make sure you have Python 3.5 (or greater version) installed,
you can also install Anaconda3-5.2.0 (or greater version) to solve packge
dependency. Then run below command to install it:
Come into install directory, then execute below command.

    python3 install.py


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

    dbPath      = "***/db"

"dbPath" is used to save database files, default is on <LSFMONITOR_INSTALL_PATH>/db,
you can re-point it into your own path.


SAMPLING:
Use monitor/bin/bsample sample job/queue data first, then bmonitor
can show the job/queue info with saved database.
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:<BSUB_PATH>
*/5 * * * * <LSFMONITOR_INSTALL_PATH>/monitor/bin/bsample -j
*/5 * * * * <LSFMONITOR_INSTALL_PATH>/monitor/bin/bsample -q
*/5 * * * * <LSFMONITOR_INSTALL_PATH>/monitor/bin/bsample -l

Suggested sampling frequency is 5 minutes.


BMONITORING:
Execute below command to start LSF monitor function.
<LSFMONITOR_INSTALL_PATH>/monitor/bin/bmonitor


LICENSE:
This tool use "GNU GENERAL PUBLIC LICENSE (Version 2)" license.
For more details please see file "LICENSE".


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


VERSION:
21.4


AUTHOR:
liyanqing


OTHERS:
Please contact liyanqing1987@163.com if any issue or question.