users.scrbl 2.31 KB
Newer Older
Robert Ricci's avatar
Robert Ricci committed
1
#lang scribble/manual
Robert Ricci's avatar
Robert Ricci committed
2
@(require "defs.rkt")
Robert Ricci's avatar
Robert Ricci committed
3

4
@title[#:tag "users" #:version apt-version]{Apt Users}
Robert Ricci's avatar
Robert Ricci committed
5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52

You may either use Apt as a @seclink["guest-users"]{guest} or as a
@seclink["registered-users"]{registered user}.

Using Apt as a guest is a great way to give it a try; if you find it useful
and want to start using it for ``real work,'' you should
@seclink["register"]{sign up for a (free) account}, because a guest account (1)
won't let you hold your experiments for very long and (2) only allows you to
use virutal machines, which are not ideal for reproducing results, since they
don't have strong performance isolation from other users.

@section[#:tag "guest-users"]{Guest Users}

You may become a guest user simply by entering your email address on Apt's
@hyperlink[(apturl "instantiate.php")]{``Instantiate an Experiment''} page and 
picking a username. Apt will send you an email with a verification code - be
sure to check your spam folder if you don't receive it within a few minutes.

You'll remain logged in to Apt as long as you use the same browser and it
retains its cookies. If you get logged out for any reason, simply enter the
same email address and username again, and you'll be sent a new verification
code.

Guest users are limited in several ways:

@itemlist[
 @item{Guests are only allowed to hold experiments for a short period of
     time---a few hours to start with, and they can extend this up to a day}
 @item{Access to some resources (such as bare metal and large VMs) is not
     allowed, meaning that some profiles which require these things are not
     available}
 @item{Experiments held by guest user are very heavily firewalled---no outgoing
     connections are allowed, and almost all incoming traffic is blocked}
 @item{Guest users are only allowed to have one active experiment at a time}
 @item{Guest users may not create profiles}
]

If you are going to use Apt for much serious work, we encourage you to
@secref{register}.

@section[#:tag "registered-users"]{Registered Users}

Registering for an account is quick and easy. Registering doesn't cost
anything, it's simply for accountability. We just ask that if you're going to
use Apt for anything other than light use, you tell us a bit more about who you
are and what you want to use Apt for.

@subsection[#:tag "register"]{Register for an Account}
Robert Ricci's avatar
Robert Ricci committed
53 54

@TODO{Write this!}