source: trunk/README @ 290

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

changes sara to SURFsara

  • Property svn:keywords set to Id
File size: 3.0 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
[73]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
[144]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.
[44]26
[19]27  - It should run on different OSes.
[8]28
[144]29In the past our Alpha cluster was redhat (6.2)  and we had to
30add '-lots' to the LIBS line
[25]31
[144]32-- Compile and install the package: (Require python 2.1 and higher)
[61]33
[21]34  As for python version 1.6 and higher the procedure is:
[68]35    ./configure
36    make
37    make install
[8]38
[90]39  Debian package:
40    debian/rules binary
[71]41
[19]42--- Testing the package:
[8]43
[130]44The test programs are include as a reference how to use the pbs
[19]45python module. You have to edit some test programs to reflect
[130]46your PBS/Torque installation.
[8]47
[72]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
[73]56PBSQuery.py      - python <install_path>/PBSQuery.py (has builtin demo)
[8]57
[255]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
[282]60                   nodes that are down/oflline. For more info see:
61                    - https://subtrac.sara.nl/oss/pbs_python/wiki/TorqueExamples
[255]62
[282]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
[49]70For more info about SARA see:
[290]71    http://www.surfsara.nl/index_eng.html
[26]72
[282]73--
[8]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.