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
Line 
1the latest stable pbs_python interface is available from:
2    ftp://ftp.surfsara.nl/pub/outgoing/pbs_python.tar.gz
3
4Information, documentation and reporting bugs for the package:
5    https://oss.trac.surfsara.nl/oss/pbs_python
6
7bug resport:
8    pbs_python@surfsara.nl
9
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. 
14
15The Python wrapper class is tested on:
16
17  - LISA cluster debian wheezy, torque 2.5.13
18  - LTC test cluster debian wheezy, torque 5.0.1
19  - LTC test cluster centos 6, torque 5.0.1
20  - It should run on different OSes.
21
22-- Compile and install the package: (Require python 2.1 and higher)
23
24  As for python version 2.1 and higher the procedure is:
25    ./configure
26    make
27    make install
28
29  Debian package:
30    debian/rules binary
31
32--- Testing the package:
33
34The test programs are include as a reference how to use the pbs
35python module. You have to edit some test programs to reflect
36your PBS/Torque installation.
37
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
46PBSQuery.py      - python <install_path>/PBSQuery.py (has builtin demo)
47
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
50                   nodes that are down/oflline. For more info see:
51                    - https://subtrac.sara.nl/oss/pbs_python/wiki/TorqueExamples
52
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
60For more info about SARA see:
61    http://www.surfsara.nl/index_eng.html
62
63--
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.