Commit 782ee099 authored by Robert Ricci's avatar Robert Ricci

Partway through a general editing pass

parent fd0b55cf
......@@ -2,7 +2,7 @@
@(require "defs.rkt")
@title[#:tag "cloudlab-tutorial" #:version apt-version]{CloudLab Basic Tutorial}
@title[#:tag "cloudlab-tutorial" #:version apt-version]{CloudLab 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
......@@ -15,11 +15,11 @@ full ability to customize and/or configure your installation of OpenStack.
In the process of taking this tutorial, you will learn to:
@itemlist[
@item{Log in to @(tb)}
@item{Log in to @(tb) using a GENI portal account}
@item{Create your own cloud by using a pre-defined profile}
@item{Access resources in an experiment that you create}
@item{Access resources in a cloud that you create}
@item{Use administrative access to customize your cloud}
@item{Clean up your experiment when finished}
@item{Clean up your cloud when finished}
@item{Learn where to get more information}
]
......@@ -29,19 +29,19 @@ This tutorial assumes that:
@itemlist[
@item{You have an existing account on the
@link["https://portal.geni.net"]{GENI portal}. Instructions for
@link["https://portal.geni.net"]{GENI portal}. (Instructions for
getting an account can be found
@link["http://groups.geni.net/geni/wiki/SignMeUp"]{here}}
@link["http://groups.geni.net/geni/wiki/SignMeUp"]{here}.)}
@item{You have set up an @(ssh) keypair in your GENI portal
account. Once logged into the portal, you can add a public key under
``Profile -> SSH Keys''.}
@item{You have an @(ssh) client set up to use that keypair}
account. (When logged into the GENI portal, you can add a public key
under ``Profile -> SSH Keys''.)}
@item{You have an @(ssh) client set up to use that keypair.}
]
@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
researchers and educators who work in cloud computing.
@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
......@@ -65,15 +65,23 @@ researchers and educators who work in cloud computing
@instructionstep["Select the GENI portal"
#:screenshot "tutorial/authorization-tool.png"]{
You will be asked which facility your account is with; select the GENI
icon.
You will be asked which facility your account is with. Select the GENI
icon, which will take you to the GENI portal. There are several other
facilities that are federated with @(tb), which can be found in the
drop-down list.
}
@instructionstep["Log into the GENI portal"
#:screenshot "tutorial/geni-login.png"]{
You will need to select the institution that is your identity provider.
Usually, it is the university you are affiliated with, and if you have
ever logged in before, it should be pre-selected.
You will be taken to the GENI portal, and will need to select the
institution that is your identity provider. Usually, this is the
university you are affiliated with. If your university is not in
the list, you may need to log in using the ``GENI Project Office''
identity provider. If you have ever logged in to the GENI portal
before, your identity provider should be pre-selected; if you
are not familiar with this login page, there is a good chance that
you don't have a GENI account and need to
@link["http://groups.geni.net/geni/wiki/SignMeUp"]{apply for one}.
}
@instructionstep["Log into your institution"
......@@ -87,9 +95,20 @@ researchers and educators who work in cloud computing
#:screenshot "tutorial/authorize.png"]{
Click the ``Authorize'' button: this will create a signed statement
authorizing the CloudLab portal to speak on your behalf. This
authorization is time-limited (see ``Advanced'' for the details), and
all actions the CloudLab portal takes on your behalf are clearly
traceable.}
authorization is time-limited (see ``Show Advanced'' for the details),
and all actions the CloudLab portal takes on your behalf are clearly
traceable. (For the curious: what's happening is that your browser
uses your GENI user ceritificate, which it obtained from the GENI
portal, to cryptographically sign a
@link["http://groups.geni.net/geni/wiki/GAPI_AM_API_DRAFT/SpeaksFor"]{``speaks-for'' credential }
for the @(tb) portal. This credential allows the @(tb) portal to
authenticate as itself to resources (including @(tb) resources) and
present proof, provided by yourself, that you have authorized it to
make calls on your behalf.)
}
@item{@margin-note{Once you have logged in once, your browser will cache many of
these steps and future logins will be simpler.}}
@instructionstep["Set Up an SSH Keypair in the GENI Portal"
#:screenshot "tutorial/portal-keypair.png"]{
......@@ -104,8 +123,6 @@ researchers and educators who work in cloud computing
}
]
@margin-note{Once you have logged in once, your browser will cache many of
these steps and future logins will be simpler.}
@section{Bringing up Your Own OpenStack}
......
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