Changes between Version 11 and Version 12 of WikiStart

Show
Ignore:
Timestamp:
06/03/11 00:45:27 (10 years ago)
Author:
mmatloka
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • WikiStart

    v11 v12  
    1313and control over Web Services. 
    1414 
     15== Download == 
     16 
     17DRMAA for Torque/PBS Pro is distributed as a source package which can be downloaded directly from [download:1 here] or via the [http://apps.man.poznan.pl/trac/pbs-drmaa/downloads Downloads] section. 
     18 
     19== SVN access == 
     20 
     21 
     22{{{ 
     23  $ svn co https://apps.man.poznan.pl/svn/pbs-drmaa/ 
     24}}} 
     25 
     26Please note the `./autogen.sh` and `./autoclean.sh` scripts which calls the autotools command chain in appropriate order. 
     27 
     28**note:** You need some [#dev_tools developer tools] to compile the svn version. Also the trunk version may not always compile. 
    1529 
    1630== Installation == 
     
    4054The value of the `keep_completed parameter denotes a number of 
    4155seconds jobs will have to wait in the queue after the completion (and 
    42 should be greater then ``pool_delay`` value in PBS DRMAA configuration_). 
     56should be greater then `pool_delay` value in PBS DRMAA configuration_). 
    4357It enables the DRMAA library to retrieve the information about finished 
    4458jobs. 
     
    4963== Configuration == 
    5064 
    51 During DRMAA session initialization (``drmaa_init``) library tries to read 
     65During DRMAA session initialization (`drmaa_init`) library tries to read 
    5266its configuration parameters from locations: 
    5367 
    54 * `PREFIX/etc/pbs_drmaa.conf,  
    55 * `~/.pbs_drmaa.conf 
    56 * and from file given in `PBS_DRMAA_CONF environment variable (if set to non-empty string). 
     68* `PREFIX/etc/pbs_drmaa.conf`,  
     69* `~/.pbs_drmaa.conf` 
     70* and from file given in `PBS_DRMAA_CONF` environment variable (if set to non-empty string). 
    5771 
    5872If multiple configuration sources are present then all configurations 
    5973are merged with values from user-defined files taking precedence 
    60 (in following order: `$PBS_DRMAA_CONF, `~/.pbs_drmaa.conf``, 
    61 `PREFIX/etc/pbs_drmaa.conf). 
     74(in following order: `PBS_DRMAA_CONF`, `~/.pbs_drmaa.conf`, 
     75`PREFIX/etc/pbs_drmaa.conf`). 
    6276 
    6377Currently recognized configuration parameters are: 
     
    7084  wait_thread:: 
    7185    Value 1 enables single "wait thread" for updating jobs status.  
    72     With ``pbs_home`` set enables wait_thread which reads PBS log files (instead of polling PBS daemons). 
     86    With `pbs_home` set enables wait_thread which reads PBS log files (instead of polling PBS daemons). 
    7387      
    7488     Type: integer, Default: 0 
     
    152166 
    153167DRMAA interface allows to pass DRM dependant job submission options. 
    154 Those options may be specified by settings ``drmaa_native_specification``. ``drmaa_native_specification`` 
    155 accepts space delimited ``qsub``. ``qsub`` 
     168Those options may be specified by settings `drmaa_native_specification`. `drmaa_native_specification` 
     169accepts space delimited `qsub`. `qsub` 
    156170options which does not set job attributes (`-b`, `-z`, `-C`) as 
    157171well as meant for submission of interactive jobs (`-I`, `-X`) or 
     
    176190||  drmaa_start_time    ||  Execution_Time             ||  `-a` start time     || 
    177191||  drmaa_js_state      ||  Hold_Types                 ||  `-h`                || 
    178 ||  ..                  ||  Account_Name               ||  `-A` account string || 
     192||  ..                  ||  Account_Name               ||  `-A` account string  || 
    179193||  ..                  ||  Checkpoint                 ||  `-c` interval       || 
    180194||  ..                  ||  Keep_Files                 ||  `-k` keep           || 
     
    184198||  ..                  ||  Shell_Path_List            ||  `-S` path list      || 
    185199||  ..                  ||  User_List                  ||  `-u` user list      || 
    186 ||  ..                  ||  group_list                 ||  `--group_list=`\groups || 
     200||  ..                  ||  group_list                 ||  `--group_list=`\groups  || 
    187201||  drmaa_v_env         ||  Variable_List              ||  `-v` variable list  || 
    188202||  ..                  ||  Variable_List              ||  `-V`                || 
    189203||  drmaa_v_email       ||  Mail_Users                 ||  `-M` user list      || 
    190204||  drmaa_duration_hlimit ||  Resource_List   cput     ||    `-l cput=`\limit    || 
    191 ||  drmaa_wct_hlimit      ||  Resource_List   walltime ||    `-l walltime=`\limit|| 
     205||  drmaa_wct_hlimit      ||  Resource_List   walltime ||    `-l walltime=`\limit  || 
    192206||  ..                    ||  Resource_List            ||    `-l` resources      || 
    193207 
     
    209223 * memleak fixes 
    210224 * testsuite passed on PBS Pro 10 
    211  * exit codes 126-127 cause the drmaa_wifaborted() to return true 
     225 * exit codes 126-127 cause the `drmaa_wifaborted()` to return true 
    212226 * other bug fixes 
    213227 
     
    222236 * number of attributes implemented: 
    223237 
    224    - ``drmaa_start_time`` 
    225    - ``drmaa_duration_hlimit`` 
    226    - ``drmaa_wct_hlimit`` 
    227    - ``drmaa_native_specification`` 
    228    - ``drmaa_job_category`` 
     238   - `drmaa_start_time` 
     239   - `drmaa_duration_hlimit` 
     240   - `drmaa_wct_hlimit` 
     241   - `drmaa_native_specification` 
     242   - `drmaa_job_category` 
    229243 
    230244 * configuration file(s) 
     
    261275   by sending SIGTERM and/or SIGKILL therefore retrieving 
    262276   those signals cannot be distinguished from abort using 
    263    ``drmaa_control(DRMAA_CONTROL_TERMINATE)``.  Then job termination 
     277   `drmaa_control(DRMAA_CONTROL_TERMINATE)`.  Then job termination 
    264278   state is marked as "aborted" and "signaled" whatever is the state. 
    265279 
    266  * ``drmaa_wcoredump()`` always returns ``false``. 
    267  
    268  * Waiting functions (``drmaa_wait()`` and ``drmaa_synchronize()``) 
     280 * `drmaa_wcoredump()` always returns `false`. 
     281 
     282 * Waiting functions (`drmaa_wait()` and `drmaa_synchronize()`) 
    269283   must pool DRM to find out whether job finished. 
     284 
     285[=#dev_tools] 
     286=== Developer tools === 
     287 
     288Although not needed for library user the following tools may be required 
     289if you intend to develop PSNC DRMAA for Torque/PBS Pro: 
     290 
     291 * GNU autotools 
     292 ** autoconf (tested with version 2.67) 
     293 ** automake (tested with version 1.11) 
     294 ** libtool (tested with version 2.2.8) 
     295 ** m4 (tested with version 1.4.14) 
     296 * [http://www.gnu.org/software/bison/ Bison] parser generator, 
     297 * [http://www.complang.org/ragel/ RAGEL] State Machine Compiler, 
     298 * [http://www.gnu.org/software/gperf/ gperf] gperf - a perfect hash function generator. 
     299 
     300=== Links === 
     301 
     302[=#drmaa] DRMAA: http://www.drmaa.org/ \\ 
     303[=#open_grid_forum] Open Grid Forum: http://www.gridforum.org/ \\ 
     304[=#specification] DRMAA 1.0 specification: http://www.ogf.org/documents/GFD.133.pdf \\ 
     305[=#testsuite] Official DRMAA test-suite: http://drmaa.org/testsuite.php \\ 
     306[=#smoa_comp] Smoa Computing: http://apps.man.poznan.pl/trac/smoa-comp \\ 
     307[=#bison] Bison:     http://www.gnu.org/software/bison/ \\