racket/collects/handin-server/scribblings/quick-start.scrbl
2011-01-03 11:38:54 -06:00

53 lines
1.7 KiB
Racket

#lang scribble/doc
@(require "common.rkt")
@title{Quick Start for a Test Drive}
@itemize[
@item{Create a new directory.}
@item{Copy @filepath{server-cert.pem} from the
@filepath{handin-client} collection to the new directory.
NOTE: For real use, you need a new certificate.
NOTE: See also @secref{wheres-the-collection}.}
@item{Copy @filepath{private-key.pem} from the
@filepath{handin-server} collection to the new directory.
NOTE: For real use, you need a new key.}
@item{Create a file @filepath{users.rktd} with the following content:
@racketblock[
((tester ("8fe4c11451281c094a6578e6ddbf5eed"
"Tester" "1" "test@cs")))]}
@item{Make a @filepath{test} subdirectory in your new directory.}
@item{Create a file @filepath{config.rktd} with the following content:
@racketblock[((active-dirs ("test")))]}
@item{In your new directory, run
@commandline{gracket-text -l handin-server}}
@item{In the @filepath{handin-client} collection, edit
@filepath{info.rkt} and uncomment the lines that define
@racket[drracket-tools], @racket[drracket-tool-names],
@racket[drracket-tool-icons], and @racket[server:port].}
@item{Run @commandline{raco setup handin-client}}
@item{Start DrRacket, click @onscreen{Handin} to run the client,
submit with username ``@tt{tester}'' and password ``@tt{pw}''.
The submitted file will be @filepath{.../test/tester/handin.rkt}.}
@item{Check the status of your submission by pointing a web browser at
@tt{https://localhost:7979/}. Note the ``s'' in ``@tt{https}''. Use
the ``@tt{tester}'' username and ``@tt{pw}'' password, as before.
NOTE: The embedded web server can be disabled in the configuration
file if you don't want to use it.}
]