Scenarios

• client_state.xml: describes the host and projects. Any projects that don't currently have tasks are ignored.
• global_prefs.xml and global_prefs_override.xml: computing preferences (optional).
• cc_config.xml: client configuration (optional).

You create a scenario by uploading these files to the BOINC server.

Simulations

• The duration and time resolution of the simulation.
• Choices for various client policy alternatives, including:
  • Whether to use Recent Estimated Credit scheduling (the proposed policy for the 6.14 client)
  • Whether to use Hysteresis-based work fetch (the proposed policy for the 6.14 client)

• A 'time line' showing CPU and GPU usage.
• The client's message log
• graphs of scheduling-related data (debt, REC).
• A summary of several figures of merit, including
  • idle fraction: the fraction of processing power that was unused
  • wasted fraction: the fraction of processing power that was 'wasted' on jobs that missed their deadline
  • resource share violation: a measure [0..1] of the extent to which resource shares were disobeyed.
  • monotony: a measure [0..1] of the extent to which the client ran jobs of a single project for long periods

Comments and reports

In such cases, please add a comment to the simulation, indicating the nature of the problem and the simulation time when it occurred.

Also, please post to the boinc_dev email list if you have problems using BCE, or if you have suggestions for new features.

Existing scenarios

".file_get_contents("$dir/inputs.txt")."
        
".file_get_contents("$dir/results.txt")."
        ".get_comments($dir)."
        
    ";
}

// show:
// links to files
// list of existing simulations
// link for new simulation
//
function show_scenario() {
    $name = get_str("name");
    $d = "scenarios/$name";
    if (!is_dir($d)) {
        error_page("No such scenario");
    }
    page_head("Scenario $name");
    $desc = file_get_contents("scenarios/$name/description");
    $userid = (int)file_get_contents("scenarios/$name/userid");
    $user = BoincUser::lookup_id($userid);
    $date = date_str(filemtime("scenarios/$name"));
    start_table();
    row2("Creator", $user->name);
    row2("When", $date);
    row2("Description", $desc);
    $x = "client_state.xml";
    if (file_exists("$d/global_prefs.xml")) {
        $x .= "
global_prefs.xml\n";
    }
    if (file_exists("$d/global_prefs_override.xml")) {
        $x .= "
global_prefs_override.xml\n";
    }
    if (file_exists("$d/cc_config.xml")) {
        $x .= "
cc_config.xml\n";
    }
    row2("Input files", $x);
    end_table();
    show_button("sim_web.php?action=simulation_form&scen=$name",
        "Do new simulation",
        "Do new simulation"
    );
    echo "
Simulations
";
    start_table();
    echo "
            ID
Click for details
            Who
            When
            Parameters
            Results
            Comments
        
    ";
    $s = opendir("$d/simulations");
    while (false !== ($f = readdir($s))) {
        if (!is_numeric($f)) continue;
        show_simulation_summary($name, $f);
    }
    end_table();

    page_tail();
}

// form for simulation parameters:
// duration, time step, policy options
//
function simulation_form() {
    $scen = get_str("scen");
    page_head("Do simulation");
    echo "

        
        
    ";
    start_table();
    row2("Duration", " seconds");
    row2("Time step", " seconds");
    row2("Use Recent Estimated Credit
        
If checked, use 6.14 scheduling policies
        based on Recent Estimated Credit (REC)
        rather than short- and long-term debt.",
        ""
    );
    row2("Use hysteresis work fetch?
        
If checked, use 6.14 work fetch policies.
        Tthe client will wait
        until the work buffer falls below X, then fill it to X+Y.
        Otherwise it will keep it filled to X+Y.",
        ""
    );
    row2("Scheduler does detailed deadline check?
        
If checked, the scheduler's deadline
        decisions will use a detailed EDF simulation
        rather than an approximation.",
        ""
    );
    row2("Client uses pure Round-robin?
        
If checked, CPU scheduling will
        use a simple round-robin policy.",
        ""
    );
    row2("", "");
    end_table();
    page_tail();
}

// create directory for simulation,
// run simulation,
// redirect to simulation page
//
function simulation_action() {
    $user = get_logged_in_user();
    $scen = get_str("scen");
    if (!is_dir("scenarios/$scen")) {
        error_page("no such scenario");
    }
    $sim_dir = "scenarios/$scen/simulations";
    $sim_name = create_dir_seqno($sim_dir);
    $sim_path = "$sim_dir/$sim_name";
    $policy = new POLICY("");
    $policy->use_rec = get_str("use_rec", true);
    $policy->use_hyst_fetch = get_str("use_hyst_fetch", true);
    $policy->cpu_sched_rr_only = get_str("cpu_sched_rr_only", true);
    $policy->server_uses_workload = get_str("server_uses_workload", true);
    file_put_contents("$sim_path/userid", "$user->id");

    do_sim("scenarios/$scen", $sim_path, $policy);
    header("Location: sim_web.php?action=show_simulation&scen=$scen&sim=$sim_name");
}

// show links to files in simulation directory
//
function show_simulation() {
    $scen = get_str("scen");
    $sim = get_str("sim");
    $dir = "scenarios/$scen/simulations/$sim";
    if (!is_dir($dir)) {
        error_page("No such simulation");
    }
    page_head("Simulation $sim");
    start_table();
    $userid = (int)file_get_contents("$dir/userid");
    $user = BoincUser::lookup_id($userid);
    $date = date_str(filemtime($dir));

    row2("Scenario", "$scen");
    row2("Who", $user->name);
    row2("When", $date);
    row2("Parameters", "
".file_get_contents("$dir/inputs.txt")."
");
    row2("Results", "
".file_get_contents("$dir/results.txt")."
");

    $x = file_get_contents("$dir/index.html");
    $x = str_replace("
Output files
", "", $x);
    $x = str_replace("href=", "href=scenarios/$scen/simulations/$sim/", $x);
    row2("Output files", $x);
    $x = get_comments($dir);
    if ($x) {
        row2("Comments", $x);
    }
    echo "
        
        
        
    ";
    row2("",
        ""
    );
    echo "
";
    end_table();
    page_tail();
}

function add_comment() {
    $user = get_logged_in_user();
    $scen = get_str("scen");
    $sim = get_str("sim");
    $dir = "scenarios/$scen/simulations/$sim";
    if (!is_dir($dir)) {
        error_page("No such simulation");
    }
    $cdir = "$dir/comments";
    @mkdir($cdir);
    $c = create_dir_seqno($cdir);
    $p = "$cdir/$c";
    file_put_contents("$p/userid", "$user->id");
    file_put_contents("$p/comment", get_str("comment"));

    header("Location: sim_web.php?action=show_simulation?scen=$scen&sim=$sim");
}

$action = get_str("action", true);
if (!$action) $action = post_str("action", true);

switch ($action) {
case "create_scenario_form":
    create_scenario_form();
    break;
case "create_scenario":
    create_scenario();
    break;
case "show_scenario":
    show_scenario();
    break;
case "simulation_form":
    simulation_form();
    break;
case "simulation_action":
    simulation_action();
    break;
case "show_simulation":
    show_simulation();
    break;
case "add_comment":
    add_comment();
    break;
default:
    show_scenarios();
}

?>