More boe documn.

This commit is contained in:
Philip Sargent 2023-03-21 00:54:37 +00:00 committed by Wookey
parent c8b8077d10
commit 3e2c49b8b1

View File

@ -24,6 +24,8 @@ The split mechanism transparently underlies everything, but for user-friendlines
<p>Source and docs for the upstream version are online at <a href="https://github.com/malc0/BoC">https://github.com/malc0/BoC</a> which has a link to a demonstration system that you can play with (CUCC meets 2014-15).</p>
<h2>Configure BOE for a new Expo</h2>
<p>You need to have a terminal running logged in to the server using ssh to do all this. Most expo treasurers will need to get a nerd to do this for them. Any Linux nerd, even if unfamiliar with boe, should be able to do all this if they have ssh access.
<p>In /home/expo/boe create a new folder for the data , e.g. for 2029:
<ul>
<li>/home/expo/boe/data/boe29
@ -42,14 +44,22 @@ TemplateDir resources
#TimeoutURL /boe/boc/resources/timeout.js
</pre>
Now the code is in the place that the webserver expects it, and the code is configured to point to the new data for 2029.
<p>
Now copy everything in the most recent year from, e.g. /home/expo/boe/boc-2028/ into /home/expo/boe/boc-2029/ .
Then go into the folder /home/expo/boe/data/boe29/ and delete the files for all the users except for you and wookey.
(Assuming you were on expo in the previous year).
Edit your file to have the line
<pre>
IsAdmin
</pre>From this point on all the configuration you do with be directly with the online BoE running on the server. Set up a password for yourself is the first thing to do.
</pre>
<p>Now if you didn't create a password for last year's expo, create a password like this (Wookey will tell you what the 'salt' is):
<pre>
perl -e "use Crypt::PasswdMD5;print unix_md5_crypt('password','salt');"
</pre>
and put it in data/boe29/users/yourname and
git commit any changes.
<p>
From this point on all the configuration you do with be directly with the online BoE running on the server. Log in and check it all works.
<p>Now read the <a href="boc.pdf">the documentation</a> (PDF) (for the version running on the expo server).</p>