cloudlab-manual.scrbl 2.45 KB
Newer Older
1 2 3 4 5
#lang scribble/manual
@(require racket/date)
@(require "defs.rkt")

@title[#:version apt-version
6
       #:date (date->string (current-date))]{The CloudLab Manual}
7 8

@author[
9
    "The CloudLab Team"
10 11
]

12
@bold{CloudLab is up and running, but in active development.
13 14
    For more information on the deployment schedule for the full version of
    CloudLab, see @hyperlink[(apturl)]{the CloudLab website}. Please also see
15 16
    the @seclink["status-notes"]{"Status Notes"} chapter of this document
    for notes regarding the status of the facility.}
17

18
@italic[(if (equal? doc-mode 'pdf)
Robert Ricci's avatar
Robert Ricci committed
19
    (list "The HTML version of this manual is available at " (hyperlink apt-doc-url apt-doc-url))
20 21 22
    (list "This manual is also available as a " (hyperlink "http://docs.cloudlab.us/manual.pdf" "PDF")))]


23 24 25 26 27 28 29 30 31 32 33
CloudLab is a "meta-cloud"---that is, it is not a cloud itself; rather, it is a
facility for building clouds. It provides bare-metal access and control over
a substantial set of computing, storage, and networking resources; on top of
this platform, users can install standard cloud software stacks, modify them,
or create entirely new ones.

The initial CloudLab deployment will consist of approximately 15,000 cores
distributed across three sites at the University of Wisconsin, Clemson
University, and the University of Utah. CloudLab will interoperate with
existing testbeds including @hyperlink["http://www.geni.net"]{GENI} and
@hyperlink["http://www.emulab.net"]{Emulab}, to take advantage of
34 35
hardware at dozens of sites around the world.

36 37 38 39 40 41 42 43
The control software for CloudLab is
@hyperlink["https://gitlab.flux.utah.edu/emulab"]{open source}, and is built
on the foundation established for @hyperlink["http://www.emulab.net"]{Emulab},
@hyperlink["http://www.geni.net"]{GENI}, and
@hyperlink["http://www.aptlab.net"]{Apt}. Pointers to the details of this
control system can be found on CloudLab's @hyperlink[(apturl
"/technology.php")]{technology page}.

44
Take a look at the @seclink["status-notes"]{status notes}, and then
45 46
@seclink["getting-started"]{get started}!

Robert Ricci's avatar
Robert Ricci committed
47 48
@table-of-contents[]

49
@include-section["status-notes.scrbl"]
50
@include-section["getting-started.scrbl"]
51
@include-section["users.scrbl"]
52
@include-section["repeatable-research.scrbl"]
53
@include-section["creating-profiles.scrbl"]
54
@include-section["basic-concepts.scrbl"]
55
@include-section["advanced-topics.scrbl"]
56
@include-section["hardware.scrbl"]
57
@include-section["planned.scrbl"]
58
@include-section["cloudlab-tutorial.scrbl"]
59
@include-section["getting-help.scrbl"]