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> <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> <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: <p>In /home/expo/boe create a new folder for the data , e.g. for 2029:
<ul> <ul>
<li>/home/expo/boe/data/boe29 <li>/home/expo/boe/data/boe29
@ -42,14 +44,22 @@ TemplateDir resources
#TimeoutURL /boe/boc/resources/timeout.js #TimeoutURL /boe/boc/resources/timeout.js
</pre> </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. 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/ . 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. 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). (Assuming you were on expo in the previous year).
Edit your file to have the line Edit your file to have the line
<pre> <pre>
IsAdmin 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> <p>Now read the <a href="boc.pdf">the documentation</a> (PDF) (for the version running on the expo server).</p>