From f90871a141583a4f2f1ab830b6ab5400fa8e2d9d Mon Sep 17 00:00:00 2001
From: David Anderson <davea@ssl.berkeley.edu>
Date: Mon, 30 Mar 2009 18:38:11 +0000
Subject: [PATCH] - boinc_submit (single-job submission):     set the job
 params to reasonable values (see below),     and make it easy to change these
 values in the script - create_work (function and script): change default job
 params:     FLOPs est: 1e9 => 3600e9     FLOPs bound: 1e10 => 86400e9     mem
 bound 100MB => 500MB,     disk bound 100MB => 1GB     delay bound: 100000s =>
 1 week

svn path=/trunk/boinc/; revision=17703
---
 checkin_notes         | 17 +++++++++++++++++
 client/work_fetch.cpp |  4 ++++
 doc/boinc_news.php    | 10 ++++++++++
 doc/projects.inc      |  8 ++++++++
 doc/white.css         |  2 +-
 tools/boinc_submit    | 40 +++++++++++++++++++++++++++++++++++++---
 tools/create_work.cpp | 10 +++++-----
 7 files changed, 82 insertions(+), 9 deletions(-)

diff --git a/checkin_notes b/checkin_notes
index 9b1ab48123..a0edadb9d6 100644
--- a/checkin_notes
+++ b/checkin_notes
@@ -3461,3 +3461,20 @@ David  27 Mar 2009
 
     client/
         work_fetch.cpp
+
+David  30 Mar 2009
+    - boinc_submit (single-job submission):
+        set the job params to reasonable values (see below),
+        and make it easy to change these values in the script
+    - create_work (function and script): change default job params:
+        FLOPs est: 1e9 => 3600e9
+        FLOPs bound: 1e10 => 86400e9
+        mem bound 100MB => 500MB,
+        disk bound 100MB => 1GB
+        delay bound: 100000s => 1 week
+
+    client/
+        work_fetch.cpp
+    tools/
+        boinc_submit
+        create_work.cpp
diff --git a/client/work_fetch.cpp b/client/work_fetch.cpp
index 4e107f6cfd..a33ce2c532 100644
--- a/client/work_fetch.cpp
+++ b/client/work_fetch.cpp
@@ -573,6 +573,10 @@ void RSC_WORK_FETCH::update_debts() {
     // Otherwise add an offset of 2*delta_limit,
     // which will gradually bring all the debts towards zero
     //
+    // The policy of keeping the max debt at zero is important;
+    // it means that new projects will begin in parity with high-debt project,
+    // and won't wait for months to get work.
+    //
     double offset;
     double delta_limit = secs_this_debt_interval*ninstances;
     if (-max_debt < 2*delta_limit) {
diff --git a/doc/boinc_news.php b/doc/boinc_news.php
index 16fad98308..906ce932d8 100644
--- a/doc/boinc_news.php
+++ b/doc/boinc_news.php
@@ -1,6 +1,16 @@
 <?
 
 $project_news = array(
+array("March 30, 2009",
+    "<a href=http://boinc.vgtu.lt/vtuathome/>VTU@home</a>,
+    a project from the Vilnius Gediminas Technical University,
+    is now listed on the <a href=http://boinc.berkeley.edu/choose_projects.php>Choose
+    Projects</a> page.
+    VTU@home serves Lithuanian scientists.
+    It is currently studying the automated testing
+    of complex software systems.
+    "
+),
 array("March 18, 2009",
     "<a href=http://www.isgtw.org/?pid=1001689>Volunteer computing goes East</a> -
     a story on upcoming events in Taiwan and Beijing - appears
diff --git a/doc/projects.inc b/doc/projects.inc
index 94bad53280..bd29f12f84 100644
--- a/doc/projects.inc
+++ b/doc/projects.inc
@@ -200,6 +200,14 @@ $mixed = array(
 $math = array(
     "Mathematics, computing, and games",
     array(
+        array(
+            "VTU@home",
+            "http://boinc.vgtu.lt/vtuathome/",
+            "Vilnius Gediminas Technical University and Kaunas University of Technology (Lithuania)",
+            "Software testing",
+            "The aim of this project is to provide a powerful distributed computing platform for scientists of Vilnius Gediminas Technical University (VGTU) as well as others Lithuanian academic institutions.  Current applications involve the study of Monte-Carlo based software testing.",
+            "vtuathome-white.gif",
+        ),
         array(
             "AQUA@home",
             "http://aqua.dwavesys.com/",
diff --git a/doc/white.css b/doc/white.css
index 5551d1670a..b03fc31b71 100644
--- a/doc/white.css
+++ b/doc/white.css
@@ -89,7 +89,7 @@ th {
 }
 
 td.indent {
-         border-left: 4px solid white;
+    border-left: 4px solid white;
 }
 
 td.heading{
diff --git a/tools/boinc_submit b/tools/boinc_submit
index 22183d0c17..48d359a6f5 100755
--- a/tools/boinc_submit
+++ b/tools/boinc_submit
@@ -3,6 +3,27 @@
 <?php
 
 // Submit a single job.
+// Usage (see http://boinc.berkeley.edu/trac/wiki/SingleJob for more info):
+//
+// 1) Set the env var BOINC_PROJECT_DIR to the root directory of the project
+// 2) put boinc/tools/ in your search path
+// 3) cd into a directory containing the input files and executable
+//
+// boinc_submit [boinc-options] program [program-options]
+//
+// The boinc-options are:
+//   --infile name: specifies an input file. 
+//   --stdin name: direct the given file to the program's stdin. 
+//   --outfile name: specifies an output file. 
+//   --stdout name: direct the program's stdout to the given file. 
+//   --platform: the [platform] on which the program is to be run
+//       (default: i686-pc-linux-gnu). 
+//
+// You can include as many --infile and --outfile options as you want,
+// and at most one of others.
+// The program-options will be passed as command-line arguments to the program
+// when it runs on the remote machine. 
+//
 // Implementation notes:
 // - The jobs use the app "single_job_PLATFORM".
 //   This app has a single app_version containing the wrapper for that platform
@@ -22,6 +43,16 @@
 
 ini_set('error_reporting', E_ALL);
 
+// Job parameters.  Edit as needed
+// (should eventually make them cmdline args)
+
+$job_params = null;
+$job_params->rsc_fpops_est = 3600e9;        // estimate: 1 GFLOPS-hour
+$job_params->rsc_fpops_bound = 86400e9;     // limit: 1 GFLOPS-day
+$job_params->rsc_memory_bound = 5e8;        // mem bound: 500MB
+$job_params->rsc_disk_bound = 1e9;          // disk bound: 1GB
+$job_params->delay_bound = 7*86400;         // delay bound: 1 week
+
 // global vars
 //
 $project_dir = null;
@@ -169,7 +200,7 @@ function make_wrapper_job_file() {
 
 function make_wu_template() {
     global $wuid, $infiles, $stdin_file, $program_phys, $wu_template_filename;
-    global $project_dir;
+    global $project_dir, $job_params;
 
     chdir($project_dir);
     $wu_template_filename = "templates/sj_wu_template_$wuid";
@@ -236,8 +267,11 @@ function make_wu_template() {
     </file_ref>
 ");
     fwrite($f,
-"    <rsc_fpops_bound>1e18</rsc_fpops_bound>
-    <rsc_fpops_est>1e15</rsc_fpops_est>
+"    <rsc_fpops_est>$job_params->rsc_fpops_est</rsc_fpops_est>
+    <rsc_fpops_bound>$job_params->rsc_fpops_bound</rsc_fpops_bound>
+    <rsc_memory_bound>$job_params->rsc_memory_bound</rsc_memory_bound>
+    <rsc_disk_bound>$job_params->rsc_disk_bound</rsc_disk_bound>
+    <delay_bound>$job_params->delay_bound</delay_bound>
 </workunit>
 ");
     fclose($f);
diff --git a/tools/create_work.cpp b/tools/create_work.cpp
index a21668bd6e..5cf370b5b7 100644
--- a/tools/create_work.cpp
+++ b/tools/create_work.cpp
@@ -105,12 +105,12 @@ int main(int argc, const char** argv) {
     wu.max_error_results = 3;
     wu.max_total_results = 10;
     wu.max_success_results = 6;
-    wu.rsc_fpops_est = 1e9;
-    wu.rsc_fpops_bound =  1e10;
-    wu.rsc_memory_bound = 1e8;
-    wu.rsc_disk_bound = 1e8;
+    wu.rsc_fpops_est = 3600e9;
+    wu.rsc_fpops_bound =  86400e9;
+    wu.rsc_memory_bound = 5e8;
+    wu.rsc_disk_bound = 1e9;
     wu.rsc_bandwidth_bound = 0.0;
-    wu.delay_bound = 100000;
+    wu.delay_bound = 7*86400;
 
     while (i < argc) {
         if (arg(argv, i, "appname")) {