Commit 90668988 authored by Stephane Glondu's avatar Stephane Glondu
Browse files

Documentation for "mkelection"

parent 284c77b3
......@@ -205,35 +205,30 @@ In the following, we assume `ocsigenserver` is properly configured.
### Setup a new election
1. Generate an UUID with the `uuidgen` command.
2. Ask each trustee to generate a keypair, and the credential
authority to generate credentials. Note that the UUID is needed
to perform credential generation.
3. Create a new directory in the data directory. For uniqueness, it
is suggested to include the UUID in the directory name. In the
following, we denote by `$DIR` the full path to this directory.
4. Go to Belenios source tree (we assume its full path is
`$BELENIOS`).
5. Edit `demo/template.ml` with the election parameters, and run
`make all`. In particular, you should edit:
* the UUID
* questions and answers
* dates of the voting period
6. Go to `$DIR`.
7. Concatenate all trustee public keys into a `public_keys.jsons`
file, and run `$BELENIOS/_build/demo/template.byte`. It should
generate `election.json` and `metadata.json`. The `ydump` tool
(from Yojson) can be used to pretty-print them.
8. (Optionally) Edit `election.json` and `metadata.json` to your
convenience.
9. Save the file with public credentials generated by the credential
authority into `public_creds.txt`.
10. Go to `$BELENIOS`.
11. Edit `demo/ocsigenserver.conf.in`, in particular:
1. Generate an UUID with the `uuidgen` command. Name it `$UUID`.
2. Create a new directory in the data directory. For uniqueness, it
is suggested to include `$UUID` in the directory name. In the
following, we denote by `$DIR` the full path to this directory
and by `$BELENIOS` the full path to the Belenios source tree.
3. Go to `$DIR`.
4. Ask the credential authority to generate credentials. Note that
`$UUID` is needed for that. Save the file with public
credentials into `public_creds.txt`.
5. Ask each trustee to generate a keypair. Concatenate all trustee
public keys into a `public_keys.jsons` file.
6. Edit `$BELENIOS/demo/templates/election.json`.
7. Run: `belenios-tool mkelection --uuid $UUID --group
$BELENIOS/demo/groups/default.json --template
$BELENIOS/demo/templates/election.json`. It should generate
`election.json` in the current directory.
8. (Optionally) Copy `$BELENIOS/demo/templates/metadata.json` to
`$DIR` and edit the dates in it.
9. Go to `$BELENIOS`.
10. Edit `demo/ocsigenserver.conf.in`, in particular:
* the admin password
* the UUID of the main election
* the data directory (see above)
12. Run `demo/run-server.sh`. This script is a wrapper around
11. Run `demo/run-server.sh`. This script is a wrapper around
`ocsigenserver` and takes the same options. In particular, the
`-V` option is useful for debugging and `--help` can be used to
get help.
......
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment