Commit c90dc27c authored by Robert Ricci's avatar Robert Ricci

Be consistent about using @(tb) instead of CloudLab

Just in case there is ever an Apt version of this tutorial
parent 45841a2f
......@@ -2,7 +2,7 @@
@(require "defs.rkt")
@title[#:tag "cloudlab-tutorial" #:version apt-version]{CloudLab OpenStack Tutorial}
@title[#:tag "cloudlab-tutorial" #:version apt-version]{@(tb) OpenStack Tutorial}
This tutorial will walk you through the process of creating a small cloud on
@(tb) using OpenStack. Your copy of OpenStack will run on bare-metal machines
......@@ -40,8 +40,10 @@ This tutorial assumes that:
@section{Logging In}
The first step is to log in to CloudLab; CloudLab is available to all
researchers and educators who work in cloud computing.
The first step is to log in to @(tb); @(tb) is available to all
researchers and educators who work in cloud computing. If you have
an account at one of its federated facilities, like @link["http://geni.net"]{GENI},
then you already have an account at @(tb).
@margin-note{This document assumes that you will log in using an existing
@seclink["geni-users"]{GENI account}. If you want to use a different
......@@ -50,9 +52,9 @@ researchers and educators who work in cloud computing.
@itemlist[#:style 'ordered
@instructionstep["Visit CloudLab"
@instructionstep["Open the @(tb) web interface"
#:screenshot "tutorial/front-page.png"]{
To log in to CloudLab using a GENI account, start by visiting
To log in to @(tb) using a GENI account, start by visiting
@url{https://www.cloudlab.us/} in your browser and using the ``Log In''
button in the upper right.
}
......@@ -61,7 +63,7 @@ researchers and educators who work in cloud computing.
#:screenshot "tutorial/login-page.png"]{
On the login page that appears, you will use the ``GENI User'' button.
This will start the GENI authorization tool, which lets you connect
your GENI account with CloudLab.
your GENI account with @(tb).
}
@instructionstep["Select the GENI portal"
......@@ -92,7 +94,7 @@ researchers and educators who work in cloud computing.
from this one.)
}
@instructionstep["Authorize CloudLab to use your GENI account"
@instructionstep["Authorize @(tb) to use your GENI account"
#:screenshot "tutorial/authorize.png"]{
@margin-note{What's happening in this step is that your browser
uses your GENI user ceritificate (which it obtained from the GENI
......@@ -102,9 +104,9 @@ researchers and educators who work in cloud computing.
@link["http://groups.geni.net/geni/wiki/GeniApi"]{GENI API calls}
on your behalf.}
Click the ``Authorize'' button: this will create a signed statement
authorizing the CloudLab portal to speak on your behalf. This
authorizing the @(tb) portal to speak on your behalf. This
authorization is time-limited (see ``Show Advanced'' for the details),
and all actions the CloudLab portal takes on your behalf are clearly
and all actions the @(tb) portal takes on your behalf are clearly
traceable.
}
......@@ -171,7 +173,7 @@ information about how they work.
@instructionstep["Select a cluster"
#:screenshot "tutorial/pick-cluster.png"]{
CloudLab has multiple clusters available to it. Some profiles can run
@(tb) has multiple clusters available to it. Some profiles can run
on any cluster, some can only run on specific ones due to specific hardware
constraints, etc. The profile we're using for this tutorial supports the
@seclink["apt-cluster"]{APT cluster}, which has traditional x86 servers, and the
......@@ -183,13 +185,13 @@ information about how they work.
@instructionstep["Click Create!"
#:screenshot "tutorial/click-create.png"]{
When you click the ``create'' button, CloudLab will start
When you click the ``create'' button, @(tb) will start
provisioning the resources that you requested on the cluster that
you selected.
}
@instructionstep["CloudLab instantiates your profile"]{
CloudLab will take a few minutes to bring up your copy of OpenStack, as
@instructionstep["@(tb) instantiates your profile"]{
@(tb) will take a few minutes to bring up your copy of OpenStack, as
many things happen at this stage, including selecting suitable
hardware, loading disk images on local storage, booting bare-metal
machines, reconfiguring the network topology, etc. While this is
......@@ -208,7 +210,7 @@ information about how they work.
able to log in until they have gone through the process of imaging and
booting.) While you are waiting for your resources to become available,
you may want to have a look at the
@link["http://docs.cloudlab.us"]{CloudLab
@link["http://docs.cloudlab.us"]{@(tb)
user manual}, or use the ``Sliver'' button to watch the logs of the
resources (``slivers'') being provisioned and booting.
}
......@@ -242,11 +244,11 @@ for longer, or release them immediately.
@screenshot["tutorial/experiment-status.png"]
Note that the default lifetime for experiments on CloudLab is less than a day;
Note that the default lifetime for experiments on @(tb) is less than a day;
after this time, the resources will be reclaimed and their disk contents will
be lost. If you need to use them for longer, you can use the ``Extend'' button
and provide a description of why they are needed. Longer extensions require
higher levels of approval from CloudLab staff. You might also consider
higher levels of approval from @(tb) staff. You might also consider
@seclink["creating-profiles"]{creating a profile} of your own if you might need
to run a customized environment multiple times or want to share it with others.
......@@ -259,7 +261,7 @@ Profiles may contain written instructions for their use. Clicking on the title
of the ``Profile Instructions'' panel will expand (or collapse) it; in this
case, the instructions provide a link to the administrative interface of
OpenStack, and give you passwords to use to log in. (Don't log into OpenStack
yet---for now, let's keep exploring the CloudLab interface.)
yet---for now, let's keep exploring the @(tb) interface.)
@screenshot["tutorial/experiment-instructions.png"]
......@@ -276,7 +278,7 @@ fresh check.
@screenshot["tutorial/topology-view.png"]
It is important to note that every node in CloudLab has at least @italic{two}
It is important to note that every node in @(tb) has at least @italic{two}
network interfaces: one ``control network'' that carries public IP
connectivity, and one ``experiment network'' that is isolated from the Internet
and all other experiments. It is the experiment net that is shown in this
......@@ -333,7 +335,7 @@ below.
@subsection[#:tag "tutorial-web-shell"]{Web-based Shell}
CloudLab provides a browser-based shell for logging into your nodes, which is
@(tb) provides a browser-based shell for logging into your nodes, which is
accessed through the action menu described above. While this shell is
functional, it is most suited to light, quick tasks; if you are going to do
serious work, on your nodes, we recommend using a standard terminal
......@@ -357,7 +359,7 @@ Two things of note:
@subsection[#:tag "tutorial-console"]{Serial Console}
CloudLab provides serial console access for all nodes, which can be used
@(tb) provides serial console access for all nodes, which can be used
in the event that normal IP or @(ssh) access gets intentionally or
untintentionally broken. Like the browser-based shell, it is launched through
the access menu, and the same caveats listed above apply as well. In addition:
......@@ -394,7 +396,7 @@ command line interfaces or other APIs as well.}
panel (click to expand it if it's collapsed), you'll find a link
to the web interface running on the @tt{controller} node. Open this
link (we recommend opening it in a new tab, since you will still
need information from the CloudLab web interface).
need information from the @(tb) web interface).
}
@instructionstep["Log in to the OpenStack web interface"
......@@ -650,7 +652,7 @@ watch it through the serial console.
@section{Terminating the Experiment}
Resources that you hold in CloudLab are real, physical machines and are
Resources that you hold in @(tb) are real, physical machines and are
therefore limited and in high demand. When you are done, you should release
them for use by other experimenters. Do this via the ``Terminate'' button on
the @(tb) experiment status page.
......@@ -668,7 +670,7 @@ time.
@section{Taking Next Steps}
Now that you've got a feel for for what CloudLab can do, there are several
Now that you've got a feel for for what @(tb) can do, there are several
things you might try next:
@itemlist[
......
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