racket/collects/handin-server/scribblings/quick-start.scrbl
Eli Barzilay d5f1f59d77 The `https-port-number' configuration is meaningless, removed and
replaced with `use-https' which defaults to #t.  If the web server is
disabled, run a tiny "server" that spits out a message -- to avoid
students complaining that something is broken.

Configuration files with `https-port-number' will throw an error, and
should be upgraded.

svn: r17450
2009-12-31 07:43:23 +00:00

58 lines
1.8 KiB
Racket

#lang scribble/doc
@(require "common.ss")
@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.ss} with the following content:
@schemeblock[
((tester ("8fe4c11451281c094a6578e6ddbf5eed"
"Tester" "1" "test@cs")))]}
@item{Make a @filepath{test} subdirectory in your new directory.}
@item{Create a file @filepath{config.ss} with the following content:
@schemeblock[((active-dirs ("test")))]}
@item{In your new directory, run @commandline{mred-text -l handin-server}}
@item{In the @filepath{handin-client} collection, edit
@filepath{info.ss} and uncomment the lines that define
@scheme[server:port], @scheme[tools], @scheme[tool-names], and
@scheme[tool-icons].}
@item{Run @commandline{setup-plt -l handin-client}
NOTE: Under Windows, the executable is @exec{Setup PLT} instead of
@exec{setup-plt}.
NOTE: The command line arguments are optional, it restricts the
setup work to the specified collection.}
@item{Start DrScheme, 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.scm}.}
@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.}
]