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

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

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

12 13
@italic[(if (not (single-page)) (list "This document is also available as a " (hyperlink "cloudlab-manual.html" "single page")) "")]

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

20 21 22 23 24 25
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.

Robert Ricci's avatar
Robert Ricci committed
26
The current CloudLab deployment consists of more than 25,000 cores
27
distributed across three sites at the University of Wisconsin, Clemson
28
University, and the University of Utah. CloudLab interoperates with
29 30
existing testbeds including @hyperlink["http://www.geni.net"]{GENI} and
@hyperlink["http://www.emulab.net"]{Emulab}, to take advantage of
31 32
hardware at dozens of sites around the world.

33 34 35 36 37 38 39 40
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}.

41
@seclink["getting-started"]{Get started}!
42

Robert Ricci's avatar
Robert Ricci committed
43 44
@table-of-contents[]

45
@include-section["status-notes.scrbl"]
46
@include-section["getting-started.scrbl"]
47
@include-section["users.scrbl"]
48
@include-section["repeatable-research.scrbl"]
49
@include-section["creating-profiles.scrbl"]
50
@include-section["basic-concepts.scrbl"]
51
@include-section["reservations.scrbl"]
52
@include-section["geni-lib.scrbl"]
53
@include-section["advanced-topics.scrbl"]
54
@include-section["hardware.scrbl"]
55
@include-section["planned.scrbl"]
56
@include-section["cloudlab-tutorial.scrbl"]
Dmitry Duplyakin's avatar
Dmitry Duplyakin committed
57
@include-section["cloudlab-chef-tutorial.scrbl"]
58
@include-section["getting-help.scrbl"]