Commit 64bf2d04 authored by cirou's avatar cirou
Browse files

files from readthedoc github are now here

parent c8b1ac1f

Doc/RAPS.rst

+4 −4
Original line number Diff line number Diff line
@@ -40,7 +40,7 @@ Three files are mandatory for describing your supercomputer in the raps/config/< 
Racks and their content

^^^^^^^^^^^^^^^^^^^^^^^



.. figure:: raps/pictures/RAPSexplodedView.JPG

.. figure:: pictures/RAPSexplodedView.JPG

   :align: center

   :width: 100%

   :alt: Exploded view of a naive supercomputer
@@ -65,7 +65,7 @@ Here from the exploded view of a naive supercomputer, we have: 


  

That corresponds to a file  raps/config/<mysupercomputer>/system.json containing:

 .. literalinclude:: raps/system.json

 .. literalinclude:: system.json

  :language: shell
@@ -96,7 +96,7 @@ Racks and their powering 
  

Here is an example of a file  raps/config/<mysupercomputer>/power.json for the Frontier supercomputer:



 .. literalinclude:: raps/power.json

 .. literalinclude:: power.json

  :language: shell



Description of fields
@@ -124,7 +124,7 @@ Jobs and their contents 


Here is an example of a file  raps/config/<mysupercomputer>/scheduler.json for the Frontier supercomputer:



 .. literalinclude:: raps/scheduler.json

 .. literalinclude:: scheduler.json

  :language: shell



Description of fields:

Doc/RAPS.usage.txt

0 → 100644
+38 −0
Original line number Diff line number Diff line 
usage: main.py [-h] [-c] [--start START] [--end END] [-d] [-e] [-n NUMJOBS] [-t TIME] [-v]

[--seed] [-f REPLAY [REPLAY ...]] [--reschedule] [--scale SCALE] [-u] [--jid JID] [--validate]

[-o] [-p {power,loss,pue,temp,util} [{power,loss,pue,temp,util} ...]] [--imtype {png,svg,jpg,pdf,eps}]

[--system SYSTEM] [-s {fcfs,sjf,prq}] [-w {random,benchmark,peak,idle}] [--layout {layout1,layout2}]



Resource Allocator & Power Simulator (RAPS)



options:

  -h, --help            show this help message and exit

  -c, --cooling         Include FMU cooling model

  --start START         ISO8061 string for start of simulation

  --end END             ISO8061 string for end of simulation

  -d, --debug           Enable debug mode and disable rich layout

  -e, --encrypt         Encrypt any sensitive data in telemetry

  -n NUMJOBS, --numjobs NUMJOBS

                        Number of jobs to schedule

  -t TIME, --time TIME  Length of time to simulate, e.g., 123, 123s, 27m, 3h, 7d

  -v, --verbose         Enable verbose output

  --seed                Set random number seed for deterministic simulation

  -f REPLAY [REPLAY ...], --replay REPLAY [REPLAY ...]

                        Either: path/to/joblive path/to/jobprofile -or- filename.npz (overrides --workload option)

  --reschedule          Reschedule the telemetry workload

  --scale SCALE         Scale telemetry to fit on target machine

  -u, --uncertainties   Change from floating point units to floating point units with uncertainties. Very expensive w.r.t simulation time!

  --jid JID             Replay job id

  --validate            Use node power instead of CPU/GPU utilizations

  -o, --output          Output power, cooling, and loss models for later analysis

  -p {power,loss,pue,temp,util} [{power,loss,pue,temp,util} ...], --plot {power,loss,pue,temp,util} [{power,loss,pue,temp,util} ...]

                        Specify one or more types of plots to generate: power, loss, pue, util, temp

  --imtype {png,svg,jpg,pdf,eps}

                        Plot image type

  --system SYSTEM       System config to use

  -s {fcfs,sjf,prq}, --schedule {fcfs,sjf,prq}

                        Schedule policy to use

  -w {random,benchmark,peak,idle}, --workload {random,benchmark,peak,idle}

                        Type of synthetic workload

  --layout {layout1,layout2}

                        Layout of UI

Doc/pictures/RAPSexplodedView.JPG

0 → 100644
+206 KiB
Loading image diff...

Doc/power.json

0 → 100644
+18 −0
Original line number Diff line number Diff line 
{

    "POWER_GPU_IDLE": 88,

    "POWER_GPU_MAX": 560,

    "POWER_CPU_IDLE": 90,

    "POWER_CPU_MAX": 280,

    "POWER_MEM": 74.26,

    "POWER_NIC": 20,

    "POWER_NVME": 30,

    "POWER_SWITCH": 250,

    "POWER_CDU": 8473.47,

    "POWER_UPDATE_FREQ": 15,

    "RECTIFIER_PEAK_THRESHOLD": 13670,

    "SIVOC_LOSS_CONSTANT": 13,

    "SIVOC_EFFICIENCY": 0.98,

    "RECTIFIER_LOSS_CONSTANT": 17,

    "RECTIFIER_EFFICIENCY": 0.96,

    "POWER_COST": 0.094

}

Doc/scheduler.json

0 → 100644
+18 −0
Original line number Diff line number Diff line 
{

    "SEED": 42,

    "JOB_ARRIVAL_TIME": 900,

    "MTBF": 11,

    "MAX_TIME": 88200,

    "TRACE_QUANTA": 15,

    "MIN_WALL_TIME": 3600,

    "MAX_WALL_TIME": 43200,

    "UI_UPDATE_FREQ": 900,

    "MAX_NODES_PER_JOB": 3000,

    "JOB_END_PROBS": {

        "COMPLETED": 0.63,

        "FAILED": 0.13,

        "CANCELLED": 0.12,

        "TIMEOUT": 0.11,

        "NODE_FAIL": 0.01

    }

}