2007-11-16 16:49:19 +00:00
|
|
|
// This directory contains a system that allows
|
|
|
|
|
// users to submit jobs to a BOINC project.
|
|
|
|
|
//
|
|
|
|
|
// Major revisions may be required to make this work
|
|
|
|
|
// (and to make it secure) on your project.
|
|
|
|
|
// Please read and understand all the code before using it.
|
|
|
|
|
//
|
|
|
|
|
// Contributed by Dr. M.F. Somers, Leiden University
|
2008-01-15 08:36:59 +00:00
|
|
|
//
|
|
|
|
|
// BASIC INSTALL:
|
|
|
|
|
//
|
|
|
|
|
// 1) add tables to database using create_queue.sql:
|
|
|
|
|
//
|
|
|
|
|
// mysql yourprojectdb < create_queue.sql
|
|
|
|
|
//
|
|
|
|
|
// 2) copy files into html directory of your project so
|
|
|
|
|
// apache will server them:
|
|
|
|
|
//
|
|
|
|
|
// cp inc/* ~/Classical/html/inc (beware the user.inc might be overwritten, use diff!)
|
|
|
|
|
// cp user/* ~/Classical/html/user
|
|
|
|
|
// cp ops/* ~/Classical/html/ops
|
|
|
|
|
//
|
|
|
|
|
// 3) Make sure you have defined the following tags in your config.xml:
|
|
|
|
|
//
|
|
|
|
|
// <uldl_dir_fanout>
|
|
|
|
|
// <long_name>
|
|
|
|
|
// <bin_dir>
|
|
|
|
|
// <download_dir>
|
|
|
|
|
// <upload_dir>
|
|
|
|
|
// <project_dir>
|
|
|
|
|
// <create_work_program>
|
|
|
|
|
//
|
|
|
|
|
// 4) Make sure you have a WU and a result template in the template directory
|
|
|
|
|
// for each application with the names similar to 'queue_uppercase_work_unit_template'
|
|
|
|
|
// and 'queue_uppercase_result_unit_template'. These will be used to invoke 'make_work'.
|
|
|
|
|
//
|
|
|
|
|
// That shoult be it; now the queue has been setup and by default allows users to have 5
|
|
|
|
|
// jobslots per application. If your do not want users to be able to submit to an application
|
|
|
|
|
// make sure you list that app (it's ID) into the new q_restricted_apps table. The new
|
|
|
|
|
// q_users table can be used to allow users access to restricted apps or set different
|
|
|
|
|
// limits that the default 5 jobslots. The new q_list table is the list of allw WU's that
|
|
|
|
|
// have been submitted through the queue code...
|
|
|
|
|
//
|
|
|
|
|
// questions? send me a mail at m.somers@chem.leidenuniv.nl
|
|
|
|
|
//
|
|
|
|
|
// Example work unit template:
|
|
|
|
|
//
|
|
|
|
|
// <file_info>
|
|
|
|
|
// <number> 0 </number>
|
|
|
|
|
// </file_info>
|
|
|
|
|
//
|
|
|
|
|
// <workunit>
|
|
|
|
|
// <file_ref>
|
|
|
|
|
// <file_number> 0 </file_number>
|
|
|
|
|
// <open_name> classical.in </open_name>
|
|
|
|
|
// </file_ref>
|
|
|
|
|
//
|
|
|
|
|
// <command_line> classical.in classical.out classical.stdout </command_line>
|
|
|
|
|
// <min_quorum> 2 </min_quorum>
|
|
|
|
|
// <target_nresults> 2 </target_nresults>
|
|
|
|
|
// <max_error_results> 16 </max_error_results>
|
|
|
|
|
// <max_total_results> 16 </max_total_results>
|
|
|
|
|
// <max_success_results> 8 </max_success_results>
|
|
|
|
|
// <delay_bound> 43200 </delay_bound>
|
|
|
|
|
// </workunit>
|
|
|
|
|
//
|
|
|
|
|
//
|
|
|
|
|
// Example result template:
|
|
|
|
|
//
|
|
|
|
|
// <file_info>
|
|
|
|
|
// <name> <OUTFILE_0/> </name>
|
|
|
|
|
// <max_nbytes> 536870912 </max_nbytes>
|
|
|
|
|
// <url> <UPLOAD_URL/> </url>
|
|
|
|
|
// <generated_locally/>
|
|
|
|
|
// <queue_tag/>
|
|
|
|
|
// <upload_when_present/>
|
|
|
|
|
// </file_info>
|
|
|
|
|
//
|
|
|
|
|
// <file_info>
|
|
|
|
|
// <name> <OUTFILE_1/> </name>
|
|
|
|
|
// <max_nbytes> 536870912 </max_nbytes>
|
|
|
|
|
// <url> <UPLOAD_URL/> </url>
|
|
|
|
|
// <generated_locally/>
|
|
|
|
|
// <queue_tag/>
|
|
|
|
|
// <upload_when_present/>
|
|
|
|
|
// </file_info>
|
|
|
|
|
//
|
|
|
|
|
// <result>
|
|
|
|
|
// <file_ref>
|
|
|
|
|
// <file_name> <OUTFILE_0/> </file_name>
|
|
|
|
|
// <open_name> classical.out </open_name>
|
|
|
|
|
// </file_ref>
|
|
|
|
|
// <file_ref>
|
|
|
|
|
// <file_name> <OUTFILE_1/> </file_name>
|
|
|
|
|
// <open_name> classical.stdout </open_name>
|
|
|
|
|
// </file_ref>
|
|
|
|
|
// </result>
|
|
|
|
|
//
|
|
|
|
|
//
|
|
|
|
|
|
