herberthhc / lsfmonitor Goto Github PK

Thanks for downloading lsfMonitor.

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


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


INSTALLATION:
To install it, make sure you have Python 3.8.8 installed, you can also install 
Anaconda3-2021.05 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.

    db_path = ""
    lmstat_path = ""
    lmstat_bsub_command = ""

"db_path" is used to save database files, default is on <LSFMONITOR_INSTALL_PATH>/db,
you can re-point it into your own path.
"lmstat_path" is used to specify lmstat path, it is for LICENSE tab.
"lmstat_bsub_command" is used to specify LSF command for lmstat, for example, "bsub -q
normal -Is". (It is forbidden to run lmstat on login server.)


SAMPLING:
Use monitor/bin/bsample sample job/queue/load/utilization data first, then bmonitor
can show the job/queue/load/utilization 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
0 * * * * <LSFMONITOR_INSTALL_PATH>/monitor/bin/bsample -U


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".


AUTHOR:
liyanqing


OTHERS:
Please contact [email protected] if any issue or question.