tutorial-login-common.scrbl 5.05 KB
Newer Older
1 2 3 4 5 6
#lang scribble/manual

@(require "defs.rkt")

@title{Logging In}

7 8 9
@geniusers-only{
The first step is to log in to @(tb).  @clab-only{@(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
10 11
@link["https://www.emulab.net"]{Emulab} or
@link["http://geni.net"]{GENI}, then you already have an account at
12
@(tb).}
13

14
@geniusers-only{@section{Using a @(tb) Account}}
15 16

If you have signed up for an account at the @(tb) website, simply
17 18
open @url[apt-base-url] in your browser, click the ``Log In'' button,
enter your username and password@geniusers-only{, and @bold{skip to the next part of the tutorial}}.
19

20 21
@geniusers-only{
@clab-screenshot["tutorial/front-page.png"]
22 23 24 25 26 27 28 29 30

@section{Using a GENI Account}

If you have an account at the GENI portal, you will use the single-sign-on
features of the @(tb) and GENI portal.

@itemlist[#:style 'ordered

    @instructionstep["Open the web interface"
31 32
                     #:screenshot "tutorial/front-page.png"
		     #:screenshot-where "clab"]{
33 34 35 36 37 38
        To log in to @(tb) using a GENI account, start by visiting
        @url[apt-base-url] in your browser and using the ``Log In''
        button in the upper right.
    }

    @instructionstep["Click the \"GENI User\" button"
39 40
                     #:screenshot "tutorial/login-page.png"
		     #:screenshot-where "clab"]{
41 42 43 44 45 46
        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 @(tb). 
    }

    @instructionstep["Select the GENI portal"
47 48
                     #:screenshot "tutorial/authorization-tool.png"
		     #:screenshot-where "clab"]{
49 50 51 52 53 54 55
        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"
56 57
                     #:screenshot "tutorial/geni-login.png"
		     #:screenshot-where "clab"]{
58 59 60 61 62 63 64 65 66 67 68 69
        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"
70 71
                     #:screenshot "tutorial/utah-login.png"
		     #:screenshot-where "clab"]{
72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94
        This will bring you to your institution's standard login page, which you
        likely use to access many on-campus services. (Yours will look different
        from this one.)
    }

    @instructionstep["Authorize CloudLab to use your GENI account"]{
        @margin-note{What's happening in this step is that your browser
        uses your GENI user certificate (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 }
        that authorizes the @(tb) portal to make
        @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 @(tb) portal to speak on your behalf. This
        authorization is time-limited (see ``Show Advanced'' for the details),
        and all actions the @(tb) portal takes on your behalf are clearly
        traceable.

        If you'd like, you can click ``Remember This Decision'' to skip
        this step in the future (you will still be asked to log in to
        the GENI portal).

95
        @clab-screenshot["tutorial/authorize.png"]
96 97 98 99 100

    }


    @instructionstep["Set up an SSH keypair in the GENI portal"
101 102
                     #:screenshot "tutorial/portal-keypair.png"
		     #:screenshot-where "clab"]{
103 104 105 106 107 108 109 110 111 112 113 114 115 116
        Though not strictly required, many parts of this tutorial will
        work better if you have an @(ssh) public key associated with your GENI
        Portal account. To upload one, visit
        @link["http://portal.geni.net"]{portal.geni.net} and use the ``SSH
        Keys'' item on the menu that drops down under your name.

        If you are not familiar with @(ssh) keys, you may skip this step. You
        may find
        @link["https://help.github.com/articles/generating-ssh-keys/"]{GitHub's
        @(ssh) key page} helpful in learning how to generate and use them.

        @margin-note{When you create a new experiment, @(tb) grabs the set of @(ssh)
        keys you have set up at the time; any @(ssh) keys that you add later are
        not added to experiments that are already running.} } ]
117
}