source: trunk/README @ 282

Last change on this file since 282 was 282, checked in by bas, 11 years ago

renamed some file and added documentation

  • Property svn:keywords set to Id
File size: 3.0 KB
Line 
1the latest stable pbs_python interface is available from:
2    ftp://ftp.sara.nl/pub/outgoing/pbs_python.tar.gz
3
4Information, documentation and reporting bugs for the package:
5    https://subtrac.sara.nl/oss/pbs_python
6
7bug resport:
8    pbs_python@sara.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  - Intel cluster debian GNU/LINUX woody/sarge OPENPBS 2.3.16,
18    TORQUE 1.0.1p4, 1.1.0p4 and up
19
20  - For X86_64 systems you have to compile torque/openpbs with
21    the -fPIC option. Else you can not build the python module
22
23  - TRU64 system, NOTE: must rename libnet.a to libpbs_net.a and
24    edit setup.py to reflect the change. There is also a system wide
25    libnet.so.
26
27  - It should run on different OSes.
28
29In the past our Alpha cluster was redhat (6.2)  and we had to
30add '-lots' to the LIBS line
31
32-- Compile and install the package: (Require python 2.1 and higher)
33
34  As for python version 1.6 and higher the procedure is:
35    ./configure
36    make
37    make install
38
39  Debian package:
40    debian/rules binary
41
42--- Testing the package:
43
44The test programs are include as a reference how to use the pbs
45python module. You have to edit some test programs to reflect
46your PBS/Torque installation.
47
48pbsmon.py        - ascii xpbsmon
49rack_pbsmon.py   - ascii xpbsmon by rack layout
50pbsnodes-a.py    - pbsnodes -a
51pbs_version.py   - print server version
52set_property.py  - set some node properties
53resmom_info.py   - queries the pbs_mom daemon on the nodes
54logpbs.py        - Shows the usage of the PBS logging routines
55new_interface.py - Example how to use PBSQuery module
56PBSQuery.py      - python <install_path>/PBSQuery.py (has builtin demo)
57
58sara_nodes.py    - We use this program to set the nodes offline/online. when
59                   there are no command line arguments. It will list the
60                   nodes that are down/oflline. For more info see:
61                    - https://subtrac.sara.nl/oss/pbs_python/wiki/TorqueExamples
62
63pbs_jobmonitor   - Shows the output of top -u user on the node:
64                     * one cycle of top
65                     * user: the user the job belongs to
66
67pbs_joblogin     - logs in to the node as the user who invokes this script
68                   (os.getenv('USER'))
69
70For more info about SARA see:
71    http://www.sara.nl/index_eng.html
72
73--
74********************************************************************
75*                                                                  *
76*  Bas van der Vlies                     e-mail: basv@sara.nl      *
77*  SARA - Academic Computing Services    phone:  +31 20 592 8012   *
78*  Kruislaan 415                         fax:    +31 20 6683167    *
79*  1098 SJ Amsterdam                     WWW:    www.sara.nl       *
80*                                                                  *
81********************************************************************
Note: See TracBrowser for help on using the repository browser.