source: trunk/README

Last change on this file was 339, checked in by bas, 9 years ago

applied PBSQuery patch to handle cpuid range for torque5, see #47

  • Property svn:keywords set to Id
File size: 2.3 KB
RevLine 
[60]1the latest stable pbs_python interface is available from:
[290]2    ftp://ftp.surfsara.nl/pub/outgoing/pbs_python.tar.gz
[8]3
[130]4Information, documentation and reporting bugs for the package:
[290]5    https://oss.trac.surfsara.nl/oss/pbs_python
[130]6
[161]7bug resport:
[290]8    pbs_python@surfsara.nl
[161]9
[144]10=============== Brief description =============================
11Pbs_python interface is a wrapper class for the OPENPBS/TORQUE
12C LIB API.  Now you can write utilities/extensions in Python
13instead of C. 
[60]14
[8]15The Python wrapper class is tested on:
[44]16
[339]17  - LISA cluster debian wheezy, torque 2.5.13
[336]18  - LTC test cluster debian wheezy, torque 5.0.1
19  - LTC test cluster centos 6, torque 5.0.1
[19]20  - It should run on different OSes.
[8]21
[144]22-- Compile and install the package: (Require python 2.1 and higher)
[61]23
[336]24  As for python version 2.1 and higher the procedure is:
[68]25    ./configure
26    make
27    make install
[8]28
[90]29  Debian package:
30    debian/rules binary
[71]31
[19]32--- Testing the package:
[8]33
[130]34The test programs are include as a reference how to use the pbs
[19]35python module. You have to edit some test programs to reflect
[130]36your PBS/Torque installation.
[8]37
[72]38pbsmon.py        - ascii xpbsmon
39rack_pbsmon.py   - ascii xpbsmon by rack layout
40pbsnodes-a.py    - pbsnodes -a
41pbs_version.py   - print server version
42set_property.py  - set some node properties
43resmom_info.py   - queries the pbs_mom daemon on the nodes
44logpbs.py        - Shows the usage of the PBS logging routines
45new_interface.py - Example how to use PBSQuery module
[73]46PBSQuery.py      - python <install_path>/PBSQuery.py (has builtin demo)
[8]47
[255]48sara_nodes.py    - We use this program to set the nodes offline/online. when
49                   there are no command line arguments. It will list the
[282]50                   nodes that are down/oflline. For more info see:
51                    - https://subtrac.sara.nl/oss/pbs_python/wiki/TorqueExamples
[255]52
[282]53pbs_jobmonitor   - Shows the output of top -u user on the node:
54                     * one cycle of top
55                     * user: the user the job belongs to
56
57pbs_joblogin     - logs in to the node as the user who invokes this script
58                   (os.getenv('USER'))
59
[49]60For more info about SARA see:
[290]61    http://www.surfsara.nl/index_eng.html
[26]62
[282]63--
[336]64Bas van der Vlies
65| Operations, Support & Development | SURFsara | Science Park 140 | 1098 XG  Amsterdam
66| T +31 (0) 20 800 1300  | bas.vandervlies@surfsara.nl | www.surfsara.nl |
Note: See TracBrowser for help on using the repository browser.