source: trunk/pbs_swig/distro/README @ 73

Last change on this file since 73 was 73, checked in by bas, 19 years ago

pbs_swig/distro:

  • Changed the documentation

new_interface.py:

  • Removed sys module
  • Property svn:keywords set to Id
File size: 3.2 KB
Line 
1the latest stable pbs_python interface is available from:
2        ftp://ftp.sara.nl/pub/outgoing/pbs_python.tar.gz
3
4Pbs_python interface is a wrapper class for the OPENPBS/TORQUE C LIB API.
5Now you can write utilities/extensions in Python instead of C. 
6
7The Python wrapper class is tested on:
8
9  - Intel cluster debian GNU/LINUX woody/sarge OPENPBS 2.3.16,
10    TORQUE 1.0.1p4, 1.1.0p4 and up
11
12  - For X86_64 systems you have to compile torque/openpbs with
13    the -fPIC option. Else you can not build the python module
14
15  - Compaq Alpha cluster debian GNU/LINUX woody OPENPBS 2.3.16
16
17  - SGI Origin 3000: Irix 6.5, OPENPBS 2.3.16
18
19  - TRU64 system, NOTE: must rename libnet.a to libpbs_net.a and edit
20    setup.py to reflect the change. There is also a system wide libnet.so.
21
22  - It should run on different OSes.
23
24In the past our Alpha cluster was redhat (6.2)  and we had to add '-lots'
25to the LIBS line
26
27--- Compile and install the package:
28
29  As for python version 1.6 and higher the procedure is:
30    ./configure
31    make
32    make install
33
34--- For python versions lower the 1.6
35
36  Python versions lower then 1.6 do not have the distutils
37  package default in their installation. You can test it:
38    python
39    import distutils
40
41  If this succeed then use the above procedure else use the procedure below:
42    cd src
43    Adjust the Makefile to where you installed Python and OPENPBS libraries.
44    make
45
46    The python PBS module consists of the following files:
47      _pbs.so
48      pbs.py
49      pbs.pyc     ( will be generated from pbs.py. The first time you load
50                    the module).
51      PBSQuery.py ( This is an simple query module. To see how it works...
52                    python <install_path>/PBSQuery.py )
53
54    You can install these file in your own directory and use the PYTHONPATH
55    environment variable or install it in a system wide directory, eg:
56      /usr/lib/python1.5/site-packages
57
58--- Testing the package:
59
60The test programs are include as a reference how to use the PBS
61python module. You have to edit some test programs to reflect
62your PBS installation.
63
64pbsmon.py        - ascii xpbsmon
65rack_pbsmon.py   - ascii xpbsmon by rack layout
66pbsnodes-a.py    - pbsnodes -a
67pbs_version.py   - print server version
68set_property.py  - set some node properties
69resmom_info.py   - queries the pbs_mom daemon on the nodes
70logpbs.py        - Shows the usage of the PBS logging routines
71new_interface.py - Example how to use PBSQuery module
72PBSQuery.py      - python <install_path>/PBSQuery.py (has builtin demo)
73
74Comments,suggestions or bugfixes mail them to: Bas van der Vlies <basv@sara.nl>
75For more info about SARA see:
76        http://www.sara.nl/index_eng.html
77       
78
79********************************************************************
80*                                                                  *
81*  Bas van der Vlies                     e-mail: basv@sara.nl      *
82*  SARA - Academic Computing Services    phone:  +31 20 592 8012   *
83*  Kruislaan 415                         fax:    +31 20 6683167    *
84*  1098 SJ Amsterdam                     WWW:    www.sara.nl       *
85*                                                                  *
86********************************************************************
Note: See TracBrowser for help on using the repository browser.