1 | the latest stable pbs_python interface is available from: |
---|
2 | ftp://ftp.surfsara.nl/pub/outgoing/pbs_python.tar.gz |
---|
3 | |
---|
4 | Information, documentation and reporting bugs for the package: |
---|
5 | https://oss.trac.surfsara.nl/oss/pbs_python |
---|
6 | |
---|
7 | bug resport: |
---|
8 | pbs_python@surfsara.nl |
---|
9 | |
---|
10 | =============== Brief description ============================= |
---|
11 | Pbs_python interface is a wrapper class for the OPENPBS/TORQUE |
---|
12 | C LIB API. Now you can write utilities/extensions in Python |
---|
13 | instead of C. |
---|
14 | |
---|
15 | The 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 | |
---|
29 | In the past our Alpha cluster was redhat (6.2) and we had to |
---|
30 | add '-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 | |
---|
44 | The test programs are include as a reference how to use the pbs |
---|
45 | python module. You have to edit some test programs to reflect |
---|
46 | your PBS/Torque installation. |
---|
47 | |
---|
48 | pbsmon.py - ascii xpbsmon |
---|
49 | rack_pbsmon.py - ascii xpbsmon by rack layout |
---|
50 | pbsnodes-a.py - pbsnodes -a |
---|
51 | pbs_version.py - print server version |
---|
52 | set_property.py - set some node properties |
---|
53 | resmom_info.py - queries the pbs_mom daemon on the nodes |
---|
54 | logpbs.py - Shows the usage of the PBS logging routines |
---|
55 | new_interface.py - Example how to use PBSQuery module |
---|
56 | PBSQuery.py - python <install_path>/PBSQuery.py (has builtin demo) |
---|
57 | |
---|
58 | sara_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 | |
---|
63 | pbs_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 | |
---|
67 | pbs_joblogin - logs in to the node as the user who invokes this script |
---|
68 | (os.getenv('USER')) |
---|
69 | |
---|
70 | For more info about SARA see: |
---|
71 | http://www.surfsara.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 | ******************************************************************** |
---|