A-Eskwiki - User contributions [en]

Mail

2021-02-22T21:25:19Z

Arnold:

Bij A–Eskwadraat gebruiken we '''Maildir''' voor de opslag van e-mail van gebruikers. We raden gebruikers aan om niet direct de Maildirmappen te benaderen, maar om dit via [http://en.wikipedia.org/wiki/Internet_Message_Access_Protocol IMAP] of [http://www.washington.edu/alpine/ Alpine] te doen. De standaardconfiguratie van de meeste mailclients staat hier ook voor ingesteld.
Je kunt je mail bekijken op mail.a-eskwadraat.nl.
== Services ==

Op [[Haskell|haskell]] draait de virtuele machine vm-mailpp (spreek uit: mail plus plus) om het mailverkeer van en naar A-Eskwadraat te regelen:

*[http://www.postfix.org/ postfix] (''/etc/postfix/'') verwerkt in principe alle binnenkomende mails, en wat er waarheen doorgestuurd moet worden;
*[http://www.dovecot.org/ dovecot] (''/etc/dovecot/'') neemt de POP- en IMAP-servers voor zijn rekening en verzorgt authenticatie voor het versturen van mails;
*[https://www.amavis.org/ amavis] (''/etc/amavisd/'') geeft alle binnenkomende mails door aan SpamAssassin en ClamAV om gefilterd te worden;
*[http://spamassassin.apache.org/ SpamAssassin] (''/etc/mail/spamassassin/'') [[Mailfiltering|filtert]] de spam uit het binnenkomende mailverkeer;
*[http://http://www.clamav.net/lang/en/ ClamAV] (''/etc/clamd.d/'') scant het mailverkeer voor virussen en dergelijke;
*[https://roundcube.net/ RoundCube] (''/etc/roundcubemail/'', ''/usr/share/roundcubemail'') is een webmailclient die in een [https://www.apache.org/ apache] webserver op vm-mailpp draait;
*[http://www.list.org/ Mailman] (''/etc/mailman/'') Mailman is verantwoordelijk voor de mailing lists, zoals de BBCie-announce.

== Naamgeving Maildirmappen ==

Let op dat om voor dovecot begrijpbare namen te hebben, de mappen op in ''~/Maildir'' altijd met een punt moeten beginnen. Submappen werken ook op deze manier. Een paar voorbeelden:

*''~/Maildir/.Intro/'' voor de IMAP-map ''Intro'';
*''~/Maildir/.Sysop.postmaster/'' voor de map ''postmaster'' als submap van ''Sysop''.

Als de mappen via IMAP worden aangemaakt gebeurt dit automatisch.

== Postfix ==

Postfix is de SMTP server voor de vm-mailpp.

Postfix gebruikt meerdere ports om mail te ontvangen en te verwerken. Mail die wordt gestuurd door leden moet naar de SMTP daemon op port 587 (''submission'' poort) worden gestuurd. Authenticatie en TLS encryptie zijn een vereiste op deze verbinding. In de toekomst zal de [[Router|Router]] de encryptie tussen client en mail-server regelen. Alle andere mail komt binnen op port 25. Spam- en virus-filtering gebeurd via de SMTP daemons op ports 10025 en 10027 voor onbekende en bekende mail, respectievelijk.

In ''/etc/postfix/master.cf'' staat de configuratie van deze daemons. De configuratie in ''/etc/postfix/main.cf'' wordt gebruikt voor zaken die niet in ''master.cf'' zijn opgegeven; in principe staat hier de configuratie voor poort 25 en worden de opties specifiek voor de andere poorten opgegeven in ''master.cf''.

Een bug/feature van postfix die slecht gedocumenteerd is, is als volgt: wanneer postfix langer dan 10 seconden duurt over het authentiseren van een email, wordt deze geweigerd met een verkeerde foutmelding: "535 5.7.8 Error: authentication failed: Connection lost to authentication server (SMTP AUTH failed with the remote server)".

=== Transport ===

Eerst checkt Postfix of de inkomende mail aan een lokaal mailadres is gestuurd. Welke domeinen als 'lokaal' worden bestempeld staat in ''/etc/postfix/domains/local''. Voor lokale mailadressen geldt, dat het domein in de verdere configuratie kan worden weggelaten.<br/>Daarna checkt Postfix of de inkomende mail naar een virtueel domein is gestuurd. Mailadressen van domeinen zoals turingslegacy.nl worden herschreven naar lokale mailadressen (zonder domeinnaam). De virtuele domeinen staan in ''/etc/postfix/domains/virtual''.

De overblijvende adressen, worden opgezocht in de bestanden met aliases in /etc/postfix/aliases, om te zien of de mail toevallig naar een ander lokaal mailadres doorgestuurd moet worden. Postfix gebruikt hiervoor de bestanden in .db formaat, de tekstbestanden zonder extensie zijn voor ons als sysop leesbaar en te bewerken maar moeten wel met ''postalias'' in een .db bestand omgezet worden naar iedere wijziging.<br/>Als iemand dit vergeet na het aanpassen van een bestand met aliases, plaatst postfix een melding in ''/var/log/maillog'': "database file ''bestandsnaam''.db is older than source file ''bestandsnaam''".<br/>Nu blijven er als het goed is, alleen gebruikersnamen over die op het systeem bestaan. Voor deze gebruikers wordt het bestand ''.forward'' in de homedirectory van de gebruiker opgezocht.

Als in een ''.forward'' bestand de gebruikersnaam voorafgegaan door een backslash (\) wordt aangetroffen, wordt de mail in de Maildir map van die gebruiker geplaatst. Als een regel met een pipe (|) wordt aangetroffen, wordt het mailbericht doorgegeven als standard input aan het commando dat achter het |-teken staat. Andere regels met tekst worden geïnterpreteerd als mailadressen (lokaal zonder domeinnaam of willekeurig mailadres met domeinnaam) waarnaar de mail moet worden doorgestuurd.<br/>''Let op bij het gebruiken van de pipe (|): het kan zijn dat SELinux niet toestaat dat postfix een ander programma direct aanroept.''

Als de mail niet bij een lokaal of virtueel adres hoort, checkt postfix of de inkomende mail is gestuurd naar een domein waarvoor A-Eskwadraat mail relayet. Deze mail word onveranderd naar de mailserver van dat domein verstuurd (relaying). Dit voorkomt verlies van mail voor het externe domein wanneer hun mailserver uitvalt, aangezien A-Eskwadraat de secondary mailserver is voor dat domein. Een uitzondering op de regel is mail bedoeld voor de webserver. Mail aan de webcie komt binnen op de mail server, maar moet worden doorgestuurd naar de webserver. De verwijzingen zijn te vinden in ''/etc/postfix/transport_www'' en ''/etc/postfix/transport_regex''.

Let op dat deze uitleg heel erg bot is. Lees de relevante ''man'' pages van Postfix om te leren hoe mail word verwerkt. Let op dat veranderingen in een alias/transport/domain map niet worden opgemerkt tot het ''postmap'' of ''postalias'' op het bestand is aangeroepen!

=== Mail Authorisatie ===

Om te controleren of een gebruiker wel als een adres mag mailen wordt gebruik gemaakt van de smtpd_sender_login_maps optie voor postfix, die in een database de users opzoekt die als gegeven adres mogen versturen. Als er via SMTP een request gedaan wordt om van buitenaf een mail te versturen doet postfix een query en kijkt welke users als die alias mail mogen versturen. Deze config is op de vm-mailpp te vinden in `/etc/postfix/alias_auth.cf`.

De database wordt gegenereerd door een python script die op de vm-sysop staat bij de sysop api, aangezien daar de mail aliases al staan voor de alias_check. Het python script, te vinden in `/var/www/html/api/python/mail-authorization.py`, loopt recursief langs alle users die in cies, bestuur, extern of iba zitten en kijkt daarnaast ook naar mail aliassen. Aan de hand hiervan wordt met een sql query alle transitieve relaties expliciet gemaakt, zodat dit niet runtime gedaan moet worden. Als een alias naar een cie wordt doorgestuurd, en een user weer in die cie zit, wil je dat die user ook als die alias mag mailen. Als database wordt PostgreSQL gebruikt op de vm-database. De database die gebruikt wordt heet "mail". In de python code staan nog wat comments. Er draait op de vm-sysop een cron die af en toe de database refreshed. Daarnaast is het python script ook intern bereikbaar [http://vm-sysop.a-eskwadraat.nl/api/python/mail-authorization.py hier]. Bij het laden van deze pagina wordt de database gerefreshed. Op deze manier kan de database meteen gerefreshed worden zodra iemand toegevoegd is aan een cie. Als er in een alias een wildcard staat (*@bapc.eu: bapc), wat betekend dat alles van het domein bapc.eu naar de bapc commissie wordt gestuurd, wordt dit omgezet naar een SQL wildcard, wat uiteindelijk dus netjes werkt.

Er is reeds voorgekomen dat de cache van mailpp niet verversd werd waardoor er geen permissions kwamen voor gebruikers.

Als gebruiker x mag mailen als y@a-eskwadraat.nl, dan komen in de database de entries (x, y@a-eskwadraat.nl), (x@a-eskwadraat.nl, y) en (x@a-eskwadraat.nl, y@a-eskwadraat.nl) te staan. Dit omdat dingen soms worden opgevraagd met domain en soms zonder.

=== Mailfiltering ===

Postfix maakt gebruik van amavisd voor het filteren van de inkomende mail. Amavis is een interface voor SpamAssassin welke spam filtert en ClamAV welke mails op virussen scant. Check de configuratie op [[Vm-saltmaster|vm-saltmaster]] voor details.

Om de virus database up te daten:
<pre>freshclam
</pre>

== Mailman ==

Mailman is verantwoordelijk voor de infrastructuur van de mailing lists. De mailing lists zijn te vinden op [lists.a-eskwadraat.nl/mailman lists.a-eskwadraat.nl/mailman]. Er zijn twee belangrijke services om mailman te draaien: mailman en httpd. De configuratie van mailman bevind zich in ''/etc/mailman/'', de data bevind zich in ''/var/lib/mailman'', en de binaries bevinden zich in ''/usr/lib/mailman''.

Gebruik de scripts in /usr/lib/mailman/bin om de mailing lists vanaf de command-line te wijzigen. De volgende commando's zijn belangrijk bij het debuggen / migreren van mailman:

*check_perms: repareert de bestandsrechten van mailman-specifieke bestanden.
*with_list & fix_url: repareert de links van de mailman archieven indien deze zijn veranderd.

Lees de [http://wiki.list.org/DOC/4.09%20Summary%20of%20the%20mailman%20bin%20commands MailmanWiki] voor een samenvatting van alle commands.

Mailman werkt samen met de Postfix mailserver via de alias map ''/etc/mailman/aliases''. Voer het volgende commando uit na het toevoegen/verwijderen van een lijst zodat Postfix zijn alias database update:
<pre>postalias /etc/mailman/aliases
</pre>

Na een migratie van de mailman lijsten is het belangrijk om ''restorecon'' uit te voeren op ''/var/lib/mailman''. Mailman en SELinux werken prima samen zolang de rechten maar goed staan.
<pre># Samenvatting van een Mailman migratie.
# Op de nieuwe mailserver.
rsync -azv -e "ssh -i <sshkey>" <OUDEHOST>:/var/lib/mailman/ /var/lib/mailman/
restorecon -r /var/lib/mailman/
cd /usr/lib/mailman/
bin/check_perms -f
bin/withlist -l -a -r fix_url
</pre>

== Dovecot ==

Dovecot is de IMAP server verantwoordelijk voor het ophalen en beheren van de mail opgeslagen in de homedirs. Mail wordt opgeslagen in de .Maildir van een gebruik zijn home directory. De server luistert op poort 143 (standaard IMAP poort) en vereist een TLS-encrypted verbinding van de gebruiker. Het certificaat voor de verbinding is anders dan het certificaat van de webserver.  Dovecot authenticeert gebruikers door middel van LDAP. Dovecot werkt ook als authenticatie-server voor postfix door middel van een open socket. Een SELinux module is vereist om Postfix toegang te geven tot de socket.

Voor meer configuratie details, zie de configuratie op de salt-master. (CentOS 6: /srv/salt/centos/vm-mail/dovecot, CentOS 7: /srv/salt/centos7/dovecot)

'''AL DE CONFIGURATIE HIERONDER IS GIGANTISCH OUT OF DATE''' \/\/\/

== Configuratie mailfilters ==

Gebruik je een ''.forward'' of ''.procmailrc'' om e-mail direct in mappen te stoppen, let dan op de naamgeving (zie hierboven) en zorg ervoor dat de mappen altijd op een ''/'' eindigen. Begin je ''.procmailrc'' ook altijd met de regel

MAILDIR=$HOME/Maildir/

om te zorgen dat e-mail toch niet in ''/var/mail'' terechtkomt.

== Maak een mailserver met exim, en dovecot ==

Zorg eerst dat sendmail uit staat!
<pre>service sendmail stop
chkconfig sendmail off
</pre>

Bij voorkeur verwijder je ook de package voor [[Postfix|postfix]]. Deze is standaard bij CentOS geïnstalleerd.

=== Exim ===

Exim is een MTA (Mail Transfer Agent) en is ervoor om mailtjes te versturen, ontvangen, en doorsturen. Dit gebeurd uiteraard op de mailserver!

Installeer allereerst exim op de host.
<pre># yum install exim
</pre>

Verander vervolgens het configuratie bestand /etc/exim/exim.conf:
<pre># Het Mail domain - normaal gesproken a-eskwadraat.nl
primary_hostname = circle.a-eskwadraat.nl

# Weiger met ipv6 te werken.
local_interfaces = 0.0.0.0
disable_ipv6 = true

daemon_smtp_ports = smtp : submission
accept_8bitmime = true

# Lijsten van geldige mail domainin.
domainlist mailman_domains = CONFDIR/domains.mailman
domainlist local_domains = @ : CONFDIR/domains.local : +mailman_domains : lsearch;CONFDIR/domains.virtual
domainlist relay_to_domains = CONFDIR/domains.relay

hostlist relay_from_hosts = 10.14.3.0/22

# Backup mail server in het geval dat onze niet werkt.
hostlist mx_hosts = mail.wolffelaar.nl

qualify_domain = A-Eskwadraat.nl

queue_run_max = 250

smtp_accept_max = 100
smtp_accept_max_per_host = ${if match_ip{$sender_host_address}{+mx_hosts}{50}{10}}

received_headers_max = 30

RETRY_SECONDARY=F,90d,15m
RETRY_REST=F,2h,15m; G,16h,2h,1.5; F,4d,8h

acl_smtp_rcpt = acl_check_rcpt
acl_not_smtp_start = acl_check_not_smtp
acl_smtp_data = acl_check_data

host_lookup = *
helo_try_verify_hosts = !@ : !@[]
helo_allow_chars = _

# ClamAV - The Anti-Virus Scanner
av_scanner = clamd:/var/run/clamav/clamd.sock

# Custom 5s limiet.
rfc1413_query_timeout = 5s

# Mailman support, als per /usr/share/doc/mailman/README.EXIM.gz
MAILMAN_HOME=/var/lib/mailman
MAILMAN_WRAP=/usr/lib/mailman/mail/mailman
MAILMAN_USER=mailman
MAILMAN_GROUP=mailman
</pre>

=== Dovecot ===

Dovecot is een IMAP en POP3 server, wat inhoud dat het mailtjes kan ontvangen, iets wat best wel handig is om te hebben. Installeer dovecot op je mailserver als je dat nog niet gedaan hebt. Verander dan nu het volgende:

In /etc/dovecot/dovecot.conf:

*protocols = imap
*login_trusted_networks = <ip-adressen die je vertrouwd>

In /etc/dovecot/conf.d/10-mail.conf

*mail_location = maildir:~/Maildir
*lock_method = dotlock

In /etc/dovecot/conf.d/10-auth.conf

*disable_plaintext_auth = no
*auth_realms = aeskwadraat
*auth_default_realm = aeskwadraat
*auth_gssapi_hostname = <ipa-server>
*auth_krb5_keytab = /etc/dovecot/krb5.keytab
*auth_mechanisms = plain gssapi

en zet op het einde
<pre>userdb {
driver = static
args = uid=dovecot gid=dovecot home=/var/spool/mail/%u
}
</pre>

Maak nu op de ipa-server een service imap aan met de mailserver als host. Dit kan je doen via de webinterface. Voer vervolgens het volgende uit op de mailserver:
<pre>kinit admin
ipa-getkeytab -s <ipa-server> -p imap/<mailserver> -k /etc/dovecot/krb5.keytab
chown root:dovecot /etc/dovecot/krb5.keytab
chmod 640 /etc/dovecot/krb5.keytab
</pre>

Restart dovecot en zet hem standaard aan:
<pre>service dovecot restart
chkconfig dovecot on
</pre>

Zet tenslotte nog met system-config-firewall-tui 'imap over ssl' en 'mail (smtp)' aan, en voila! Je kan nu met ipa-users gebruik maken van IMAP om mailtjes te ontvangen!

Je kan eventueel in /etc/postfix/main.cf en /etc/dovecot/conf.d/10-mail.conf nog het een ander van waar de mail wordt opgeslagen veranderen.

=== Spamassassin ===

Spamassassin is een mailfilteringprogramma voor spam. Om het te installeren:
<pre>yum install spamassassin
</pre>

Maak nu de user en group spamd aan:
<pre>groupadd -g 5001 spamd
useradd -u 5001 -g spamd -s /sbin/nologin -d /var/lib/spamassassin spamd
mkdir /var/lib/spamassassin
chown spamd:spamd /var/lib/spamassassin
</pre>

Zet dan het volgende in /etc/mail/spamassassin/local.cf:
<pre>required_score 5.0
report_safe 0
rewrite_header Subject [***SPAM***]

# Enable the Bayes system
use_bayes 1
use_bayes_rules 1
# Enable Bayes auto-learning
bayes_auto_learn 1
</pre>

Verander nu in /etc/postfix/master.cf
<pre>smtp inet n - n - - smtpd
</pre>

in
<pre>smtp inet n - n - - smtpd -o content_filter=spamassassin
</pre>

en stop op het einde van master.cf:
<pre>spamassassin unix - n n - - pipe flags=R user=spamd argv=/usr/bin/spamc -e /usr/sbin/sendmail -oi -f ${sender} ${recipient}
</pre>

Restart nu spamassassin en postfix:
<pre>chkconfig spamassassin on
service spamassassin restart
service postfix restart
</pre>

=== Aliases ===

In postfix staan de locaties van de aliases in /etc/postfix/main.cf. Deze kan je vinden bij de regel 'alias_maps = ...'. Als je een nieuw aliasbestand wilt toevoegen, voeg dit dan ook toe bij deze regel als hash:<bestandslocatie>. Vergeet ook niet om dit toe te voegen bij alias_database!.

De aliases zelf staan geconfigureerd in de aliasbestanden die te vinden zijn onder /etc/postfix/alias/. Als je een nieuwe alias in een bestand hebt gezet moet je het db-bestand up-to-date make door het commando 'postalias *bestand*' uitvoeren. Let erop dat de bestandsnaam de naam van het bestand is wat je gewijzigd hebt, niet een bestand met extensie '.db'.

Op het moment van schrijven hebben we 4 alias bestanden (bestuur, cies, mensjes en standaard). Als je een alias toevoegt of veranderd doe je dit in het bijbehorende alias bestand (bestuur gerelateerde aliassen in "bestuur", cies gerelateerde aliassen in "cies", etc.).

Als voorbeeld gaan we de alias sokken@a-eskwadraat aanmaken voor Michal en Rosanne. Dit is niet bestuur of cies gerelateerd dus zetten we deze alias in het bestand mensjes. Navigeer naar /etc/postfix/alias en open het bestand mensjes. Je begint met de alias gevolgd door een dubbele punt en dan A-eskwadraat gebruikersnaam(en) waarvoor de alias bedoeld is. In het geval van sokken@a-eskwadraat komt dat er dus als volgt uit te zien:

<pre>sokken: michalj, rosanne</pre>

Vervolgens moet deze wijziging nog in de database gezet worden dit gebeurt met:

<pre>postalias mensjes</pre>

Nu gaan de mailtjes die binnenkomen op sokken@a-eskwadraat naar Michal en Rosanne!

==== Lijst van alle forwards maken ====

===== Stap 1 =====

Maak een lijst die voor elke alias geeft waar het naar geforward wordt:

<pre>postalias -s [naam database bestand (zonder .db)]</pre>

Het onderstaande lijstje moeten we handmatig meenemen en is gebaseerd op de aliassen in het standaard.db bestand:

<pre>
abuse: postmaster
backup: root
hostmaster: root
irc: root
list: root
listmaster: root
logcheck: root
postmaster: sysop-postmaster, sysop
root: sysop
selinux: root
webmaster: webcie
www-data: webcie
mailer-daemon: postmaster
mailman-owner: listmaster
majordom: root
uucp: root
www-dmz: webmaster
</pre>

Let op: Er zijn ook een soort aliassen in de /etc/mailman/ map, waarschijnlijk bedoeld voor mailing lists.

Ook nog even kijken naar de aliasen in /etc/aliases.db

== Instellingen ==

=== Postfix ===

==== Mail relay ====

Postfix kan mail relayen naar een extern domein. Hiervoor is de volgende regel:
<pre>relay_domains = $mydestination, hash:/etc/postfix/domains.relay
</pre>

In het bestand /etc/postfix/domains.relay staat de lijst van alle externe domains waar mail naar toe gerelayed wordt. Als je iets in het bestand wijzigt, vergeet dan niet om daarna het commando
<pre>postmap /etc/postfix/domains.relay
</pre>

uit te voeren.

==== Whitelist ====

Postfix kan gebruik maken van een whitelist. Zorg hiervoor dat er het volgende in /etc/postfix/main.cf staat:
<pre>smtpd_client_restrictions = check_client_access hash:/etc/postfix/client.access
</pre>

In het bestand /etc/postfix/client.access staat de lijst van alle domains die geweigerd en toegelaten worden. Als je hier iets in verandert, vergeet dan niet om uit te voeren
<pre>postmap /etc/postfix/access.client
</pre>

== SquirrelMail ==

SquirrelMail is een webmail-client.

=== SquirrelMail installeren ===

Installeer eerst natuurlijk Squirrelmail:
<pre>yum install squirrelmail
</pre>

Zorg ervoor dat httpd standaard aan staat en start httpd:
<pre>chkconfig httpd on
service httpd start
</pre>

Verander nu het volgende in /etc/squirrelmail/config.php:
<pre>$org_name = "A-Eskwadraat";
$org_logo = SM_PATH . 'images/sm_logo.png';
$org_logo_width = '308';
$org_logo_height = '111';
$org_title = 'A-Eskwadraat SquirrelMail $version";
$signout_page = 'vm-mail.a-eskwadraat.nl';

$domain = 'circle.a-eskwadraat.nl';
$imapServerAddress = 'localhost';
$useSendmail = false;
$smtpServerAddress = 'localhost';
$pop_before_smtp = false;

</pre>

Zet nu het A-Eskwadraat logo in de squirrelmail config map.
<pre>setsebool -P httpd_can_network_connect 1
</pre>

== RoundcubeMail ==

Roundcube is ook een webmail client.

=== Installeren ===

Op vm-salt-master staat een configuratie voor een Roundcube mail VM met een korte readme. Deze zorgt ervoor dat httpd, roundcubemail en mariadb geinstalleerd staan. Salt een VM met deze configuratie.
<pre>salt '$hostname' state.highstate
</pre>

Laat vervolgens httpd van die VM door de firewall heen. Daarna moet de database voor Roundcube geinitialiseerd worden. Dit gaat met mysql.
<pre>CREATE DATABASE roundcubemail;
GRANT ALL PRIVILEGES on roundcubemail.* TO roundcube@localhost IDENTIFIED BY '$password';
FLUSH PRIVILEGES;
</pre>

Nu moet de timezone nog even ingesteld worden in /etc/php.ini op de roundcube VM. Daarna moeten er nog de juiste tables in de database worden gezet. Dit kan door op de nieuwe VM de bestanden in /etc/roundcubemail/databasefiles te runnen met mysql.
<pre>mysql roundcubemail < mysql.initial.sql
</pre>
[[Category:Sysop]]

Mail

2021-02-22T20:52:46Z

Arnold:

Bij A–Eskwadraat gebruiken we '''Maildir''' voor de opslag van e-mail van gebruikers. We raden gebruikers aan om niet direct de Maildirmappen te benaderen, maar om dit via [http://en.wikipedia.org/wiki/Internet_Message_Access_Protocol IMAP] of [http://www.washington.edu/alpine/ Alpine] te doen. De standaardconfiguratie van de meeste mailclients staat hier ook voor ingesteld.
Je kunt je mail bekijken op mail.a-eskwadraat.nl.
== Services ==

Op [[Haskell|haskell]] draait de virtuele machine vm-mailpp (spreek uit: mail plus plus) om het mailverkeer van en naar A-Eskwadraat te regelen:

*[http://www.postfix.org/ postfix] (''/etc/postfix/'') verwerkt in principe alle binnenkomende mails, en wat er waarheen doorgestuurd moet worden;
*[http://www.dovecot.org/ dovecot] (''/etc/dovecot/'') neemt de POP- en IMAP-servers voor zijn rekening en verzorgt authenticatie voor het versturen van mails;
*[https://www.amavis.org/ amavis] (''/etc/amavisd/'') geeft alle binnenkomende mails door aan SpamAssassin en ClamAV om gefilterd te worden;
*[http://spamassassin.apache.org/ SpamAssassin] (''/etc/mail/spamassassin/'') [[Mailfiltering|filtert]] de spam uit het binnenkomende mailverkeer;
*[http://http://www.clamav.net/lang/en/ ClamAV] (''/etc/clamd.d/'') scant het mailverkeer voor virussen en dergelijke;
*[https://roundcube.net/ RoundCube] (''/etc/roundcubemail/'', ''/usr/share/roundcubemail'') is een webmailclient die in een [https://www.apache.org/ apache] webserver op vm-mailpp draait;
*[http://www.list.org/ Mailman] (''/etc/mailman/'') Mailman is verantwoordelijk voor de mailing lists, zoals de BBCie-announce.

== Naamgeving Maildirmappen ==

Let op dat om voor dovecot begrijpbare namen te hebben, de mappen op in ''~/Maildir'' altijd met een punt moeten beginnen. Submappen werken ook op deze manier. Een paar voorbeelden:

*''~/Maildir/.Intro/'' voor de IMAP-map ''Intro'';
*''~/Maildir/.Sysop.postmaster/'' voor de map ''postmaster'' als submap van ''Sysop''.

Als de mappen via IMAP worden aangemaakt gebeurt dit automatisch.

== Postfix ==

Postfix is de SMTP server voor de vm-mailpp.

Postfix gebruikt meerdere ports om mail te ontvangen en te verwerken. Mail die wordt gestuurd door leden moet naar de SMTP daemon op port 587 (''submission'' poort) worden gestuurd. Authenticatie en TLS encryptie zijn een vereiste op deze verbinding. In de toekomst zal de [[Router|Router]] de encryptie tussen client en mail-server regelen. Alle andere mail komt binnen op port 25. Spam- en virus-filtering gebeurd via de SMTP daemons op ports 10025 en 10027 voor onbekende en bekende mail, respectievelijk.

In ''/etc/postfix/master.cf'' staat de configuratie van deze daemons. De configuratie in ''/etc/postfix/main.cf'' wordt gebruikt voor zaken die niet in ''master.cf'' zijn opgegeven; in principe staat hier de configuratie voor poort 25 en worden de opties specifiek voor de andere poorten opgegeven in ''master.cf''.

Een bug/feature van postfix die slecht gedocumenteerd is, is als volgt: wanneer postfix langer dan 10 seconden duurt over het authentiseren van een email, wordt deze geweigerd met een verkeerde foutmelding: "535 5.7.8 Error: authentication failed: Connection lost to authentication server (SMTP AUTH failed with the remote server)".

=== Transport ===

Eerst checkt Postfix of de inkomende mail aan een lokaal mailadres is gestuurd. Welke domeinen als 'lokaal' worden bestempeld staat in ''/etc/postfix/domains/local''. Voor lokale mailadressen geldt, dat het domein in de verdere configuratie kan worden weggelaten.<br/>Daarna checkt Postfix of de inkomende mail naar een virtueel domein is gestuurd. Mailadressen van domeinen zoals turingslegacy.nl worden herschreven naar lokale mailadressen (zonder domeinnaam). De virtuele domeinen staan in ''/etc/postfix/domains/virtual''.

De overblijvende adressen, worden opgezocht in de bestanden met aliases in /etc/postfix/aliases, om te zien of de mail toevallig naar een ander lokaal mailadres doorgestuurd moet worden. Postfix gebruikt hiervoor de bestanden in .db formaat, de tekstbestanden zonder extensie zijn voor ons als sysop leesbaar en te bewerken maar moeten wel met ''postalias'' in een .db bestand omgezet worden naar iedere wijziging.<br/>Als iemand dit vergeet na het aanpassen van een bestand met aliases, plaatst postfix een melding in ''/var/log/maillog'': "database file ''bestandsnaam''.db is older than source file ''bestandsnaam''".<br/>Nu blijven er als het goed is, alleen gebruikersnamen over die op het systeem bestaan. Voor deze gebruikers wordt het bestand ''.forward'' in de homedirectory van de gebruiker opgezocht.

Als in een ''.forward'' bestand de gebruikersnaam voorafgegaan door een backslash (\) wordt aangetroffen, wordt de mail in de Maildir map van die gebruiker geplaatst. Als een regel met een pipe (|) wordt aangetroffen, wordt het mailbericht doorgegeven als standard input aan het commando dat achter het |-teken staat. Andere regels met tekst worden geïnterpreteerd als mailadressen (lokaal zonder domeinnaam of willekeurig mailadres met domeinnaam) waarnaar de mail moet worden doorgestuurd.<br/>''Let op bij het gebruiken van de pipe (|): het kan zijn dat SELinux niet toestaat dat postfix een ander programma direct aanroept.''

Als de mail niet bij een lokaal of virtueel adres hoort, checkt postfix of de inkomende mail is gestuurd naar een domein waarvoor A-Eskwadraat mail relayet. Deze mail word onveranderd naar de mailserver van dat domein verstuurd (relaying). Dit voorkomt verlies van mail voor het externe domein wanneer hun mailserver uitvalt, aangezien A-Eskwadraat de secondary mailserver is voor dat domein. Een uitzondering op de regel is mail bedoeld voor de webserver. Mail aan de webcie komt binnen op de mail server, maar moet worden doorgestuurd naar de webserver. De verwijzingen zijn te vinden in ''/etc/postfix/transport_www'' en ''/etc/postfix/transport_regex''.

Let op dat deze uitleg heel erg bot is. Lees de relevante ''man'' pages van Postfix om te leren hoe mail word verwerkt. Let op dat veranderingen in een alias/transport/domain map niet worden opgemerkt tot het ''postmap'' of ''postalias'' op het bestand is aangeroepen!

=== Mail Authorisatie ===

Om te controleren of een gebruiker wel als een adres mag mailen wordt gebruik gemaakt van de smtpd_sender_login_maps optie voor postfix, die in een database de users opzoekt die als gegeven adres mogen versturen. Als er via SMTP een request gedaan wordt om van buitenaf een mail te versturen doet postfix een query en kijkt welke users als die alias mail mogen versturen. Deze config is op de vm-mailpp te vinden in `/etc/postfix/alias_auth.cf`.

De database wordt gegenereerd door een python script die op de vm-sysop staat bij de sysop api, aangezien daar de mail aliases al staan voor de alias_check. Het python script, te vinden in `/var/www/html/api/python/mail-authorization.py`, loopt recursief langs alle users die in cies, bestuur, extern of iba zitten en kijkt daarnaast ook naar mail aliassen. Aan de hand hiervan wordt met een sql query alle transitieve relaties expliciet gemaakt, zodat dit niet runtime gedaan moet worden. Als een alias naar een cie wordt doorgestuurd, en een user weer in die cie zit, wil je dat die user ook als die alias mag mailen. Als database wordt PostgreSQL gebruikt op de vm-database. De database die gebruikt wordt heet "mail". In de python code staan nog wat comments. Er draait op de vm-sysop een cron die af en toe de database refreshed. Daarnaast is het python script ook intern bereikbaar [http://vm-sysop.a-eskwadraat.nl/api/python/mail-authorization.py hier]. Bij het laden van deze pagina wordt de database gerefreshed. Op deze manier kan de database meteen gerefreshed worden zodra iemand toegevoegd is aan een cie. Als er in een alias een wildcard staat (*@bapc.eu: bapc), wat betekend dat alles van het domein bapc.eu naar de bapc commissie wordt gestuurd, wordt dit omgezet naar een SQL wildcard, wat uiteindelijk dus netjes werkt.

Er is reeds voorgekomen dat de cache van mailpp niet verversd werd waardoor er geen permissions kwamen voor gebruikers.

Als gebruiker x mag mailen als y@a-eskwadraat.nl, dan komen in de database de entries (x, y@a-eskwadraat.nl), (x@a-eskwadraat.nl, y) en (x@a-eskwadraat.nl, y@a-eskwadraat.nl) te staan. Dit omdat dingen soms worden opgevraagd met domain en soms zonder.

=== Mailfiltering ===

Postfix maakt gebruik van amavisd voor het filteren van de inkomende mail. Amavis is een interface voor SpamAssassin welke spam filtert en ClamAV welke mails op virussen scant. Check de configuratie op [[Vm-saltmaster|vm-saltmaster]] voor details.

Om de virus database up te daten:
<pre>freshclam
</pre>

== Mailman ==

Mailman is verantwoordelijk voor de infrastructuur van de mailing lists. De mailing lists zijn te vinden op [lists.a-eskwadraat.nl/mailman lists.a-eskwadraat.nl/mailman]. Er zijn twee belangrijke services om mailman te draaien: mailman en httpd. De configuratie van mailman bevind zich in ''/etc/mailman/'', de data bevind zich in ''/var/lib/mailman'', en de binaries bevinden zich in ''/usr/lib/mailman''.

Gebruik de scripts in /usr/lib/mailman/bin om de mailing lists vanaf de command-line te wijzigen. De volgende commando's zijn belangrijk bij het debuggen / migreren van mailman:

*check_perms: repareert de bestandsrechten van mailman-specifieke bestanden.
*with_list & fix_url: repareert de links van de mailman archieven indien deze zijn veranderd.

Lees de [http://wiki.list.org/DOC/4.09%20Summary%20of%20the%20mailman%20bin%20commands MailmanWiki] voor een samenvatting van alle commands.

Mailman werkt samen met de Postfix mailserver via de alias map ''/etc/mailman/aliases''. Voer het volgende commando uit na het toevoegen/verwijderen van een lijst zodat Postfix zijn alias database update:
<pre>postalias /etc/mailman/aliases
</pre>

Na een migratie van de mailman lijsten is het belangrijk om ''restorecon'' uit te voeren op ''/var/lib/mailman''. Mailman en SELinux werken prima samen zolang de rechten maar goed staan.
<pre># Samenvatting van een Mailman migratie.
# Op de nieuwe mailserver.
rsync -azv -e "ssh -i <sshkey>" <OUDEHOST>:/var/lib/mailman/ /var/lib/mailman/
restorecon -r /var/lib/mailman/
cd /usr/lib/mailman/
bin/check_perms -f
bin/withlist -l -a -r fix_url
</pre>

== Dovecot ==

Dovecot is de IMAP server verantwoordelijk voor het ophalen en beheren van de mail opgeslagen in de homedirs. Mail wordt opgeslagen in de .Maildir van een gebruik zijn home directory. De server luistert op poort 143 (standaard IMAP poort) en vereist een TLS-encrypted verbinding van de gebruiker. Het certificaat voor de verbinding is anders dan het certificaat van de webserver.  Dovecot authenticeert gebruikers door middel van LDAP. Dovecot werkt ook als authenticatie-server voor postfix door middel van een open socket. Een SELinux module is vereist om Postfix toegang te geven tot de socket.

Voor meer configuratie details, zie de configuratie op de salt-master. (CentOS 6: /srv/salt/centos/vm-mail/dovecot, CentOS 7: /srv/salt/centos7/dovecot)

'''AL DE CONFIGURATIE HIERONDER IS GIGANTISCH OUT OF DATE''' \/\/\/

== Configuratie mailfilters ==

Gebruik je een ''.forward'' of ''.procmailrc'' om e-mail direct in mappen te stoppen, let dan op de naamgeving (zie hierboven) en zorg ervoor dat de mappen altijd op een ''/'' eindigen. Begin je ''.procmailrc'' ook altijd met de regel

MAILDIR=$HOME/Maildir/

om te zorgen dat e-mail toch niet in ''/var/mail'' terechtkomt.

== Maak een mailserver met exim, en dovecot ==

Zorg eerst dat sendmail uit staat!
<pre>service sendmail stop
chkconfig sendmail off
</pre>

Bij voorkeur verwijder je ook de package voor [[Postfix|postfix]]. Deze is standaard bij CentOS geïnstalleerd.

=== Exim ===

Exim is een MTA (Mail Transfer Agent) en is ervoor om mailtjes te versturen, ontvangen, en doorsturen. Dit gebeurd uiteraard op de mailserver!

Installeer allereerst exim op de host.
<pre># yum install exim
</pre>

Verander vervolgens het configuratie bestand /etc/exim/exim.conf:
<pre># Het Mail domain - normaal gesproken a-eskwadraat.nl
primary_hostname = circle.a-eskwadraat.nl

# Weiger met ipv6 te werken.
local_interfaces = 0.0.0.0
disable_ipv6 = true

daemon_smtp_ports = smtp : submission
accept_8bitmime = true

# Lijsten van geldige mail domainin.
domainlist mailman_domains = CONFDIR/domains.mailman
domainlist local_domains = @ : CONFDIR/domains.local : +mailman_domains : lsearch;CONFDIR/domains.virtual
domainlist relay_to_domains = CONFDIR/domains.relay

hostlist relay_from_hosts = 10.14.3.0/22

# Backup mail server in het geval dat onze niet werkt.
hostlist mx_hosts = mail.wolffelaar.nl

qualify_domain = A-Eskwadraat.nl

queue_run_max = 250

smtp_accept_max = 100
smtp_accept_max_per_host = ${if match_ip{$sender_host_address}{+mx_hosts}{50}{10}}

received_headers_max = 30

RETRY_SECONDARY=F,90d,15m
RETRY_REST=F,2h,15m; G,16h,2h,1.5; F,4d,8h

acl_smtp_rcpt = acl_check_rcpt
acl_not_smtp_start = acl_check_not_smtp
acl_smtp_data = acl_check_data

host_lookup = *
helo_try_verify_hosts = !@ : !@[]
helo_allow_chars = _

# ClamAV - The Anti-Virus Scanner
av_scanner = clamd:/var/run/clamav/clamd.sock

# Custom 5s limiet.
rfc1413_query_timeout = 5s

# Mailman support, als per /usr/share/doc/mailman/README.EXIM.gz
MAILMAN_HOME=/var/lib/mailman
MAILMAN_WRAP=/usr/lib/mailman/mail/mailman
MAILMAN_USER=mailman
MAILMAN_GROUP=mailman
</pre>

=== Dovecot ===

Dovecot is een IMAP en POP3 server, wat inhoud dat het mailtjes kan ontvangen, iets wat best wel handig is om te hebben. Installeer dovecot op je mailserver als je dat nog niet gedaan hebt. Verander dan nu het volgende:

In /etc/dovecot/dovecot.conf:

*protocols = imap
*login_trusted_networks = <ip-adressen die je vertrouwd>

In /etc/dovecot/conf.d/10-mail.conf

*mail_location = maildir:~/Maildir
*lock_method = dotlock

In /etc/dovecot/conf.d/10-auth.conf

*disable_plaintext_auth = no
*auth_realms = aeskwadraat
*auth_default_realm = aeskwadraat
*auth_gssapi_hostname = <ipa-server>
*auth_krb5_keytab = /etc/dovecot/krb5.keytab
*auth_mechanisms = plain gssapi

en zet op het einde
<pre>userdb {
driver = static
args = uid=dovecot gid=dovecot home=/var/spool/mail/%u
}
</pre>

Maak nu op de ipa-server een service imap aan met de mailserver als host. Dit kan je doen via de webinterface. Voer vervolgens het volgende uit op de mailserver:
<pre>kinit admin
ipa-getkeytab -s <ipa-server> -p imap/<mailserver> -k /etc/dovecot/krb5.keytab
chown root:dovecot /etc/dovecot/krb5.keytab
chmod 640 /etc/dovecot/krb5.keytab
</pre>

Restart dovecot en zet hem standaard aan:
<pre>service dovecot restart
chkconfig dovecot on
</pre>

Zet tenslotte nog met system-config-firewall-tui 'imap over ssl' en 'mail (smtp)' aan, en voila! Je kan nu met ipa-users gebruik maken van IMAP om mailtjes te ontvangen!

Je kan eventueel in /etc/postfix/main.cf en /etc/dovecot/conf.d/10-mail.conf nog het een ander van waar de mail wordt opgeslagen veranderen.

=== Spamassassin ===

Spamassassin is een mailfilteringprogramma voor spam. Om het te installeren:
<pre>yum install spamassassin
</pre>

Maak nu de user en group spamd aan:
<pre>groupadd -g 5001 spamd
useradd -u 5001 -g spamd -s /sbin/nologin -d /var/lib/spamassassin spamd
mkdir /var/lib/spamassassin
chown spamd:spamd /var/lib/spamassassin
</pre>

Zet dan het volgende in /etc/mail/spamassassin/local.cf:
<pre>required_score 5.0
report_safe 0
rewrite_header Subject [***SPAM***]

# Enable the Bayes system
use_bayes 1
use_bayes_rules 1
# Enable Bayes auto-learning
bayes_auto_learn 1
</pre>

Verander nu in /etc/postfix/master.cf
<pre>smtp inet n - n - - smtpd
</pre>

in
<pre>smtp inet n - n - - smtpd -o content_filter=spamassassin
</pre>

en stop op het einde van master.cf:
<pre>spamassassin unix - n n - - pipe flags=R user=spamd argv=/usr/bin/spamc -e /usr/sbin/sendmail -oi -f ${sender} ${recipient}
</pre>

Restart nu spamassassin en postfix:
<pre>chkconfig spamassassin on
service spamassassin restart
service postfix restart
</pre>

=== Aliases ===

In postfix staan de locaties van de aliases in /etc/postfix/main.cf. Deze kan je vinden bij de regel 'alias_maps = ...'. Als je een nieuw aliasbestand wilt toevoegen, voeg dit dan ook toe bij deze regel als hash:<bestandslocatie>. Vergeet ook niet om dit toe te voegen bij alias_database!.

De aliases zelf staan geconfigureerd in de aliasbestanden die te vinden zijn onder /etc/postfix/alias/. Als je een nieuwe alias in een bestand hebt gezet moet je het db-bestand up-to-date make door het commando 'postalias *bestand*' uitvoeren. Let erop dat de bestandsnaam de naam van het bestand is wat je gewijzigd hebt, niet een bestand met extensie '.db'.

Op het moment van schrijven hebben we 4 alias bestanden (bestuur, cies, mensjes en standaard). Als je een alias toevoegt of veranderd doe je dit in het bijbehorende alias bestand (bestuur gerelateerde aliassen in "bestuur", cies gerelateerde aliassen in "cies", etc.).

Als voorbeeld gaan we de alias sokken@a-eskwadraat aanmaken voor Michal en Rosanne. Dit is niet bestuur of cies gerelateerd dus zetten we deze alias in het bestand mensjes. Navigeer naar /etc/postfix/alias en open het bestand mensjes. Je begint met de alias gevolgd door een dubbele punt en dan A-eskwadraat gebruikersnaam(en) waarvoor de alias bedoeld is. In het geval van sokken@a-eskwadraat komt dat er dus als volgt uit te zien:

<pre>sokken: michalj, rosanne</pre>

Vervolgens moet deze wijziging nog in de database gezet worden dit gebeurt met:

<pre>postalias mensjes</pre>

Nu gaan de mailtjes die binnenkomen op sokken@a-eskwadraat naar Michal en Rosanne!

==== Lijst van alle forwards maken ====

===== Stap 1 =====

Maak een lijst die voor elke alias geeft waar het naar geforward wordt:

<pre>postalias -s [naam database bestand (zonder .db)]</pre>

Het onderstaande lijstje moeten we handmatig meenemen en is gebaseerd op de aliassen in het standaard.db bestand:

<pre>
abuse: postmaster
backup: root
hostmaster: root
irc: root
list: root
listmaster: root
logcheck: root
postmaster: sysop-postmaster, sysop
root: sysop
selinux: root
webmaster: webcie
www-data: webcie
mailer-daemon: postmaster
mailman-owner: listmaster
majordom: root
uucp: root
www-dmz: webmaster
</pre>

== Instellingen ==

=== Postfix ===

==== Mail relay ====

Postfix kan mail relayen naar een extern domein. Hiervoor is de volgende regel:
<pre>relay_domains = $mydestination, hash:/etc/postfix/domains.relay
</pre>

In het bestand /etc/postfix/domains.relay staat de lijst van alle externe domains waar mail naar toe gerelayed wordt. Als je iets in het bestand wijzigt, vergeet dan niet om daarna het commando
<pre>postmap /etc/postfix/domains.relay
</pre>

uit te voeren.

==== Whitelist ====

Postfix kan gebruik maken van een whitelist. Zorg hiervoor dat er het volgende in /etc/postfix/main.cf staat:
<pre>smtpd_client_restrictions = check_client_access hash:/etc/postfix/client.access
</pre>

In het bestand /etc/postfix/client.access staat de lijst van alle domains die geweigerd en toegelaten worden. Als je hier iets in verandert, vergeet dan niet om uit te voeren
<pre>postmap /etc/postfix/access.client
</pre>

== SquirrelMail ==

SquirrelMail is een webmail-client.

=== SquirrelMail installeren ===

Installeer eerst natuurlijk Squirrelmail:
<pre>yum install squirrelmail
</pre>

Zorg ervoor dat httpd standaard aan staat en start httpd:
<pre>chkconfig httpd on
service httpd start
</pre>

Verander nu het volgende in /etc/squirrelmail/config.php:
<pre>$org_name = "A-Eskwadraat";
$org_logo = SM_PATH . 'images/sm_logo.png';
$org_logo_width = '308';
$org_logo_height = '111';
$org_title = 'A-Eskwadraat SquirrelMail $version";
$signout_page = 'vm-mail.a-eskwadraat.nl';

$domain = 'circle.a-eskwadraat.nl';
$imapServerAddress = 'localhost';
$useSendmail = false;
$smtpServerAddress = 'localhost';
$pop_before_smtp = false;

</pre>

Zet nu het A-Eskwadraat logo in de squirrelmail config map.
<pre>setsebool -P httpd_can_network_connect 1
</pre>

== RoundcubeMail ==

Roundcube is ook een webmail client.

=== Installeren ===

Op vm-salt-master staat een configuratie voor een Roundcube mail VM met een korte readme. Deze zorgt ervoor dat httpd, roundcubemail en mariadb geinstalleerd staan. Salt een VM met deze configuratie.
<pre>salt '$hostname' state.highstate
</pre>

Laat vervolgens httpd van die VM door de firewall heen. Daarna moet de database voor Roundcube geinitialiseerd worden. Dit gaat met mysql.
<pre>CREATE DATABASE roundcubemail;
GRANT ALL PRIVILEGES on roundcubemail.* TO roundcube@localhost IDENTIFIED BY '$password';
FLUSH PRIVILEGES;
</pre>

Nu moet de timezone nog even ingesteld worden in /etc/php.ini op de roundcube VM. Daarna moeten er nog de juiste tables in de database worden gezet. Dit kan door op de nieuwe VM de bestanden in /etc/roundcubemail/databasefiles te runnen met mysql.
<pre>mysql roundcubemail < mysql.initial.sql
</pre>
[[Category:Sysop]]

SSL

2020-08-10T13:01:45Z

Arnold:

== Uitleg ==

SSL wordt gebruikt om netwerk verbindingen te beveiligingen, zoals http en imap verkeer. Hiertoe gebruiken we bij a-eskwadraat een reverse proxy die het verkeer versleuteld voor de buitenwereld.

Voor het certificaat van A-Eskwadraat maken we op dit moment gebruik van xolphin: [https://www.sslcertificaten.nl/ https://www.sslcertificaten.nl/]

== Wachtwoord van certificaat halen ==

Indien de private key is beveiligd met een wachtwoord, dan is dit wachtwoord ook nodig bij het opstarten. Dit kan vervelend zijn wanneer de server opnieuw opstart zonder dat iemand ter plaatse is om het wachtwoord in te tikken. Het wachtwoord kan met het volgende commando worden verwijderd. Zorg hierbij dat de shell zich bevindt in de map waarin de private key staat opgeslagen:

[root@server cert]# openssl rsa -in encrypted_private_key.key -out private_key.key

Vervang hierbij encrypted_private_key.key met de naam van de private key, en vervang private_key.key met de gewenste bestandsnaam voor de nieuwe private key zonder wachtwoord.

== Aanmaken CSR ==

=== stap 1 ===

Maak met behulp van SSH verbinding met de server en log in als root. Ga met behulp van het cd-commando naar de map toe waar de certificaten moeten worden bewaard:

[root@server]# cd /etc/ssl/cert/

=== stap 2 ===

Met het volgende commando kunnen de Private Key en de CSR worden gegenereerd:
<pre style="font-family: monospace, Courier; padding: 1em; border-color: rgb(221, 221, 221); color: rgb(0, 0, 0); line-height: 1.1em; font-size: 12.6999998092651px; background-color: rgb(249, 249, 249)">[root@server]# openssl req -nodes -newkey rsa:2048 \
-keyout a-eskwadraat_nl.`date +%Y%m%d`.key \
-out a-eskwadraat_nl.`date +%Y%m%d`.csr \
-subj '/C=NL/ST=Utrecht/L=Utrecht/O=A-Eskwadraat/OU=Sysop/CN=*.a-eskwadraat.nl/emailAddress=sysop@a-eskwadraat.nl'
</pre>

=== stap 3 ===

OpenSSL genereert twee bestanden: de Private Key (met als naam a-eskwadraat_nl.{datum}.key) en de CSR (met als naam a-eskwadraat_nl.{datum}.csr).

=== stap 4 ===

Beveilig de certificaatbestanden zodat niemand behalve de rootgebruiker erbij kan:

[root@server cert]# chmod 600 *.key *.csr

=== stap 6 ===

Nu kan de CSR met behulp van het cat-commando worden weergegeven:

[root@server cert]# cat a-eskwadraat_nl.`date +%Y%m%d`.csr

De velden emailadres, optionele bedrijfsnaam en uitwisselingswachtwoord kunnen leeggelaten worden bij het aanvragen van een SSL certificaat.

== IPA SSL intern ==

Hier staat eigenlijk alles dat je moet weten: [http://www.freeipa.org/page/Apache_SNI_With_Kerberos http://www.freeipa.org/page/Apache_SNI_With_Kerberos] <br/>Het komt hier op neer (merk op dat 'dummyhost' de naam van de virtualhost is):

mkdir /etc/httpd/certs
semanage fcontext -a -t cert_t '/etc/httpd/certs(/.*)?' && restorecon -v /etc/httpd/certs
ipa host-add dummyhost.example.com --desc="Dummy Host" --location="<fqdn-of-webserver>"
ipa host-add-managedby dummyhost.example.com --hosts="<fqdn-of-webserver>"
ipa service-add HTTP/dummyhost.example.com
ipa service-add-host HTTP/dummyhost.example.com --hosts="<fqdn-of-webserver>"
ipa-getcert request -r -f /etc/httpd/certs/dummyhost.crt -k /etc/httpd/certs/dummyhost.key -N CN=dummyhost.example.com -D \
dummyhost.example.com -K HTTP/dummyhost.example.com

Het zou kunnen dat je de package ipa-admintools moet installeren.

== Let's Encrypt ==

=== Stap 1 ===

Inloggen op ernst.

=== Stap 2 ===

Certbot commando uitvoeren:

=== Stap 3 ===

Inloggen op vm-dns-auth.

=== Stap 4 ===

Twee TXT-records aanpassen in /etc/nsd/zones/a-eskwadaraat.nl.zone en timestamps aanpassen (van hele bestand).

=== Stap 5 ===

service nsd restart

Hierna uitloggen op vm-dns-auth.

=== Stap 6 ===

Ga verder met certbot script uit stap 2.

=== Stap 7 ===

service nginx restart

=== Stap 8 ===

Certificaat kopiëren naar mail server.

=== Stap 9 ===

Profit.

[[Category:Sysop]]

Savapage

2018-10-08T20:24:34Z

Arnold:

[[category:sysop]]
SavaPage is OSI Certified Open Source Software, copyright Datraverse B.V. and licensed under the terms of the GNU Affero General Public License (AGPL) version 3, or any later version.

Savapage is het systeem wat het mogelijk maakt om printen vanaf een laptop mogelijk te maken, en bij te houden wie er print.

Savapage draait op vm-cups, en heeft als service de rechten om te printen. Op dit moment (mei 2018) is het nog mogelijk om savapage te omzeilen en direct te printen.

Instellingen van Savapage zijn aan te passen op printer.a-eskwadraat.nl/admin.

De handleiding om te printen via savapage is te vinden op: #TODO

== Installatie ==

Er is een handleiding beschikbaar voor de installatie van Savapage op https://www.savapage.org/docs/manual/ch-install.html

NextCloud

2018-09-18T21:01:44Z

Arnold: /* Installeer nextcloud */

== Installeer nextcloud ==

yum install wget man unzip vim

Centos 7 heeft standaard php-5 we installeren php-7
<pre>
yum install httpd
yum install mariadb-server
systemctl start mariadb
systemctl enable mariadb
mysql_secure_installation
</pre>

<code>yum install centos-release-scl</code>
<code>yum install rh-php70 rh-php70-php rh-php70-php-gd rh-php70-php-mbstring</code>
<code>yum install rh-php70-php-mysqlnd</code>
<code>yum install rh-php70-php-ldap</code>
<code></code>

ln -s /opt/rh/httpd24/root/etc/httpd/conf.d/rh-php70-php.conf /etc/httpd/conf.d/
ln -s /opt/rh/httpd24/root/etc/httpd/conf.modules.d/15-rh-php70-php.conf /etc/httpd/conf.modules.d/
ln -s /opt/rh/httpd24/root/etc/httpd/modules/librh-php70-php7.so /etc/httpd/modules/

systemctl restart httpd

wget https://download.nextcloud.com/server/releases/nextcloud-x.y.z.tar.bz2.asc
wget https://nextcloud.com/nextcloud.asc
gpg --import nextcloud.asc
gpg --verify nextcloud-x.y.z.tar.bz2.asc nextcloud-x.y.z.tar.bz2

yum install bzip2
tar -xjf nextcloud-x.y.z.tar.bz2
cp -r nextcloud /var/www

For the Apache configuration, create the file /etc/httpd/conf.d/nextcloud.conf and add the following lines:

<pre>
Alias /nextcloud "/var/www/html/nextcloud/"

<Directory /var/www/html/nextcloud/>
Options +FollowSymlinks
AllowOverride All

<IfModule mod_dav.c>
Dav off
</IfModule>

SetEnv HOME /var/www/html/nextcloud
SetEnv HTTP_HOME /var/www/html/nextcloud

</Directory>
</pre>

See https://www.marksei.com/install-nextcloud-12-centos-7/ for instructions on creating database
[[Category:Sysop]]

NextCloud

2018-09-18T21:00:38Z

Arnold: /* Installeer nextcloud */

Fail2ban

2018-02-26T19:27:19Z

Arnold:

Fail2ban scant log files en bant adressen die verdachte kenmerken vertonen (bijvoorbeeld: Teveel foute inlog pogingen, zoeken naar exploits , etc). Fail2ban update de firewall regels vervolgens om het verdachte IP adres te weigeren voor een bepaalde tijds periode. Fail2ban vermindert de hoeveelheid incorrecte authenticatie pogingen, maar voorkomt niet het risico van slecht geïmplementeerde authenticatie mechanismes.

Fail2ban draait op vm-sysop en is te vinden onder /etc/fail2ban. Met het command: /etc/init.d/fail2ban status kun je de status van fail2ban checken. De standaard configuratie en regels van fail2ban staan in jail.conf en aanpassingen die wij zelf hebben gemaakt staan in jail.local. De aanpassingen in jail.local overschrijven de standaard regels in jail.conf. Als je een aanpassing maakt moet je dit dus in jail.local doen. Een voorbeeld van een regel in jail.local is:

<pre>
[ssh-aes] // Naam van de service
enabled = true // Deze service wordt gemonitoord door fail2ban
filter = sshd // De filter die de logs scant op een patroon (in de map filter.d)
action = a-eskwadraat // De actie die wordt uitgevoerd als de filter true returnt (in de map action.d)
logpath = /var/log/secure // De log file die gescant wordt door de filter
maxretry = 5 // Het aantal keer dat de filter het patroon mag tegen komen voordat de ban actie wordt uitgevoerd
</pre>

In de map filter.d staan de filters voor services. Deze werken met behulp van reguliere expressies. Wanneer er in een log file een bepaald patroon voorkomt dat de reguliere expressie matcht wordt dit gezien als een foute log-in poging.

In de map action.d staan acties die uitgevoerd worden op gedefineerde momenten. Actions zijn bijvoorbeeld het bannen en unbannen van een ip adres. Voorbeelden van een ban en unban action van de hierboven genoemde jail zijn:

<pre>
actionban = /usr/bin/ssh -i /root/.ssh/id_rsa_fail2ban_ban root@10.14.0.42 <ip>
actionunban = /usr/bin/ssh -i /root/.ssh/id_rsa_fail2ban_unban root@10.14.0.42 <ip>
</pre>

Hierbij is het belangrijk dat de ssh key die gebruikt wordt bepaald welke actie wordt uitgevoerd. Op ernst (de router) staan namelijk voor deze ssh keys in /root/.ssh/authorizedkeys specifieke commando's gedefinieerd.
Wat deze regels doen is met behulp van ipset ip's aan de groep "blacklist" toevoegen. Om ip adressen uit zo'n ipset groep te blacklisten moet er op ernst aan /etc/shorewall/blrules een regel worden toegevoegd:

<pre>
#ACTION SOURCE DEST
DROP ext:+blacklist all
</pre>

------------------------- STILL IN PROGRESS -------------------------
[[Category:Sysop]]

Fail2ban

2018-02-20T22:28:53Z

Arnold:

Domjudge

2017-10-09T23:19:05Z

Arnold: /* Judgeserver & Judgehost instaleren */

Domjudge wordt gebruikt voor programmeerwedstrijden, dus het UKP en BAPC. De ESCapade organiseert de wedstrijden, de sysop zorgt ervoor dat domjudge correct draait. Domdjudge heeft een webinterface waar de score van de teams wordt bijgehouden. Ook worden de oplossingen van problemen via de webinterface aan domjudjge doorgegeven. Bij A-Eskwadraat gebruiken we URL http://judge.a-eskwadraat.nl/ voor domjudge. We draaien een judgeserver en judgehost. Deze draaien op [[haskell]], namelijk de VM's ''Judgehost'' en ''Judgeserver''.

== Judgeserver ==
De judgeserver verzorgt de front-end, oftewel de webinterface. Deze moet draaien, zodat iedereen bij de webpagina kan en daar dingen kan doen. Inzendingen kunnen ingestuurd worden, maar er moet ook een judgehost draaien om deze na te kunnen kijken.

Op de judgeserver moeten de mysql en apache services draaien.

== Judgehost ==
Op de judgehost worden inzendingen gestuurd vanaf de judgeserver. De judgehost kijkt deze dan na. Op de judgehost moet dan wel ''judgedeamon'' actief draaien.

==Judgeserver & Judgehost instaleren==

De makkelijkste manier om een judgeserver & judgehost te maken is door de live image van domjudge te converteren naar qcow2, en vervolgens aan de hypervisor te hangen.
Het converteren van de image kun je het beste op een zoo doen, omdat de benodigde tools niet op Haskell staan (zorg er wel voor dat deze zoo genoeg storage space heeft voor de images). Download daarom de image op een zoo waarop de "libguestfs-tools" geïnstalleerd staan of installeer het "libguestfs-tools" package. Voor je de image kunt converteren moet je dan ook nog het "libvirt" package downloaden en in qemu config (/etc/libvirt/qemu.conf) de regels voor "user = "root"" en "group = "root"" uncommenten. Vervolgens start je de "libvirtd" service en kun je verdergaan met onderstaande stappen:

Download de image van:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">[https://www.domjudge.org/live/ https://www.domjudge.org/live/]<br/></div>
Pak deze uit.
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">bzip2 -d {domjudgeimage.bz2}<br/></div>
We willen eerst het image vergroten. We maken een nieuwe img file aan van 8GB
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">truncate -s 8G {resized.img}<br/></div>
En dan resizen we het orginele file naar een groter file format
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">virt-resize --expand /dev/sda2 {original.img} {resized.img}<br/></div>
Converteer deze vervolgens naar qcow2 formaat:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img convert {input file} -c -O qcow2 {output file}</div>
Voor gemak maak je er dan een snapshot layer omheen, zodat je makkelijk kunt reverten naar de originele image:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img create -o backing_file={output file} -f qcow2 judgeserver.qcow2<br/></div>

We vervangen nu de qcow image van de oude domdjudge server (of host) door deze nieuwe qcow op haskell. (bij /var/lib/vz/images/{virtual host nummer}). Het virtual host nummer is te zien in de webinterface van haskell. Vervolgens moet de config file van de VM op haskell (/etc/pve/qemu-server/{vm-id}.conf}) nog aangepast worden om naar de juiste image te wijzen. Pas hiervoor de volgende regel zo aan:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">scsi0: storage-vm-vz:{vm-id}/{naam van image},cache=writethrough,size={size}<br/></div>

Doe hierna een rescan, om de nieuwe image te vinden.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qm rescan -vmid {vm-id}<br/></div>

Om de live image te updaten dient de configuratie voor apt aangepast te worden. Hierbij moet de ingestelde proxy uitgezet worden in:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">/etc/apt/apt.conf</div>[[Category:Escapade]]

De stappen zijn voor de judgeserver en judgehost hetzelfde. Om de judgehost de judgeserver te kunnen laten vinden moet je er nog voor zorgen dat de restapi file (/etc/domjdudge/restapi.secret) overeenkomt met die op de judgeserver en dat in deze file niet naar de localhost maar naar judge.a-eskwadraat.nl verwezen wordt.

Meer info is [https://github.com/DOMjudge/domjudge-packaging/blob/master/live-image/files/README#L64 hier] te vinden.

Het is verder belangrijk dat de judgeserver en judgehost alleen als domserver respectievelijk judgehost booten, dit kun je instellen door in de grub config file (/etc/default/grub) de volgende lijn aan te passen:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">GRUB_DEFAULT={nummer}<br/></div>

Hierbij correspondeert het nummer met de boot-entry in het grub boot menu, beginnend bij 0 (deze kun je bereiken door op proxmox vlak na het opstarten van de VM een console naar de VM te openen). Verander dit nummer naar het entry nummer van of de domserver of de judgehost. En update grub daarna met deze nieuwe configuratie.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">update-grub<br/></div>

==Stappen bij een programeerwedstrijd==

*Zorg voor een nieuwe domjudge installatie of gebruik een oude
**Als je een oude gebruikt, ruim de oude judgings op, op de judgehost. Ga naar de judgehost en gebruik het "$du / -aS | sort -nr | head -25" commando om te zien waar de grote files zich bevinden. het "$df" commando laat zien hoeveel ruimte je nog hebt
** In /var/lib/domjudge/judgings bevinden zich de judgings. Deze kunnen verwijderd worden om ruimte vrij te maken op de judgehost
*Zorg dat de judgehost en de judgeserver allebei aanstaan. (login is standaard)
*De site werkt nu op judge.a-eskwadraat.nl
*De ESCapade moet nu de teams en opdrachten in de website instellen
*Op de wedstrijddag zelf, blijf beschikbaar voor het geval er dingen mis gaan. (Met voorkeur bij A-Eskwadraat zelf, zodat je direct bij de server kan)

==Installeer een verse domjudge==
Nog te doen

==Links==
[https://www.domjudge.org/]

[[Category:Sysop]]

Domjudge

2017-10-09T23:17:31Z

Arnold: /* Judgeserver & Judgehost instaleren */

Domjudge wordt gebruikt voor programmeerwedstrijden, dus het UKP en BAPC. De ESCapade organiseert de wedstrijden, de sysop zorgt ervoor dat domjudge correct draait. Domdjudge heeft een webinterface waar de score van de teams wordt bijgehouden. Ook worden de oplossingen van problemen via de webinterface aan domjudjge doorgegeven. Bij A-Eskwadraat gebruiken we URL http://judge.a-eskwadraat.nl/ voor domjudge. We draaien een judgeserver en judgehost. Deze draaien op [[haskell]], namelijk de VM's ''Judgehost'' en ''Judgeserver''.

== Judgeserver ==
De judgeserver verzorgt de front-end, oftewel de webinterface. Deze moet draaien, zodat iedereen bij de webpagina kan en daar dingen kan doen. Inzendingen kunnen ingestuurd worden, maar er moet ook een judgehost draaien om deze na te kunnen kijken.

Op de judgeserver moeten de mysql en apache services draaien.

== Judgehost ==
Op de judgehost worden inzendingen gestuurd vanaf de judgeserver. De judgehost kijkt deze dan na. Op de judgehost moet dan wel ''judgedeamon'' actief draaien.

==Judgeserver & Judgehost instaleren==

De makkelijkste manier om een judgeserver & judgehost te maken is door de live image van domjudge te converteren naar qcow2, en vervolgens aan de hypervisor te hangen.
Het converteren van de image kun je het beste op een zoo doen, omdat de benodigde tools niet op Haskell staan (zorg er wel voor dat deze zoo genoeg storage space heeft voor de images). Download daarom de image op een zoo waarop de "libguestfs-tools" geïnstalleerd staan of installeer het "libguestfs-tools" package. Voor je de image kunt inverteren moet je dan ook nog het "libvirt" package downloaden en in qemu config (/etc/libvirt/qemu.conf) de regels voor "user = "root"" en "group = "root"" uncommenten. Vervolgens start je de "libvirtd" service en kun je verdergaan met onderstaande stappen:

Download de image van:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">[https://www.domjudge.org/live/ https://www.domjudge.org/live/]<br/></div>
Pak deze uit.
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">bzip2 -d {domjudgeimage.bz2}<br/></div>
We willen eerst het image vergroten. We maken een nieuwe img file aan van 8GB
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">truncate -s 8G {resized.img}<br/></div>
En dan resizen we het orginele file naar een groter file format
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">virt-resize --expand /dev/sda2 {original.img} {resized.img}<br/></div>
Converteer deze vervolgens naar qcow2 formaat:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img convert {input file} -c -O qcow2 {output file}</div>
Voor gemak maak je er dan een snapshot layer omheen, zodat je makkelijk kunt reverten naar de originele image:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img create -o backing_file={output file} -f qcow2 judgeserver.qcow2<br/></div>

We vervangen nu de qcow image van de oude domdjudge server (of host) door deze nieuwe qcow op haskell. (bij /var/lib/vz/images/{virtual host nummer}). Het virtual host nummer is te zien in de webinterface van haskell. Vervolgens moet de config file van de VM op haskell (/etc/pve/qemu-server/{vm-id}.conf}) nog aangepast worden om naar de juiste image te wijzen. Pas hiervoor de volgende regel zo aan:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">scsi0: storage-vm-vz:{vm-id}/{naam van image},cache=writethrough,size={size}<br/></div>

Doe hierna een rescan, om de nieuwe image te vinden.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qm rescan -vmid {vm-id}<br/></div>

Om de live image te updaten dient de configuratie voor apt aangepast te worden. Hierbij moet de ingestelde proxy uitgezet worden in:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">/etc/apt/apt.conf</div>[[Category:Escapade]]

De stappen zijn voor de judgeserver en judgehost hetzelfde. Om de judgehost de judgeserver te kunnen laten vinden moet je er nog voor zorgen dat de restapi file (/etc/domjdudge/restapi.secret) overeenkomt met die op de judgeserver en dat in deze file niet naar de localhost maar naar judge.a-eskwadraat.nl verwezen wordt.

Meer info is [https://github.com/DOMjudge/domjudge-packaging/blob/master/live-image/files/README#L64 hier] te vinden.

Het is verder belangrijk dat de judgeserver en judgehost alleen als domserver respectievelijk judgehost booten, dit kun je instellen door in de grub config file (/etc/default/grub) de volgende lijn aan te passen:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">GRUB_DEFAULT={nummer}<br/></div>

Hierbij correspondeert het nummer met de boot-entry in het grub boot menu, beginnend bij 0 (deze kun je bereiken door op proxmox vlak na het opstarten van de VM een console naar de VM te openen). Verander dit nummer naar het entry nummer van of de domserver of de judgehost. En update grub daarna met deze nieuwe configuratie.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">update-grub<br/></div>

==Stappen bij een programeerwedstrijd==

*Zorg voor een nieuwe domjudge installatie of gebruik een oude
**Als je een oude gebruikt, ruim de oude judgings op, op de judgehost. Ga naar de judgehost en gebruik het "$du / -aS | sort -nr | head -25" commando om te zien waar de grote files zich bevinden. het "$df" commando laat zien hoeveel ruimte je nog hebt
** In /var/lib/domjudge/judgings bevinden zich de judgings. Deze kunnen verwijderd worden om ruimte vrij te maken op de judgehost
*Zorg dat de judgehost en de judgeserver allebei aanstaan. (login is standaard)
*De site werkt nu op judge.a-eskwadraat.nl
*De ESCapade moet nu de teams en opdrachten in de website instellen
*Op de wedstrijddag zelf, blijf beschikbaar voor het geval er dingen mis gaan. (Met voorkeur bij A-Eskwadraat zelf, zodat je direct bij de server kan)

==Installeer een verse domjudge==
Nog te doen

==Links==
[https://www.domjudge.org/]

[[Category:Sysop]]

Domjudge

2017-10-09T23:14:57Z

Arnold: /* Judgeserver & Judgehost instaleren */

Domjudge wordt gebruikt voor programmeerwedstrijden, dus het UKP en BAPC. De ESCapade organiseert de wedstrijden, de sysop zorgt ervoor dat domjudge correct draait. Domdjudge heeft een webinterface waar de score van de teams wordt bijgehouden. Ook worden de oplossingen van problemen via de webinterface aan domjudjge doorgegeven. Bij A-Eskwadraat gebruiken we URL http://judge.a-eskwadraat.nl/ voor domjudge. We draaien een judgeserver en judgehost. Deze draaien op [[haskell]], namelijk de VM's ''Judgehost'' en ''Judgeserver''.

== Judgeserver ==
De judgeserver verzorgt de front-end, oftewel de webinterface. Deze moet draaien, zodat iedereen bij de webpagina kan en daar dingen kan doen. Inzendingen kunnen ingestuurd worden, maar er moet ook een judgehost draaien om deze na te kunnen kijken.

Op de judgeserver moeten de mysql en apache services draaien.

== Judgehost ==
Op de judgehost worden inzendingen gestuurd vanaf de judgeserver. De judgehost kijkt deze dan na. Op de judgehost moet dan wel ''judgedeamon'' actief draaien.

==Judgeserver & Judgehost instaleren==

De makkelijkste manier om een judgeserver & judgehost te maken is door de live image van domjudge te converteren naar qcow2, en vervolgens aan de hypervisor te hangen.
Het converteren van de image kun je het beste op een zoo doen, omdat de benodigde tools niet op Haskell staan (zorg er wel voor dat deze zoo genoeg storage space heeft voor de images). Download daarom de image op een zoo waarop de "libguestfs-tools" geïnstalleerd staan of installeer het "libguestfs-tools" package. Voor je de image kunt inverteren moet je dan ook nog het "libvirt" package downloaden en in qemu config (/etc/libvirt/qemu.conf) de regels voor "user = "root"" en "group = "root"" uncommenten. Vervolgens start je de "libvirtd" service en kun je verdergaan met onderstaande stappen:

Download de image van:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">[https://www.domjudge.org/live/ https://www.domjudge.org/live/]<br/></div>
Pak deze uit.
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">bzip2 -d {domjudgeimage.bz2}<br/></div>
We willen eerst het image vergroten. We maken een nieuwe img file aan van 8GB
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">truncate -s 8G {resized.img}<br/></div>
En dan resizen we het orginele file naar een groter file format
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">virt-resize --expand /dev/sda2 {original.img} {resized.img}<br/></div>
Converteer deze vervolgens naar qcow2 formaat:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img convert {input file} -c -O qcow2 {output file}</div>
Voor gemak maak je er dan een snapshot layer omheen, zodat je makkelijk kunt reverten naar de originele image:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img create -o backing_file={output file} -f qcow2 judgeserver.qcow2<br/></div>

We vervangen nu de qcow image van de oude domdjudge server (of host) door deze nieuwe qcow op haskell. (bij /var/lib/vz/images/{virtual host nummer}). Het virtual host nummer is te zien in de webinterface van haskell. Vervolgens moet de config file van de VM op haskell (/etc/pve/qemu-server/{vm-id}.conf}) nog aangepast worden om naar de juiste image te wijzen. Pas hiervoor de volgende regel zo aan:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">scsi0: storage-vm-vz:{vm-id}/{naam van image},cache=writethrough,size={size}<br/></div>

Doe hierna een rescan, om de nieuwe image te vinden.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qm rescan -vmid {vm-id}<br/></div>

Om de live image te updaten dient de configuratie voor apt aangepast te worden. Hierbij moet de ingestelde proxy uitgezet worden in:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">/etc/apt/apt.conf</div>[[Category:Escapade]]

De stappen zijn voor de judgeserver en judgehost hetzelfde. Om de judgehost de judgeserver te kunnen laten vinden moet je er nog voor zorgen dat de restapi file (/etc/domjdudge/restapi.secret) overeenkomt met die op de judgeserver en dat in deze file niet naar de localhost maar naar judge.a-eskwadraat.nl verwezen wordt.

Meer info is [https://github.com/DOMjudge/domjudge-packaging/blob/master/live-image/files/README#L64 hier] te vinden.

Het is verder belangrijk dat de judgeserver en judgehost alleen als domserver respectievelijk judgehost booten, dit kun je instellen door in de grub config file (/etc/default/grub) de volgende lijn aan te passen:

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">GRUB_DEFAULT={nummer}<br/></div>

Hierbij correspondeert het nummer met de boot-entry in het grub boot menu, beginnend bij 0 (deze kun je bereiken door op proxmox vlak na het opstarten van de VM een console naar de VM te openen). Verander dit nummer naar het entry nummer van of de domserver of de judgehost.

==Stappen bij een programeerwedstrijd==

*Zorg voor een nieuwe domjudge installatie of gebruik een oude
**Als je een oude gebruikt, ruim de oude judgings op, op de judgehost. Ga naar de judgehost en gebruik het "$du / -aS | sort -nr | head -25" commando om te zien waar de grote files zich bevinden. het "$df" commando laat zien hoeveel ruimte je nog hebt
** In /var/lib/domjudge/judgings bevinden zich de judgings. Deze kunnen verwijderd worden om ruimte vrij te maken op de judgehost
*Zorg dat de judgehost en de judgeserver allebei aanstaan. (login is standaard)
*De site werkt nu op judge.a-eskwadraat.nl
*De ESCapade moet nu de teams en opdrachten in de website instellen
*Op de wedstrijddag zelf, blijf beschikbaar voor het geval er dingen mis gaan. (Met voorkeur bij A-Eskwadraat zelf, zodat je direct bij de server kan)

==Installeer een verse domjudge==
Nog te doen

==Links==
[https://www.domjudge.org/]

[[Category:Sysop]]

Domjudge

2017-10-09T23:02:13Z

Arnold: /* Judgeserver & Judgehost instaleren */

Domjudge wordt gebruikt voor programmeerwedstrijden, dus het UKP en BAPC. De ESCapade organiseert de wedstrijden, de sysop zorgt ervoor dat domjudge correct draait. Domdjudge heeft een webinterface waar de score van de teams wordt bijgehouden. Ook worden de oplossingen van problemen via de webinterface aan domjudjge doorgegeven. Bij A-Eskwadraat gebruiken we URL http://judge.a-eskwadraat.nl/ voor domjudge. We draaien een judgeserver en judgehost. Deze draaien op [[haskell]], namelijk de VM's ''Judgehost'' en ''Judgeserver''.

== Judgeserver ==
De judgeserver verzorgt de front-end, oftewel de webinterface. Deze moet draaien, zodat iedereen bij de webpagina kan en daar dingen kan doen. Inzendingen kunnen ingestuurd worden, maar er moet ook een judgehost draaien om deze na te kunnen kijken.

Op de judgeserver moeten de mysql en apache services draaien.

== Judgehost ==
Op de judgehost worden inzendingen gestuurd vanaf de judgeserver. De judgehost kijkt deze dan na. Op de judgehost moet dan wel ''judgedeamon'' actief draaien.

==Judgeserver & Judgehost instaleren==

De makkelijkste manier om een judgeserver & judgehost te maken is door de live image van domjudge te converteren naar qcow2, en vervolgens aan de hypervisor te hangen.
Het converteren van de image kun je het beste op een zoo doen, omdat de benodigde tools niet op Haskell staan (zorg er wel voor dat deze zoo genoeg storage space heeft voor de images). Download daarom de image op een zoo waarop de "libguestfs-tools" geïnstalleerd staan of installeer het "libguestfs-tools" package. Voor je de image kunt inverteren moet je dan ook nog het "libvirt" package downloaden en in qemu config (/etc/libvirt/qemu.conf) de regels voor "user = "root"" en "group = "root"" uncommenten. Vervolgens start je de "libvirtd" service en kun je verdergaan met onderstaande stappen:

Download de image van:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">[https://www.domjudge.org/live/ https://www.domjudge.org/live/]<br/></div>
Pak deze uit.
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">bzip2 -d {domjudgeimage.bz2}<br/></div>
We willen eerst het image vergroten. We maken een nieuwe img file aan van 8GB
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">truncate -s 8G {resized.img}<br/></div>
En dan resizen we het orginele file naar een groter file format
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">virt-resize --expand /dev/sda2 {original.img} {resized.img}<br/></div>
Converteer deze vervolgens naar qcow2 formaat:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img convert {input file} -c -O qcow2 {output file}</div>
Voor gemak maak je er dan een snapshot layer omheen, zodat je makkelijk kunt reverten naar de originele image:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img create -o backing_file={output file} -f qcow2 judgeserver.qcow2<br/></div>

We vervangen nu de qcow image van de oude domdjudge server (of host) door deze nieuwe qcow op haskell. (bij /var/lib/vz/images/{virtual host nummer}). Het virtual host nummer is te zien in de webinterface van haskell. Vervolgens moet de config file van de VM op haskell (/etc/pve/qemu-server/{vm-id}.conf}) nog aangepast worden om naar de juiste image te wijzen.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">scsi0: storage-vm-vz:{vm-id}/{naam van image},cache=writethrough,size={size}<br/></div>

Doe hierna een rescan, om de nieuwe image te vinden.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qm rescan -vmid {vm-id}<br/></div>

Om de live image te updaten dient de configuratie voor apt aangepast te worden. Hierbij moet de ingestelde proxy uitgezet worden in:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">/etc/apt/apt.conf</div>[[Category:Escapade]]

Meer info is [https://github.com/DOMjudge/domjudge-packaging/blob/master/live-image/files/README#L64 hier] te vinden.

==Stappen bij een programeerwedstrijd==

*Zorg voor een nieuwe domjudge installatie of gebruik een oude
**Als je een oude gebruikt, ruim de oude judgings op, op de judgehost. Ga naar de judgehost en gebruik het "$du / -aS | sort -nr | head -25" commando om te zien waar de grote files zich bevinden. het "$df" commando laat zien hoeveel ruimte je nog hebt
** In /var/lib/domjudge/judgings bevinden zich de judgings. Deze kunnen verwijderd worden om ruimte vrij te maken op de judgehost
*Zorg dat de judgehost en de judgeserver allebei aanstaan. (login is standaard)
*De site werkt nu op judge.a-eskwadraat.nl
*De ESCapade moet nu de teams en opdrachten in de website instellen
*Op de wedstrijddag zelf, blijf beschikbaar voor het geval er dingen mis gaan. (Met voorkeur bij A-Eskwadraat zelf, zodat je direct bij de server kan)

==Installeer een verse domjudge==
Nog te doen

==Links==
[https://www.domjudge.org/]

[[Category:Sysop]]

Domjudge

2017-10-09T23:00:39Z

Arnold: /* Judgeserver & Judgehost instaleren */

Domjudge wordt gebruikt voor programmeerwedstrijden, dus het UKP en BAPC. De ESCapade organiseert de wedstrijden, de sysop zorgt ervoor dat domjudge correct draait. Domdjudge heeft een webinterface waar de score van de teams wordt bijgehouden. Ook worden de oplossingen van problemen via de webinterface aan domjudjge doorgegeven. Bij A-Eskwadraat gebruiken we URL http://judge.a-eskwadraat.nl/ voor domjudge. We draaien een judgeserver en judgehost. Deze draaien op [[haskell]], namelijk de VM's ''Judgehost'' en ''Judgeserver''.

== Judgeserver ==
De judgeserver verzorgt de front-end, oftewel de webinterface. Deze moet draaien, zodat iedereen bij de webpagina kan en daar dingen kan doen. Inzendingen kunnen ingestuurd worden, maar er moet ook een judgehost draaien om deze na te kunnen kijken.

Op de judgeserver moeten de mysql en apache services draaien.

== Judgehost ==
Op de judgehost worden inzendingen gestuurd vanaf de judgeserver. De judgehost kijkt deze dan na. Op de judgehost moet dan wel ''judgedeamon'' actief draaien.

==Judgeserver & Judgehost instaleren==

De makkelijkste manier om een judgeserver & judgehost te maken is door de live image van domjudge te converteren naar qcow2, en vervolgens aan de hypervisor te hangen.
Het converteren van de image kun je het beste op een zoo doen, omdat de benodigde tools niet op Haskell staan (zorg er wel voor dat deze zoo genoeg storage space heeft voor de images). Download daarom de image op een zoo waarop de "libguestfs-tools" geïnstalleerd staan of installeer het "libguestfs-tools" package. Voor je de image kunt inverteren moet je dan ook nog het "libvirt" package downloaden en in qemu config (/etc/libvirt/qemu.conf) de regels voor "user = "root"" en "group = "root"" uncommenten. Vervolgens start je de "libvirtd" service en kun je verdergaan met onderstaande stappen:

Download de image van:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">[https://www.domjudge.org/live/ https://www.domjudge.org/live/]<br/></div>
Pak deze uit.
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">bzip2 -d {domjudgeimage.bz2}<br/></div>
We willen eerst het image vergroten. We maken een nieuwe img file aan van 8GB
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">truncate -s 8G {resized.img}<br/></div>
En dan resizen we het orginele file naar een groter file format
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">virt-resize --expand /dev/sda2 {original.img} {resized.img}<br/></div>
Converteer deze vervolgens naar qcow2 formaat:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img convert {input file} -c -O qcow2 {output file}</div>
Voor gemak maak je er dan een snapshot layer omheen, zodat je makkelijk kunt reverten naar de originele image:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img create -o backing_file={output file} -f qcow2 judgeserver.qcow2<br/></div>

We vervangen nu de qcow image van de oude domdjudge server (of host) door deze nieuwe qcow op haskell. (bij /var/lib/vz/images/{virtual host nummer}). Het virtual host nummer is te zien in de webinterface van haskell. Vervolgens moet de config file van de VM op haskell (/etc/pve/qemu-server/{vm-id}.conf}) nog aangepast worden om naar de juiste image te wijzen (pas deze regel aan: scsi0: storage-vm-vz:{vm-id}/{naam van image},cache=writethrough,size={size}).

Doe hierna een rescan, om de nieuwe image te vinden.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qm rescan -vmid {vm-id}<br/></div>

Om de live image te updaten dient de configuratie voor apt aangepast te worden. Hierbij moet de ingestelde proxy uitgezet worden in:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">/etc/apt/apt.conf</div>[[Category:Escapade]]

Meer info is [https://github.com/DOMjudge/domjudge-packaging/blob/master/live-image/files/README#L64 hier] te vinden.

==Stappen bij een programeerwedstrijd==

*Zorg voor een nieuwe domjudge installatie of gebruik een oude
**Als je een oude gebruikt, ruim de oude judgings op, op de judgehost. Ga naar de judgehost en gebruik het "$du / -aS | sort -nr | head -25" commando om te zien waar de grote files zich bevinden. het "$df" commando laat zien hoeveel ruimte je nog hebt
** In /var/lib/domjudge/judgings bevinden zich de judgings. Deze kunnen verwijderd worden om ruimte vrij te maken op de judgehost
*Zorg dat de judgehost en de judgeserver allebei aanstaan. (login is standaard)
*De site werkt nu op judge.a-eskwadraat.nl
*De ESCapade moet nu de teams en opdrachten in de website instellen
*Op de wedstrijddag zelf, blijf beschikbaar voor het geval er dingen mis gaan. (Met voorkeur bij A-Eskwadraat zelf, zodat je direct bij de server kan)

==Installeer een verse domjudge==
Nog te doen

==Links==
[https://www.domjudge.org/]

[[Category:Sysop]]

Domjudge

2017-10-09T22:54:23Z

Arnold: /* Stappen bij een programeerwedstrijd */

Domjudge wordt gebruikt voor programmeerwedstrijden, dus het UKP en BAPC. De ESCapade organiseert de wedstrijden, de sysop zorgt ervoor dat domjudge correct draait. Domdjudge heeft een webinterface waar de score van de teams wordt bijgehouden. Ook worden de oplossingen van problemen via de webinterface aan domjudjge doorgegeven. Bij A-Eskwadraat gebruiken we URL http://judge.a-eskwadraat.nl/ voor domjudge. We draaien een judgeserver en judgehost. Deze draaien op [[haskell]], namelijk de VM's ''Judgehost'' en ''Judgeserver''.

== Judgeserver ==
De judgeserver verzorgt de front-end, oftewel de webinterface. Deze moet draaien, zodat iedereen bij de webpagina kan en daar dingen kan doen. Inzendingen kunnen ingestuurd worden, maar er moet ook een judgehost draaien om deze na te kunnen kijken.

Op de judgeserver moeten de mysql en apache services draaien.

== Judgehost ==
Op de judgehost worden inzendingen gestuurd vanaf de judgeserver. De judgehost kijkt deze dan na. Op de judgehost moet dan wel ''judgedeamon'' actief draaien.

==Judgeserver & Judgehost instaleren==

De makkelijkste manier om een judgeserver & judgehost te maken is door de live image van domjudge te converteren naar qcow2, en vervolgens aan de hypervisor te hangen.
Het converteren van de image kun je het beste op een zoo doen, omdat de benodigde tools niet op Haskell staan. Download daarom de image op een zoo waarop de "libguestfs-tools" geïnstalleerd staan of installeer het "libguestfs-tools" package. Voor je de image kunt inverteren moet je dan ook nog het "libvirt" package downloaden en in qemu config (/etc/libvirt/qemu.conf) de regels voor "user = "root"" en "group = "root"" uncommenten. Vervolgens start je de "libvirtd" service en kun je verdergaan met onderstaande stappen:

Download de image van:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">[https://www.domjudge.org/live/ https://www.domjudge.org/live/]<br/></div>
Pak deze uit.
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">bzip2 -d {domjudgeimage.bz2}<br/></div>
We willen eerst het image vergroten. We maken een nieuwe img file aan van 8GB
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">truncate -s 8G {resized.img}<br/></div>
En dan resizen we het orginele file naar een groter file format
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">virt-resize --expand /dev/sda2 {original.img} {resized.img}<br/></div>
Converteer deze vervolgens naar qcow2 formaat:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img convert {input file} -c -O qcow2 {output file}</div>
Voor gemak maak je er dan een snapshot layer omheen, zodat je makkelijk kunt reverten naar de originele image:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img create -o backing_file={output file} -f qcow2 judgeserver.qcow2<br/></div>

We vervangen nu de qcow image van de oude domdjudge server (of host) door deze nieuwe qcow op haskell. (bij /var/lib/vz/images/{virtual host nummer}). Het virtual host nummer is te zien in de webinterface van haskell.

Doe hierna een rescan, om de nieuwe image te vinden.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qm rescan -vmid {vm-id}<br/></div>

Om de live image te updaten dient de configuratie voor apt aangepast te worden. Hierbij moet de ingestelde proxy uitgezet worden in:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">/etc/apt/apt.conf</div>[[Category:Escapade]]

Meer info is [https://github.com/DOMjudge/domjudge-packaging/blob/master/live-image/files/README#L64 hier] te vinden.

==Stappen bij een programeerwedstrijd==

*Zorg voor een nieuwe domjudge installatie of gebruik een oude
**Als je een oude gebruikt, ruim de oude judgings op, op de judgehost. Ga naar de judgehost en gebruik het "$du / -aS | sort -nr | head -25" commando om te zien waar de grote files zich bevinden. het "$df" commando laat zien hoeveel ruimte je nog hebt
** In /var/lib/domjudge/judgings bevinden zich de judgings. Deze kunnen verwijderd worden om ruimte vrij te maken op de judgehost
*Zorg dat de judgehost en de judgeserver allebei aanstaan. (login is standaard)
*De site werkt nu op judge.a-eskwadraat.nl
*De ESCapade moet nu de teams en opdrachten in de website instellen
*Op de wedstrijddag zelf, blijf beschikbaar voor het geval er dingen mis gaan. (Met voorkeur bij A-Eskwadraat zelf, zodat je direct bij de server kan)

==Installeer een verse domjudge==
Nog te doen

==Links==
[https://www.domjudge.org/]

[[Category:Sysop]]

Domjudge

2017-09-25T19:44:09Z

Arnold: /* Judgeserver & Judgehost instaleren */

Domjudge wordt gebruikt voor programmeerwedstrijden, dus het UKP en BAPC. De ESCapade organiseert de wedstrijden, de sysop zorgt ervoor dat domjudge correct draait. Domdjudge heeft een webinterface waar de score van de teams wordt bijgehouden. Ook worden de oplossingen van problemen via de webinterface aan domjudjge doorgegeven. Bij A-Eskwadraat gebruiken we URL http://judge.a-eskwadraat.nl/ voor domjudge. We draaien een judgeserver en judgehost. Deze draaien op [[haskell]], namelijk de VM's ''Judgehost'' en ''Judgeserver''.

== Judgeserver ==
De judgeserver verzorgt de front-end, oftewel de webinterface. Deze moet draaien, zodat iedereen bij de webpagina kan en daar dingen kan doen. Inzendingen kunnen ingestuurd worden, maar er moet ook een judgehost draaien om deze na te kunnen kijken.

Op de judgeserver moeten de mysql en apache services draaien.

== Judgehost ==
Op de judgehost worden inzendingen gestuurd vanaf de judgeserver. De judgehost kijkt deze dan na. Op de judgehost moet dan wel ''judgedeamon'' actief draaien.

==Judgeserver & Judgehost instaleren==

De makkelijkste manier om een judgeserver & judgehost te maken is door de live image van domjudge te converteren naar qcow2, en vervolgens aan de hypervisor te hangen.
Het converteren van de image kun je het beste op een zoo doen, omdat de benodigde tools niet op Haskell staan. Download daarom de image op een zoo waarop de "libguestfs-tools" geïnstalleerd staan of installeer het "libguestfs-tools" package. Voor je de image kunt inverteren moet je dan ook nog het "libvirt" package downloaden en in qemu config (/etc/libvirt/qemu.conf) de regels voor "user = "root"" en "group = "root"" uncommenten. Vervolgens start je de "libvirtd" service en kun je verdergaan met onderstaande stappen:

Download de image van:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">[https://www.domjudge.org/live/ https://www.domjudge.org/live/]<br/></div>
Pak deze uit.
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">bzip2 -d {domjudgeimage.bz2}<br/></div>
We willen eerst het image vergroten. We maken een nieuwe img file aan van 8GB
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">truncate -s 8G {resized.img}<br/></div>
En dan resizen we het orginele file naar een groter file format
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">virt-resize --expand /dev/sda2 {original.img} {resized.img}<br/></div>
Converteer deze vervolgens naar qcow2 formaat:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img convert {input file} -c -O qcow2 {output file}</div>
Voor gemak maak je er dan een snapshot layer omheen, zodat je makkelijk kunt reverten naar de originele image:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qemu-img create -o backing_file={output file} -f qcow2 judgeserver.qcow2<br/></div>

We vervangen nu de qcow image van de oude domdjudge server (of host) door deze nieuwe qcow op haskell. (bij /var/lib/vz/images/{virtual host nummer}). Het virtual host nummer is te zien in de webinterface van haskell.

Doe hierna een rescan, om de nieuwe image te vinden.

<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">qm rescan -vmid {vm-id}<br/></div>

Om de live image te updaten dient de configuratie voor apt aangepast te worden. Hierbij moet de ingestelde proxy uitgezet worden in:
<div style="background:#eee;border:1px solid #ccc;padding:5px 10px;">/etc/apt/apt.conf</div>[[Category:Escapade]]

Meer info is [https://github.com/DOMjudge/domjudge-packaging/blob/master/live-image/files/README#L64 hier] te vinden.

==Stappen bij een programeerwedstrijd==

*Zorg voor een nieuwe domjudge installatie of gebruik een oude
**Als je een oude gebruikt, ruim de oude judgings op, op de judgehost. Ga naar de judgehost en gebruik het "$du / -aS | sort -nr | head -25" commando om te zien waar de grote files zich bevinden. het "$df" commando laat zien hoeveel ruimte je nog hebt
** In /var/lib/domjudge/judgings bevinden zich de judgings. Deze kunnen verwijderd worden om ruimte vrij te maken op de judgehost
*Zorg dat de judgehost en de judgeserver allebei aanstaan. (login is standaard)
*Op de judgehost, start de judgedeamon met $judgedeamon
*De site werkt nu op judge.a-eskwadraat.nl
*De ESCapade moet nu de teams en opdrachten in de website instellen
*Op de wedstrijddag zelf, blijf beschikbaar voor het geval er dingen mis gaan. (Met voorkeur bij A-Eskwadraat zelf, zodat je direct bij de server kan)

==Installeer een verse domjudge==
Nog te doen

==Links==
[https://www.domjudge.org/]

[[Category:Sysop]]