Commit 346c338a authored by Leigh B Stoller's avatar Leigh B Stoller

Checkpoint reservation FAQ text so that other can edit.

parent 6662a20b
......@@ -2,7 +2,7 @@ $(function ()
{
'use strict';
var template_list = ["reserve-request", "reservation-list",
var template_list = ["reserve-request", "reserve-faq", "reservation-list",
"oops-modal", "waitwait-modal"];
var templates = APT_OPTIONS.fetchTemplateList(template_list);
var mainString = templates["reserve-request"];
......@@ -58,6 +58,18 @@ $(function ()
});
html = aptforms.FormatFormFieldsHorizontal(html);
$('#main-body').html(html);
$('.faq-contents').html(templates["reserve-faq"]);
// Handler for the FAQ link.
$('#reservation-faq-button').click(function (event) {
event.preventDefault();
sup.HideModal('#reservation-help-modal',
function () {
sup.ShowModal('#reservation-faq-modal');
});
});
// Set the manual link since the FAQ is not a template.
$('#reservation-manual').attr("href", window.MANUAL);
// This activates the popover subsystem.
$('[data-toggle="popover"]').popover({
......
......@@ -149,7 +149,7 @@ REQUIRE_UNDERSCORE();
REQUIRE_SUP();
REQUIRE_MOMENT();
REQUIRE_APTFORMS();
AddTemplateList(array("reserve-request", "reservation-list",
AddTemplateList(array("reserve-request", "reserve-faq", "reservation-list",
"oops-modal", "waitwait-modal"));
SPITREQUIRE("js/reserve.js",
"<script src='js/lib/jquery.tablesorter.min.js'></script>\n".
......
<style>
.faq {
margin: 10px;
}
.faq-question {
padding-top: 5px;
padding-bottom: 5px;
}
.faq-answer {
padding-top: 5px;
padding-bottom: 5px;
}
</style>
<div class="faq">
<div class="panel-group" id="accordion">
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq1">
Can I request a specific node?
</a>
</h4>
</div>
<div id="faq1" class="panel-collapse collapse">
<div class="panel-body faq-answer">
No. Reservations are made by node type not by individual node.
For example, you can request one "d430" node but you could not
specifically request "pc701".
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq2">
What if I need multiple node types?
</a>
</h4>
</div>
<div id="faq2" class="panel-collapse collapse">
<div class="panel-body faq-answer">
Since reservations are for a specific node type, you will have
to create multiple reservations, one per node type, covering the
same time period.
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq3">
What if I need nodes at multiple sites?
</a>
</h4>
</div>
<div id="faq3" class="panel-collapse collapse">
<div class="panel-body faq-answer">
Since reservations are for a specific node type and node types
are specific to individual clusters, you will have to create
one or more reservations at each cluster covering the same time
period.
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq4a">
What is the time granularity of a reservation?
</a>
</h4>
</div>
<div id="faq4a" class="panel-collapse collapse">
<div class="panel-body faq-answer">
Reservations start at one hour boundaries and their duration
is expressed in hours.
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq4">
How many reservations can I have outstanding?
</a>
</h4>
</div>
<div id="faq4" class="panel-collapse collapse">
<div class="panel-body faq-answer">
There is currently no limit. This will likely change in the future.
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq5">
How far in the future can I make reservations?
</a>
</h4>
</div>
<div id="faq5" class="panel-collapse collapse">
<div class="panel-body faq-answer">
The reservation system will allow you to schedule up to
three years in the future, In practice however, you should not
reserve nodes out past a year or so, since CloudLab cluster
resources may come and go.
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq6">
What if I don't use all the nodes during my reservation?
</a>
</h4>
</div>
<div id="faq6" class="panel-collapse collapse">
<div class="panel-body faq-answer">
A reservation only ensures that at least the specified number of
nodes of the indicated type are available for use at the given time.
You must explicitly instantiate a profile to use the nodes. If you
do not, or if your instantiation uses fewer than the reserved number
of nodes, the remaining nodes are unavailable to anyone else outside
of your project. Moral: choose your reservation size carefully!
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq7">
What if I decide I need more/less nodes after I have
scheduled my reservation?
</a>
</h4>
</div>
<div id="faq7" class="panel-collapse collapse">
<div class="panel-body faq-answer">
You can edit your reservation as needed before the start
time has been reached (see the <em>List Reservations</em> option
in the experimentation menu). Be aware that if your
reservation has been already been approved, changing it might
move it back into the pending state.
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq7b">
Can I extend my reservation after it has began?
</a>
</h4>
</div>
<div id="faq7b" class="panel-collapse collapse">
<div class="panel-body faq-answer">
No. You will have to create a new reservation that abuts your
current reservation. You may however be able to extend experiments
started in your reservation window to run past the end of your
reservation, if no other reservation is scheduled immediately after
yours. The experiment extension page will allow you to extend an
experiment up until the point it conflicts with a future reservation
for the same node type(s).
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq8">
Can I automatically instantiate a profile when the
reservation begins?
</a>
</h4>
</div>
<div id="faq8" class="panel-collapse collapse">
<div class="panel-body faq-answer">
No. You must explicitly instantiate a profile within the reservation
time period. A reservation only ensures that at least the specified
number of nodes of the indicated type are available for use during
the given time period.
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq9">
Will my experiment be automatically terminated at the end
of the reservation?
</a>
</h4>
</div>
<div id="faq9" class="panel-collapse collapse">
<div class="panel-body faq-answer">
No. Your experiment will only be forcibly terminated when the
experiment duration time is reached. However, it is quite possible
that you will not be able to extend an experiment past the reservation
end time. It depends on whether there is another reservation for
the node resources immediately following yours. The experiment
extension page will allow you to extend an experiment up until the
point it conflicts with a future reservation for the same node type.
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq10">
Can I allocate nodes without creating a reservation first?
</a>
</h4>
</div>
<div id="faq10" class="panel-collapse collapse">
<div class="panel-body faq-answer">
Yes. You do not need to create an explicit reservation in order
to use node resources. Instantiating an experiment creates an
implicit reservation starting at the current time and extending
through the default duration of the experiment. If that time frame
conflicts with an existing reservation, the instantiation will
fail.
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq11">
My N-node reservation time has arrived but I cannot
instantiate my N-node experiment. Why?
</a>
</h4>
</div>
<div id="faq11" class="panel-collapse collapse">
<div class="panel-body faq-answer">
There are a couple of possible reasons. The most common reason is
that one or more of the desired node type has suffered hardware
failure or was otherwise taken out of service unexpectedly after
you made your reservation. It is also possible that the network
topology you specify in an experiment cannot be instantiated on
the set of nodes that are available when the reservation starts.
</div>
</div>
</div>
<div class="panel panel-default">
<div class="panel-heading faq-question">
<h4 class="panel-title">
<a data-toggle="collapse" data-parent="#accordion"
href="#faq12">
Where can I get more information about reservations?
</a>
</h4>
</div>
<div id="faq12" class="panel-collapse collapse">
<div class="panel-body faq-answer">
In the <a href="#" target="_blank"
id="reservation-manual">manual</a>!
</div>
</div>
</div>
</div>
</div>
......@@ -321,9 +321,7 @@
promised to another user you will not be allowed to keep
them past the end of the reservation (requests to extend
your experiment will be denied).</li>
<li> Cluster; at what cluster you want resources. If you
need resources at multiple clusters, you need to submit a
request for each cluster.</li>
<li> Cluster; at what cluster you want resources.</li>
<li> Node type; reservations are for specific node types. You
might not care what node type you get, but the reservation
system requires it.</li>
......@@ -351,7 +349,27 @@
reservations will indicate which requests are pending
approval.
</p>
<p>
More info can be found in the
<a id="reservation-faq-button" href="#">reservation FAQ.</a>
</p>
</div>
</div>
</div>
</div>
<!-- FAQ -->
<div id='reservation-faq-modal' class='modal fade'>
<div class='modal-dialog'>
<div class='modal-content'>
<div class='modal-body'>
<button type='button' class='close' data-dismiss='modal'
aria-hidden='true'>&times;</button>
<div class="clearfix"></div>
<center><h4>Reservation FAQ</h4></center>
<div class="faq-contents"></div>
</div>
</div>
</div>
</div>
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment