A-Eskwiki - User contributions [en]

Kaartjes bij activiteiten

2022-03-24T11:02:05Z

Timb: /* = Scannen met de app */

== QR-codes scannen ==

Om een QR-code van kaartjes bij een activiteit te scannen, moet eerst de kaartsoort op "CODE" staan.
Op de site worden van kaartjes ook aangegeven of ze al gescand zijn.

Vervolgens moet je naar de activiteit pagina gaan.
Hier is een knop te vinden met "Scanbare kaartjes activeren". Klik dit.

Dit bevat de "master qr-code", die belangrijk is om qr-codes te gaan scannen. Print deze dus 2x uit voor een activiteit begint en neem deze mee want deze is nodig om die van andere te scannen!

Vervolgens zijn er 2 manieren om kaartjes te scannen. Succes ermee! Vraag webcie dingen als iets in de fik vliegt.

=== Scannen met de app ===

Daarna, moet je de scan-app gebruiken. Dit is een speciale app, die [https://home.a-eskwadraat.nl/~floriann/kaartjesscanner.apk hier] te downloaden is.
Als je hem niet kan installeren, verwijder de "A-Appkwadraat", deze gebruikt hetzelfde certificaat. Als het nog niet werkt, moet je toestaan apps te installeren uit onbetrouwbare bron (zoek op internet, iets met USB debugging?).

In de app, ga je naar de activiteit en in het menu ga je naar "Scan tickets". Hier kun je nu kaartjes scannen.

=== Scannen met de speciale site ===

Ga met je mobiele browser (bij voorkeur Android + Firefox of Google Chrome, werkte in elk geval in 2019 nog niet op iPhones...) naar https://qr-scan.a-eskwadraat.nl/.
Zorg ervoor dat je de juiste activiteit ziet, anders moet de WebCie dit (op <code>vm-www2:/qr-scan/index.html</code>) fixen.

Gebruik nu je camera om de codes te scannen. Je kan ook de code overtypen in het tekstveldje bovenin.

== QRCode opnieuw mailen ==

Om de zoveel tijd krijgt de WebCie een mailtje van iemand dat de iDEAL-betaling voor een activiteitkaartje geslaagd was maar dat ze de aparte mail met kaartje niet hebben ontvangen. We weten nog niet precies waarom dit komt, maar we vermoeden dat een spamfilter te agressief de kaartjesmails opeet (al is het voorgekomen dat redelijk capabele gebruikers ze niet in de spamfolder tegenkwamen, dus het mysterie gaat door...)

Wat je dan kunt doen is checken of de IDEALTransactie inderdaad succesvol was, zo ja de code(s) opzoeken tussen de iDealKaartjeCode  en een mailtje sturen naar de arme kaartjesloze persoon. Probeer zoiets te schrijven:

<pre>
Beste [PERSOON],

Ik zie inderdaad een transactie op [DATUM], maar
[ die lijkt succesvol verstuurd te zijn | de mail is naar een ander e-mailadres verstuurd | de mail is compleet foutgegaan ]
(heb je al tussen de spam gekeken?).
De kaartjes die bij deze transactie horen, heb ik als attachment toegevoegd.
De geheime codes, voor het geval de plaatjes niet werken, zijn [B4N44N] en [W4TL3UKS].
Laat het ons weten als je nog problemen hebt.

Met vriendelijke groeten,

[AFZENDER]
namens de WebCie
[ATTACHMENTS MET QR-CODE VOOR KAARTJES]
</pre>

De qr-codes kun je genereren met het scriptje <code>scripts/create-qr-kaartje.php</code>, die je op de <code>vm-www-debug</code> kunt draaien. Het neemt twee command-line argumenten: geheime code van een ontbrekend kaartje en activiteitnummer. Op stdout verschijnt een PNG-bestand met je kaartje. Voorbeeldaanroep:

<pre>
~/wwwdebug/scripts$ ./create-qr-kaartje.php B4N44N 1337 > ~/troep/qr-kaartje-1.png
</pre>

Zie ook [https://www.a-eskwadraat.nl/Service/Bugweb/6956/ bug #6956]

[[Category:WebCie]]
[[Category:HowTo]]

Kaartjes bij activiteiten

2022-03-24T11:01:55Z

Timb:

== QR-codes scannen ==

Om een QR-code van kaartjes bij een activiteit te scannen, moet eerst de kaartsoort op "CODE" staan.
Op de site worden van kaartjes ook aangegeven of ze al gescand zijn.

Vervolgens moet je naar de activiteit pagina gaan.
Hier is een knop te vinden met "Scanbare kaartjes activeren". Klik dit.

Dit bevat de "master qr-code", die belangrijk is om qr-codes te gaan scannen. Print deze dus 2x uit voor een activiteit begint en neem deze mee want deze is nodig om die van andere te scannen!

Vervolgens zijn er 2 manieren om kaartjes te scannen. Succes ermee! Vraag webcie dingen als iets in de fik vliegt.

=== Scannen met de app==

Daarna, moet je de scan-app gebruiken. Dit is een speciale app, die [https://home.a-eskwadraat.nl/~floriann/kaartjesscanner.apk hier] te downloaden is.
Als je hem niet kan installeren, verwijder de "A-Appkwadraat", deze gebruikt hetzelfde certificaat. Als het nog niet werkt, moet je toestaan apps te installeren uit onbetrouwbare bron (zoek op internet, iets met USB debugging?).

In de app, ga je naar de activiteit en in het menu ga je naar "Scan tickets". Hier kun je nu kaartjes scannen.

=== Scannen met de speciale site ===

Ga met je mobiele browser (bij voorkeur Android + Firefox of Google Chrome, werkte in elk geval in 2019 nog niet op iPhones...) naar https://qr-scan.a-eskwadraat.nl/.
Zorg ervoor dat je de juiste activiteit ziet, anders moet de WebCie dit (op <code>vm-www2:/qr-scan/index.html</code>) fixen.

Gebruik nu je camera om de codes te scannen. Je kan ook de code overtypen in het tekstveldje bovenin.

== QRCode opnieuw mailen ==

Om de zoveel tijd krijgt de WebCie een mailtje van iemand dat de iDEAL-betaling voor een activiteitkaartje geslaagd was maar dat ze de aparte mail met kaartje niet hebben ontvangen. We weten nog niet precies waarom dit komt, maar we vermoeden dat een spamfilter te agressief de kaartjesmails opeet (al is het voorgekomen dat redelijk capabele gebruikers ze niet in de spamfolder tegenkwamen, dus het mysterie gaat door...)

Wat je dan kunt doen is checken of de IDEALTransactie inderdaad succesvol was, zo ja de code(s) opzoeken tussen de iDealKaartjeCode  en een mailtje sturen naar de arme kaartjesloze persoon. Probeer zoiets te schrijven:

<pre>
Beste [PERSOON],

Ik zie inderdaad een transactie op [DATUM], maar
[ die lijkt succesvol verstuurd te zijn | de mail is naar een ander e-mailadres verstuurd | de mail is compleet foutgegaan ]
(heb je al tussen de spam gekeken?).
De kaartjes die bij deze transactie horen, heb ik als attachment toegevoegd.
De geheime codes, voor het geval de plaatjes niet werken, zijn [B4N44N] en [W4TL3UKS].
Laat het ons weten als je nog problemen hebt.

Met vriendelijke groeten,

[AFZENDER]
namens de WebCie
[ATTACHMENTS MET QR-CODE VOOR KAARTJES]
</pre>

De qr-codes kun je genereren met het scriptje <code>scripts/create-qr-kaartje.php</code>, die je op de <code>vm-www-debug</code> kunt draaien. Het neemt twee command-line argumenten: geheime code van een ontbrekend kaartje en activiteitnummer. Op stdout verschijnt een PNG-bestand met je kaartje. Voorbeeldaanroep:

<pre>
~/wwwdebug/scripts$ ./create-qr-kaartje.php B4N44N 1337 > ~/troep/qr-kaartje-1.png
</pre>

Zie ook [https://www.a-eskwadraat.nl/Service/Bugweb/6956/ bug #6956]

[[Category:WebCie]]
[[Category:HowTo]]

Kaartjes bij activiteiten

2022-03-24T10:47:05Z

Timb:

== QR-codes scannen ==

Om een QR-code van kaartjes bij een activiteit te scannen, moet eerst de kaartsoort op "CODE" staan.

Vervolgens moet je naar de activiteit pagina gaan.
Hier is een knop te vinden met "Scanbare kaartjes activeren". Klik dit.

Dit bevat de "master qr-code", die belangrijk is om qr-codes te gaan scannen. Print deze dus 2x uit voor een activiteit begint en neem deze mee want deze is nodig om die van andere te scannen!

Daarna, moet je de scan-app gebruiken. Dit is een speciale app, die [https://home.a-eskwadraat.nl/~floriann/kaartjesscanner.apk hier] te downloaden is.
Als je hem niet kan installeren, verwijder de "A-Appkwadraat", deze gebruikt hetzelfde certificaat. Als het nog niet werkt, moet je toestaan apps te installeren uit onbetrouwbare bron (zoek op internet, iets met USB debugging?).

In de app, ga je naar de activiteit en in het menu ga je naar "Scan tickets". Hier kun je nu kaartjes scannen.

Op de site worden van kaartjes ook aangegeven of ze al gescand zijn.
Succes ermee!

Vraag webcie dingen als iets in de fik vliegt.

== QRCode opnieuw mailen ==

Om de zoveel tijd krijgt de WebCie een mailtje van iemand dat de iDEAL-betaling voor een activiteitkaartje geslaagd was maar dat ze de aparte mail met kaartje niet hebben ontvangen. We weten nog niet precies waarom dit komt, maar we vermoeden dat een spamfilter te agressief de kaartjesmails opeet (al is het voorgekomen dat redelijk capabele gebruikers ze niet in de spamfolder tegenkwamen, dus het mysterie gaat door...)

Wat je dan kunt doen is checken of de IDEALTransactie inderdaad succesvol was, zo ja de code(s) opzoeken tussen de iDealKaartjeCode  en een mailtje sturen naar de arme kaartjesloze persoon. Probeer zoiets te schrijven:

<pre>
Beste [PERSOON],

Ik zie inderdaad een transactie op [DATUM], maar
[ die lijkt succesvol verstuurd te zijn | de mail is naar een ander e-mailadres verstuurd | de mail is compleet foutgegaan ]
(heb je al tussen de spam gekeken?).
De kaartjes die bij deze transactie horen, heb ik als attachment toegevoegd.
De geheime codes, voor het geval de plaatjes niet werken, zijn [B4N44N] en [W4TL3UKS].
Laat het ons weten als je nog problemen hebt.

Met vriendelijke groeten,

[AFZENDER]
namens de WebCie
[ATTACHMENTS MET QR-CODE VOOR KAARTJES]
</pre>

De qr-codes kun je genereren met het scriptje <code>scripts/create-qr-kaartje.php</code>, die je op de <code>vm-www-debug</code> kunt draaien. Het neemt twee command-line argumenten: geheime code van een ontbrekend kaartje en activiteitnummer. Op stdout verschijnt een PNG-bestand met je kaartje. Voorbeeldaanroep:

<pre>
~/wwwdebug/scripts$ ./create-qr-kaartje.php B4N44N 1337 > ~/troep/qr-kaartje-1.png
</pre>

Zie ook [https://www.a-eskwadraat.nl/Service/Bugweb/6956/ bug #6956]

[[Category:WebCie]]
[[Category:HowTo]]

Pasfoto's uploaden

Jargon WebCie

2019-07-22T15:55:39Z

Timb: /* B */

[[Category:WebCie]]

Omdat de WebCie al een paar tientallen jaren meedraait, is er een enorme hoeveelheid jargon ontstaan. Vaak is dit een woord wat vroeger zinnig was, maar nu alleen maar uit traditie nog gebruikt wordt. Tevens een mooie geschiedenispagina.

== B ==

* bookweb (het oude ~) /'bok.ʋeb/: Het boekverkoopsysteem van A–Eskwadraat, wat nog niet op basis van het WhosWho4-framework werkt.
* boekenweb (het nieuwe ~ 2.0) /'bu.kən.ʋɛb/: De opvolger van bookweb, die op basis van het WhosWho4-framework werkt. Is nog steeds niet af, omdat het een rotklus is en bovendien de code van al mijn voorgangers slecht is :P

== C ==

* ChopChop: Een wokrestaurant waar de WebCie rond 2012 veel eten bestelde. Codenaam voor WhosWho4.
* Colaproduct: De dingen die [[DiBS]] verkoopt, zoals fris en snoep.

== D ==

* debugrootdir: ook wel bekend als de <code>wwwdebug</code>-map: de directory waar de hele checkout instaat, waaronder <code>docs</code>, <code>gettext</code> en <code>www</code>.
* DiBS: Het Digitaal BetaalSysteem van A–Eskwadraat, wat eerst door de DibsCie werd gebouwd en nu door de WebCie (interface en backend) en Sysop (hardware) wordt gerund.
* DiBSproduct: BoekWeb2-artikels waarmee je kudo's kan kopen. In de praktijk is er een uniek artikel: Kudo, die 1 kudo per eurocent geeft.
* DiLI: De Digitale LedenInschrijving van A–Eskwadraat, wat bijnaleden (die zich hebben aangemeld voor de intro) om hun lidgegevens vraagt, eventueel betalingen wil, en vervolgens tot ingeschreven promoveert (opdat de secretaris nog een check erop uitvoert). Zie ook: Introsmurf.

== I ==

* Introsmurf: Het websiteonderdeel dat gegevens van mentorgroepjes en introdeelnemers enzo bijhoudt. Heeft jaarlijks wat onderhoud nodig (zie de respectievelijke pagina's voor meer info).

== L ==

* layout, nieuwe: Bootstrap-gebaseerde layout voor WhosWho4 die de pastelkleurtjeslayout [https://www.a-eskwadraat.nl/Vereniging/Nieuws/854/ verving in 2014]. Gebruikt ook nog verschillende kleurtjes voor de verschillende site-onderdelen.
* layout, nieuwe nieuwe: Bootstrap-gebaseerde layout voor WhosWho4 die de nieuwe layout [https://www.a-eskwadraat.nl/Vereniging/Nieuws/932/ verving in 2017].
* layout, pastelkleurtjes-: Layout voor WhosWho4 die voor elk site-onderdeel een ander pastelkleurtje gebruikte.

== S ==

* space: De infrastructuur van de website. Vroeger had je verschillende siteonderdelen als WhosWho en Bookweb, en space diende om ze in een samenhangend geheel te duwen. Tegenwoordig bevat space vooral alle functionaliteit die voor websites in het algemeen nodig zijn, en is WhosWho4 het framework voor onze objecten en Model-View-Controllerstructuur.
* square: Een server met een database enzo (oftewel [[vm-www]] en [[vm-www-debug]], en misschien [[Inwerking|vm-www-inwerking]]). Was oorspronkelijk het equivalent van de [[vm-www]]. Krijg je bij scripts runnen een error die klaagt dat je niet op space zit, SSH dan eerst naar een vm-www-*.

== V ==

* variabele entry: [[Benamite]]-entry die werkt als een map, maar waarvan de naam varieert. Zorgt bijvoorbeeld dat <code>/Leden/8566</code> wijst naar de ledenpagina van Joe'p.

== W ==

* WhosWho: Het ledenzoeksysteem van A–Eskwadraat. Is tegenwoordig, in de vorm van WhosWho4, een combinatie van ORM&MVC-framework en leden-commissie-activiteitenzoeksysteem.
* WhosWho4: Een combinatie van ORM&MVC-framework en leden-commissie-activiteitenzoeksysteem. [https://git.a-eskwadraat.nl/webcie/website/commit/a9f6b58734dcd89c816fd906ecab98f0215c85eb In 2012] gemaakt ter vervanging van WhosWho3.

Webcie-vm

2019-07-22T15:45:19Z

Timb: Stel logrotate in bij aanmaken nieuwe VM

Zie ook: [[Webcie-vms]] (!)

== Nieuwe vm-webcie-debug aanmaken ==

Maak een nieuwe vm vm-webcie-debug aan. Kickstart de vm en highstate de vm met salt. Installeer mariadb met het volgende commando:
<pre>/usr/bin/mysql_secure_installation</pre>

Zet het rootwachtwoord en disalow root login remotely. Let op: de rootwachtwoorden van de databases van de vm-webcie/www en vm-webcie/www-debug moeten hetzelfde zijn!

Maak in de home van de root het bestandje .my.cnf aan (zet de rechten op 0600!) met de volgende content:
<pre>[client]
user = root
pass = root-database-wachtwoord</pre>

Maak ook de juiste databases aan (bv test_whoswho4, test_benamite of boeken. Denk eraan dat op een vm-webcie/www-machine er zowel de normal db als test_db moeten zijn). Kopieër nu de databases. Vergeet ook niet de mysql-database te kopieëren, daar staan de rechten van de verschillende gebruikers in. Maak eerst een dump op de oude vm:
<pre>mysqldump 'dbnaam' > 'dbnaam'.db</pre>

Kopieër het dumpbestand naar de nieuwe vm en laad de dump in op de nieuwe vm:
<pre>mysql 'dbnaam' < 'dbnaam'.db</pre>

== Opzetten vm-www2 ==

Deze instructies zijn bedoeld voor de WebCie. We gaan ervan uit dat je het WebCie-wachtwoord uit je hoofd kent.

Vraag de Sysop om een nieuwe vm (ik bedoel uiteraard container ;)) met subdomein (in dit geval: vm-www2.a-eskwadraat.nl) en dezelfde mounts als de originele vm. Zorg ervoor dat sendmail vanaf de nieuwe vm werkt. Verkrijg roottoegang op de vm-www2.

In het begin heeft yum nog een update voor repositorygegevens nodig: doe <code>yum clean all</code> voordat je een ander yum-commando draait.

=== Mariadb en replicatie ===

Installeer mariadb als op de vm-www-debug: <code>yum install mariadb mariadb-server</code> (let op: ivm backwards incompatibility willen we versie 5.5 voorlopig), <code>systemctl enable mariadb</code>, <code>systemctl start mariadb</code> en dan <code>/usr/bin/mysql_secure_installation</code>. Check even of inloggen nog werkt: <code>mysql -u root -p</code>. Check ook dat je verbinding kan maken met mysql op de originele host vanaf de nieuwe host: <code>mysql -h vm-www -u root -p</code>.

'''LET OP!''' Replicatie gaat niet helemaal goed samen met de [[Backup#Backup_van_binaire_logs|backup van de binaire logs]], zorg er eerst voor dat dat gefixt is, voordat je deze handleiding verder leest.

Nu gaan we [https://mariadb.com/kb/en/library/replication-overview/ replicatie] opzetten (master-master). We moeten hiervoor een random wachtwoord genereren, bewaar die goed! Open in een nieuwe terminal op de originele host, en pas de <code>my.cnf</code> aan:
<pre>
[mysqld]
server-id=1
log-bin
</pre>
Herstart mysqld/mariadb om de wijzigingen toe te passen. Log in als root op mysql en geef permissies: <code>grant replication slave on *.* to repli@'vm-www2.a-eskwadraat.nl' identified by 'replipassword'; flush privileges;</code>. Zet de tabellen op slot terwijl we de rest doen: <code>flush tables with read lock;</code>. Ten slotte moeten we wat gegevens bekomen: <code> show master status\G</code>. Log niet uit tot we klaar zijn, dan gaan de tabellen weer van het slot af.

In de andere terminal op <code>vm-www2</code> gaan we ook de <code>my.cnf</code> aanpassen (ik heb de wijzigingen in <code>/etc/my.cnf.d/webcie.cnf</code> gezet):
<pre>
[mysqld]

server-id=2
</pre>
Herstart mariadb om de wijzigingen toe te passen. We moeten ook de volledige(!!!) [https://stackoverflow.com/questions/1078196/how-to-take-complete-backup-of-mysql-database-using-mysqldump-command-line-utili#27400627 databaasinhoud overzetten]. (Dit is een van de redenen dat je een read lock hebt.) Doe een mysqldump van de gehele database inclusief tabellen, permissies en inhoud en pas die toe op de nieuwe db.

Log in op de nieuwe db met <code>mysql -u root -p</code> en stel replicatie in:
<pre>
CHANGE MASTER TO
MASTER_HOST='master.domain.com',
MASTER_USER='replication_user',
MASTER_PASSWORD='bigs3cret',
MASTER_PORT=3306,
MASTER_LOG_FILE='mariadb-bin.000096',
MASTER_LOG_POS=568,
MASTER_CONNECT_RETRY=10;
</pre>
(De juiste waarden haal je uit de uitvoer van <code> show master status\G</code> op de originele host.) Vervolgens <code>START SLAVE; SHOW SLAVE STATUS \G</code>.

Als de uitvoer een beetje sense maakt, dan heb je succesvol een master-slave replicatie van de oude naar de nieuwe host opgezet. Doe <code>UNLOCK TABLES;</code> op de originele host en probeer wat aan te passen. Dit zou op de nieuwe host terecht moeten komen.

Als een error bij de slave gebeurd is die niet op master voorkwam, gaat die blokkeren tot je het fixt. Wat je kan doen als het echt helemaal in de soep loopt, is opnieuw alles op slot gooien, een dbdump overnemen van master naar slave. Doe weer <code> show master status\G</code> en unlock de master. Vervolgens doe je op de slave <code>change master to MASTER_LOG_POS=37071; START SLAVE;</code> en dan zou die automatisch alles wat sinds de backup is gebeurd, weer naar binnen gaan slurpen.

Nu gaan we de replicatie de andere kant op sturen. Dit is in principe het precies omgekeerde van wat we hiervoor deden. Pas op vm-www2 de <code>my.cnf</code> aan:
<pre>
[mysqld]
server-id=2
log-bin
</pre>
en herstart mariadb. Voeg de repli-user toe op de vm-www2: <code>grant replication slave on *.* to repli@'vm-www.a-eskwadraat.nl' identified by 'replipassword'; flush privileges;</code>. Doe op allebei de hosts een table lock, doe op de nieuwe host <code>show master status\G</code> en op de originele host de replicatie-instellingen:
<pre>
CHANGE MASTER TO
MASTER_HOST='master.domain.com',
MASTER_USER='replication_user',
MASTER_PASSWORD='bigs3cret',
MASTER_PORT=3306,
MASTER_LOG_FILE='mariadb-bin.000096',
MASTER_LOG_POS=568,
MASTER_CONNECT_RETRY=10;
</pre>
En nu kun je op de originele host <code>start slave;</code> runnen, en je hebt een master-masterreplicatie :D

=== Installeer Apache, PHP en PHP-FPM ===

Doe <code>yum install httpd</code> voor Apache.
Voor een niet verschrikkelijk antieke PHP moet je extra dingen installeren (zie ook [https://rpms.remirepo.net/wizard/]:
<pre>
yum install epel-release
yum install http://rpms.remirepo.net/enterprise/remi-release-7.rpm
yum install yum-utils
yum-config-manager --enable remi-php56 # of php72 of andere versie
yum install php php-fpm
</pre>

Installeer ook alle [[PHP-extensies]] die nodig zijn. (Zie die pagina voor de lijst.)

Overige dependencies:
<pre>
yum install gettext java npm python36 python36-virtualenv
npm install -g bower
</pre>

Nu moeten we PHP-instellingen regelen. Maak een checkout van de website, en doe daarin:
<pre>
mkdir config/vm-www2
ln -s /etc/php.ini config/vm-www2/
vim config/vm-www2/php.ini # Pas hier alle relevante config van de vm-www toe.
</pre>

=== Installeer WhosWhoPy ===

Volg hiervoor de stappen in [[WhosWhoPy op een webcie-vm]].

=== Cron instellen ===

Maak een map <code>/website-output</code> aan en chown die naar <code>apache:apache</code> (en zorg ervoor dat apache ernaar kan schrijven :P). Hierin komt alle output van cronjobs enzo.

Je kan in principe de crontab van de oude vm overnemen, dus ga naar de checkout, en doe:
<pre>
cp scripts/cron/crontab-$VMOUD-apache scripts/cron/crontab-$VMNIEUW-apache
crontab -u apache scripts/cron/crontab-$VMNIEUW-apache
</pre>
om de cronjobs te activeren.

Zorg er wel voor dat de <code>apache</code>-user toegang heeft tot de databases! Kopieer de <code>.my.cnf</code> van de webcie-user naar de homedir van apache (<code>/usr/share/httpd/.my.cnf</code>). (En check misschien ook dat daar een user en password ingesteld staan.)

=== Mail werkend krijgen ===

De website gebruikt sendmail-commando's om te mailen. Normaal stuurt sendmail de mails direct het web op, maar we willen dat deze door de vm-mailpp heen gestuurd wordt zodat de berichten juist zijn ondertekend en door spamfilters heen komen. Hiervoor gebruiken we het sendmail-commando dat uit postfix komt. Installeer postfix met:
<pre>yum install postfix</pre>

De configuratie van postfix ongeveer dezelfde als op alle CentOS7 machines en is te vinden op de vm-salt-master in <code>/srv/salt/centos7/global/main.cf</code>. Je moet de volgende parameters aanpassen zodat mail naar buiten mag:
<pre>mydomain = a-eskwadraat.nl</pre>

Om mailings te configureren, voeg de volgende parameters toe aan <code>main.cf</code>:
<pre>
inet_interfaces = all
relay_domains = a-eskwadraat.nl
smtpd_recipient_restrictions = check_recipient_access regexp:/etc/postfix/access, reject_unauth_destination</pre>
En voeg de volgende regels toe aan <code>/etc/postfix/master.cf</code>:
<pre>
bughook unix - n n - - pipe
flags=F user=webcie argv=/website/scripts/mail_process_bug_vm-www ${sender} ${size} ${recipient}
lidhook unix - n n - - pipe
flags=F user=webcie argv=/website/scripts/mail_process_lid ${sender} ${size} ${recipient}
bouncehook unix - n n - - pipe
flags=F user=webcie argv=/website/scripts/mail_process_bounce ${sender} ${size} ${recipient}
mailinghook unix - n n - - pipe
flags=F user=webcie argv=/website/scripts/mail_process_incoming_mailing.php ${sender} ${size} $$
</pre>
En plaats de volgende regels in <code>/etc/postfix/access</code>:
<pre>
/^lid-[0-9]+@a-es((kwadraat)|(2))\.nl$/ FILTER lidhook:
/^bug(([0-9]+)|(s))@a-es((kwadraat)|(2))\.nl$/ FILTER bughook:
/^bounce-[0-9]+@a-es((kwadraat)|(2))\.nl$/ FILTER bouncehook:
/^((.*-)|)mailing((s)|)@a-es((kwadraat)|(2))\.nl$/ FILTER mailinghook:
</pre>

Stel nu in dat het sendmail-commando uit postfix gebruikt wordt in plaats van de standaard sendmail:
<pre>update-alternatives --config mta</pre>
En start dan de postfix service met <code>service postfix start</code>.

Zo worden de mails doorgestuurd naar de juiste scriptjes van de WebCie. Zie [[Mail sturen naar de site]]

=== IPA ===
<pre>yum install ipa-client</pre>
Voor autologin:
<pre>yum install mod_auth_kerb mod_authnz_pam mod_lookup_ident sssd-dbus</pre>

Het volgende moet de sysop regelen:
<pre>
ipa-client-install
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>"

Ga naar de ipa webinterface
Ga naar de tab hosts
Ga naar de juiste host
klik op actions -> add New certificate

Voer nu de volgende commands uit in de commandline:
mkdir /etc/nssdb
cd /etc/nssdb
certutil -N -d .

mkdir /etc/httpd/certs
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</pre>

Voor autologin op de site:
<pre>
ipa-getkeytab -s ipa05.a-eskwadraat.nl -p HTTP/www-auth.a-eskwadraat.nl -k /etc/httpd/conf/httpd.keytab
</pre>
Stel de volgende gegevens in in <code>/etc/sssd/sssd.conf</code> voor zover deze nog niet bestaat.

Onder <code>[domain/a-eskwadraat.nl]</code>:
<pre>ldap_user_extra_attrs = mail,memberId,email:mail</pre>
Onder <code>[sssd]</code>:
<pre>services = nss, sudo, pam, ssh, ifp</pre>
Onder <code>[ifp]</code>:
<pre>
allowed_uids = apache, root
user_attributes = +memberId
</pre>

=== Overige tsjak ter installatie ===

<pre>yum install ffmpeg git sudo vim wget</pre>

=== De website opzetten ===

Heb je alles geïnstalleerd, dan ben je klaar voor de laatste fase.

Vertel de scripts dat dit een host is: <code>vim /etc/function</code> en stop daarin <code>server</code>.

Ga naar de checkout van de website, kopieer handmatig de secret.php en doe daarin manage build. (Dit moet na de php-instellingen gebeuren want manage voert php uit.)

Pas de httpd-configuratie aan om de juiste paden in te stellen:
<pre>
cp config/vm-www/httpd/conf.d/website.conf /etc/httpd/conf.d/
ln -s /etc/httpd config/vm-www2/httpd
vim config/vm-www2/httpd/conf.d/website.conf
</pre>

Nu kun je de webserver aanzwengelen :D <code>systemctl restart httpd<code> <code>systemctl restart php-fpm</code>

Je moet waarschijnlijk nog wat chmod'en en paden aanmaken, zie daarvoor de logs in <code>/var/log/httpd/error_log</code> en <code>/var/log/php-fpm/error.log</code> en <code>/var/log/www/php-warnings.log</code> (in volgorde van dingen werkend krijgen).

== Configuratie op lagere prioriteit ==

Nadat alles werkt, moet je nog wat andere dingen configureren die het geheel draaiende houden.

[[Logrotate]] zorgt ervoor dat je schijf niet overvol raakt met enorme logbestanden,
door oude logbestanden om de zoveel tijd weg te halen.
De site logt verscheidene dingen naar <code>/var/log/www/</code>, dus we gaan de inhoud van die map roteren.
Zet in <code>/etc/logrotate.d/webcie</code>:
<pre>
/var/log/www/*log {
rotate 4
compress
missingok
notifempty
sharedscripts
delaycompress
postrotate
/bin/systemctl reload httpd.service > /dev/null 2>/dev/null || true
/bin/kill -SIGUSR1 `cat /run/php-fpm/php-fpm.pid 2>/dev/null` 2>/dev/null || true
endscript
}
</pre>

[[Category:Sysop]] [[Category:WebCie]]

Nieuw WWW-lid

2019-05-01T21:44:53Z

Timb: /* Webcie */

Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:

== Bestuur ==

#Toevoegen aan 'webcie' (inloggen op de server en bij de repo)

== Webcie ==

Ga naar de [[vm-www-debug]] en log in als user webcie:
ssh vm-www-debug
sudo -i -u webcie

Toevoegen aan de htpasswd:
htpasswd /srv/htpasswd $USER
Toevoegen aan de htgroups (let op dat alles na <code>www:</code> op een regel hoort te komen!)
vim /srv/config/vm-www-debug/httpd/conf.d/htgroups
vim /srv/config/vm-www/httpd/conf.d/htgroups
Toevoegen aan de <code>wwwdebug.conf</code>
cd /srv/http/www/git
vim config.yaml
Op dit punt moet je even een WebCie'er laten weten dat je jezelf een debug aan het geven bent. Die zal jou vertellen wat er ingevuld moet worden om jouw eigen debugomgeving op te zetten.
source venv/bin/activate
./scripts/debugconfig.py
git add -p
git commit
git push
sudo service httpd restart
Toevoegen aan de git repo
Vraag aan een momenteel webcie lid om dit te doen

== Nieuw lid ==

Als eerste ga je de code van de website binnenhalen en je eigen debugomgeving aanmaken. Dit doe je door de volgende commando's in een terminal te draaien:

(Weet je niet hoe je een 'terminal' moet openen? Vraag een medewebcieër!)

cd /mnt/wwwdebug2
mkdir $USER/
cd $USER
git clone https://gitlab.com/iba-aes/webcie/website.git wwwdebug
cd wwwdebug/www
./manage build --enable-debug --hostname=DEBUGNAAM-debug.a-eskwadraat.nl
ln -s /mnt/wwwdebug2/$USER/wwwdebug/ ~/wwwdebug

(Hier moet je <code>DEBUGNAAM</code> vervangen met de naam van je debugomgeving, bijvoorbeeld 'pepernoot' of 'comint'.)

Dit zorgt ervoor dat de code die in de map <code>~/wwwdebug</code> staat wordt uitgevoerd wanneer je naar <code>DEBUGNAAM-debug.a-eskwadraat.nl</code> gaat in je browser.

[[Category:WebCie]]
[[Category:HowTo]]

WebCie Databases

2019-04-17T13:30:06Z

Timb: /* Voorbeeld: een veld toevoegen aan een tabel */

De WebCie runt een paar databases waarin alle websitedata (dus ook ledendata, en transactiedata) staat. Op de [[vm-www]], [[vm-www-debug]] en de [[vm-www-inwerking]] draaien allemaal een databaseserver en dezelfde databasestructuur (modulo updatevolgorde).

== Gebruik in de code ==

De beste manier om kwerries op de databaas te doen is met [[QueryBuilder]]. Dit is een manier om volautomatisch SQL te genereren vanuit object-georienteerde code, zonder dat je bang hoeft te zijn voor injectie enzo.

De belangrijkste database is <code>whoswho4</code>, waar alle [[WhosWho4]]-objecten in staan. Dan zijn er nog <code>benamite</code> voor [[Benamite]] en <code>boeken</code> voor [[Bookweb]].

=== Hoe een db-connectie opgezet wordt ===

In principe zouden dingen als databaseconnectie enzo al geregeld moeten zijn als je controllerfunctie aangeroepen wordt, maak hier dus alleen zorgen over als je ergens in [[space]] bezig bent.

Eerst wordt door [[space]] het bestand [[secret.php]] geladen, waarin gebruikersnaam en wachtwoord voor alle databaseusers staan. Op basis van de functie <code>getLevel</code> worden drie globalen <code>$WSW4DB</code>, <code>$BWDB</code> en <code>$BMDB</code> gemaakt door middel van [https://doxygen-www.a-eskwadraat.nl/classdbpdo.html dbpdo]. Hun memberfunctie <code>q(...)</code> verstuurt een kwerrie naar de desbetreffende databaas.

Dit zorgt er ook voor dat inloggen en uitloggen (en eigenlijk alles wat de auth van de gebruiker aanpast) een refresh vereist voordat alles goed weergegeven kan worden!

== Debugdatabase ==

Op de [[vm-www-debug]] wordt elke nacht een kopietje gemaakt van de livedatabases om op te kunnen debuggen. Deze db's heten <code>test_$BLA</code> waar <code>$BLA</code> staat voor de naam van de originele database.

Om precies te zijn, elke dag wordt <code>scripts/cron/copy_db_to_test_db.sh boeken whoswho4</code> aangeroepen op de live-server (zolang bookweb nog wordt gebruikt met <code>boeken</code>).
Elke maandag ochtend wordt de tabel <code>benamite</code> gekopieerd naar de debug database.
Dit valt terug te vinden in de crontab onder <code>scripts/cron</code>.
De aanroep is <code>ssh root@vm-www-debug -i ~/.ssh/debug test_$db</code>. Zoals je misschien vermoedt, is er geen commando genaamd <code>test_$db</code> op de vm-www-debug. In plaats daarvan staat in <code>~/.ssh/authorized_keys</code> van root@vm-www-debug ingesteld dat bij ssh'en het commando <code>mysql</code> aangeroepen wordt in plaats van wat je van plan bent. Bij navraag bij degene die deze soepmes begaan heeft, antwoordde die: "zo is natoer".

== Nieuwe database aanmaken ==

(De bedoeling is dat we het bij de huidige db's houden, maar misschien is er in de toekomst een goede reden!)

Als je een nieuwe WebCie-database wilt aanmaken, moet je ook het [[Backup|backupscript]] aanpassen. Daarin staan namelijk alle databases die gebackupt worden. Vergeet ook niet verbindingen te openen met de nieuwe db in [[space]].

== Databasestructuur aanpassen ==

De databasestructuur wordt in de repository opgeslagen door middel van [http://alembic.zzzcomputing.com/en/latest/index.html Alembic]. Deze bewaart de geschiedenis in de vorm van een gerichte graaf van revisie, een soort git maar dan voor databasestructuur.
In tegenstelling tot git, begin je met de revisie een naam geven, en pas je daarna een bestand aan.

=== Voorbeeld: een veld toevoegen aan een tabel ===

Stel dat je in het Persoon-object een veld 'naamHuisdier' wilt toevoegen.
De makkelijkste manier is om [[Dia en generated code|de dia aan te passen]] en dan in je terminal uit te voeren: <code>manage revision 'veld naamHuisdier toevoegen in Persoon'</code>.
Dit zou volautomatisch een databaserevisie moeten maken en openen in je favoriete editor. ('''PRO-TIP''': opent niet je favoriete editor? Stel <code>$EDITOR</code> in!)
Vervolgens kun je de migratie naar hartelust aanpassen.

Ben je tevreden met de wijzigingen, dan sla je het bestand op,
en doe je op de command line <code>alembic upgrade head</code>.
Dit past je wijzigingen toe op de debugdatabase.
Nu kun je de nieuwe databasestructuur gaan testen.
'''LET OP''': als je je revisie aan wil passen, doe eerst <code>alembic downgrade -1</code> om die ongedaan te maken.

Na verloop van tijd is je feature hopelijk naar de livesite gemerged.
Het livezetten gaat hetzelfde: doe op de [[vm-www]] weer <code>alembic upgrade head</code> (vergeet niet eerst <code>source venv/bin/activate</code> te doen om de commando's beschikbaar te maken!)
en alle wijzigingen worden automatisch doorgevoerd.
Als je wijzigingen op de livesite doorgevoerd hebt, moet je de [[Databasestructuur committen]].

==== Hetzelfde, maar dan handmatig ====

In het handmatige geval doe je als eerste stap in de command line <code>alembic revision -m 'veld naamHuisdier toevoegen in Persoon'</code>.
Alembic maakt dan een bestand aan in <code>alembic/versions/</code> met een of andere naam.
Open dat bestand in je favoriete teksteditor ('''PRO-TIP''': stel <code>$EDITOR</code> in en doe <code>alembic edit head</code>).
Nu kun je in het bestand operaties gaan toevoegen, zodat je bestand er ongeveer uitziet als:
<code><pre>
# ... metadata voor Alembic

from alembic import op
import sqlalchemy as sa

def upgrade():
op.add_column('Persoon', sa.Column('naamHuisdier', sa.String))

def downgrade():
op.drop_column('Persoon', 'naamHuisdier')
</pre></code>
Het is belangrijk om upgrade en downgrade elkaars inverses te maken (op de structuur, want data kun je misschien wel kwijtraken),
zodat het schakelen tussen branches goedgaat.

Het verdere verloop is net als bij automatische migraties.

== In de database graven ==

Wil je iets in de database doen dat niet kan met de site? Dan kun je op [https://pgadmin-debug.a-eskwadraat.nl] (of als je echt PHPMyAdmin nodig hebt [https://admin-debug.a-eskwadraat.nl]) (debugdb) en [https://admin.a-eskwadraat.nl] (livedb) inloggen op localhost met gebruikersnaam root en het databasewachtwoord. Dit wachtwoord vind je in het bestand <code>.my.cnf</code> in de homedir van gebruiker <code>webcie</code>.

== Migratie naar PostgreSQL ==

MySQL is stiekem best wel slecht, dus we willen graag in plaats daarvan PostgreSQL gebruiken. De migratie gaat ongeveer als volgt.

SSH naar de VM waar de oorspronkelijke database opstaat. Dan doe je ongeveer de volgende stappen (dit is voor de vm-www-debug).
Eerst installeren we Postgres:

<code><pre>
wget https://download.postgresql.org/pub/repos/yum/9.6/redhat/rhel-6-x86_64/pgdg-centos96-9.6-3.noarch.rpm
rpm -Uvh pgdg-centos96-9.6-3.noarch.rpm
sudo yum update
sudo yum install postgresql96-server postgresql96-contrib
sudo service postgresql-9.6 initdb
sudo service postgresql-9.6 start
sudo chkconfig postgresql-9.6 on
sudo -i
su postgres
psql
</pre></code>

Doe nu <code>CREATE USER</code> voor alle users in je [[secret.php]].

Dan zijn we klaar om de koppeling met PHP te maken:

<code><pre>
sudo yum install php-pgsql
sudo service httpd restart
</pre></code>

Pas <code>/var/lib/pgsql/9.6/data/pg_hba.conf</code> aan zodat je auth method md5 gebruikt.
(De bestanden <code>/usr/pgsql/*</code> slaan nergens op, negeer deze.)

<code><pre>
sudo service postgresql-9.6 restart
</pre></code>

Je zou nu moeten kunnen inloggen met <code>psql --user $BLA -d postgres</code>
en ook op adminer (maar let op dat je een database kiest die bestaat).

=== Data migreren ===
Ruim eerst je DB een beetje op!
(oftewel zorg dat je foreign keys kloppen, dat er geen datums zijn met jaar 0000, maand 00 of dag 00 enzo)

Dit is een volledige migratie, inclusief dbstructuur. Gebruik andere opties voor <code>mysqldump</code> om alleen data te verhuizen.
<code><pre>
mysqldump --compatible=postgresql --user=root --password --default-character-set=utf8 test_whoswho4 > export.sql
python2.7 docs/db_converter.py export.sql pg-export.sql
psql -d test_whoswho4 -U root -f pg-export.sql
</pre></code>

PRO-TIP: pas de relaties eerst handmatig aan, want die zijn niet echt goed over te zetten.

Vervolgens moeten we handmatig alle tabellen die in MySQL een autoincrement hadden, maar waar die kolom niet <code>id</code> heet, in PostgreSQL een sequencenummer geven. Dat ziet er ongeveer zo uit:

<code><pre>
CREATE SEQUENCE IOUBon_bonID_seq;
SELECT setval('IOUBon_bonID_seq', max("bonID")) FROM "IOUBon";
ALTER TABLE "IOUBon" ALTER COLUMN "bonID" SET DEFAULT nextval('IOUBon_bonID_seq');
</pre></code>

Heb je dat allemaal gedaan, dan moet je ook voor alle databaseusers rechten geven:

<code><pre>
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO god;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO ingelogd;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO dibstablet;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO mollie;
GRANT USAGE, SELECT ON ALL SEQUENCES IN SCHEMA public TO gast;
</pre></code>

Nu moeten we ook nog de rechten overnemen. In MySQL doe je <code>SHOW GRANTS FOR '$USER'@'localhost'</code> voor alle users in de db-wachtwoorden, pas de output hiervan aan tot PostgreSQL-syntax en voer die uit. (Dit is een hoop werk!)

[[Category:WebCie]]

Uitgebreid Zoeken

2019-03-20T20:22:01Z

2019-03-06T15:38:32Z

Timb: /* Maak een (lege) virtualenv aan */

[[Category:WebCie]] [[Category:HowTo]] [[Category:WhosWhoPy]]

[[WhosWhoPy]] wordt op de WebCie-VM's gehost door middel van Apache en mod_wsgi.

Om WhosWhoPy op een WebCie-VM te installeren, volg je de volgende stappen. We gaan er al vanuit dat je Apache en PHP hebt geïnstalleerd. (Zie ook [[Webcie VM]] voor instructies daarvoor.)

== Installeer Python ==

Ten eerste hebben we een recente (minstens Python 3 uiteraard!) versie van Python nodig:
<pre>
yum install python36 python36-virtualenv
</pre>

== Installeer mod_wsgi ==

mod_wsgi geeft de request uit Apache door naar Python. Je moet opletten dat je een recente mod_wsgi gebruikt, anders krijg je problemen met oude Pythonversies. In ons geval (de vm-www-debug) moeten we Pip gebruiken om een recente mod_wsgi te bekomen. Daarvoor installeren we eerst de Python-developmentheaders:
<pre>
sudo yum install python36u-devel
</pre>
en dan mod_wsgi zelf:
<pre>
sudo pip3.6 install mod_wsgi
</pre>

Stel Apache in zodat die mod_wsgi laadt, door <code>/etc/httpd/conf/httpd.conf</code> aan te passen en de mod_wsgi-module in te laden (check ook even of dit het juiste pad is ernaartoe):
<pre>
LoadModule wsgi_module /usr/lib64/python3.6/site-packages/mod_wsgi/server/mod_wsgi-py36.cpython-36m-x86_64-linux-gnu.so
</pre>

Herstart Apache om instabiliteit te voorkomen:
<pre>
sudo service httpd restart
</pre>

== Maak een (lege) virtualenv aan ==

Hoewel elke (debug)website hun eigen virtualenv heeft, kan <code>mod_wsgi</code> dat eigenlijk niet aan. Dit fixen we door een lege virtualenv aan te maken voor de daemon, en vervolgens in het daadwerkelijke Pythonscript die te vervangen met de juiste virtualenv.
<pre>
sudo python3 -m virtualenv /usr/local/venvs/empty
</pre>

== Stel in dat requests worden doorgegeven ==

Pas de configuratie van Apache aan, en zet daar het equivalent van het volgende neer, afhankelijk van de hostnaam en installatielocatie enzo:
<pre>
<VirtualHost *>
ServerName boom-debug.a-eskwadraat.nl

WSGIDaemonProcess whoswhopy user=apache group=apache threads=5 python-home=/usr/local/venvs/empty
WSGIScriptAlias / /mnt/wwwdebug2/lidanoniem/wwwdebug/whoswhopy.wsgi

<Directory /mnt/wwwdebug2/lidanoniem/wwwdebug>
WSGIProcessGroup whoswhopy
Order deny,allow
Allow from all
</Directory>
</VirtualHost>
</pre>

Herstart Apache nogmaals:
<pre>
sudo service httpd restart
</pre>

En nu zou het moeten werken :D

WhosWhoPy op een webcie-vm

2019-03-06T15:38:18Z

Timb: Created page with "Category:WebCie Category:HowTo Category:WhosWhoPy WhosWhoPy wordt op de WebCie-VM's gehost door middel van Apache en mod_wsgi. Om WhosWhoPy op een WebCie-VM..."

[[Category:WebCie]] [[Category:HowTo]] [[Category:WhosWhoPy]]

[[WhosWhoPy]] wordt op de WebCie-VM's gehost door middel van Apache en mod_wsgi.

Om WhosWhoPy op een WebCie-VM te installeren, volg je de volgende stappen. We gaan er al vanuit dat je Apache en PHP hebt geïnstalleerd. (Zie ook [[Webcie VM]] voor instructies daarvoor.)

== Installeer Python ==

Ten eerste hebben we een recente (minstens Python 3 uiteraard!) versie van Python nodig:
<pre>
yum install python36 python36-virtualenv
</pre>

== Installeer mod_wsgi ==

mod_wsgi geeft de request uit Apache door naar Python. Je moet opletten dat je een recente mod_wsgi gebruikt, anders krijg je problemen met oude Pythonversies. In ons geval (de vm-www-debug) moeten we Pip gebruiken om een recente mod_wsgi te bekomen. Daarvoor installeren we eerst de Python-developmentheaders:
<pre>
sudo yum install python36u-devel
</pre>
en dan mod_wsgi zelf:
<pre>
sudo pip3.6 install mod_wsgi
</pre>

Stel Apache in zodat die mod_wsgi laadt, door <code>/etc/httpd/conf/httpd.conf</code> aan te passen en de mod_wsgi-module in te laden (check ook even of dit het juiste pad is ernaartoe):
<pre>
LoadModule wsgi_module /usr/lib64/python3.6/site-packages/mod_wsgi/server/mod_wsgi-py36.cpython-36m-x86_64-linux-gnu.so
</pre>

Herstart Apache om instabiliteit te voorkomen:
<pre>
sudo service httpd restart
</pre>

== Maak een (lege) virtualenv aan ==

Hoewel elke (debug)website hun eigen virtualenv heeft, kan <code>mod_wsgi</code> dat eigenlijk niet aan. Dit fixen we door een lege virtualenv aan te maken voor de daemon, en vervolgens in het daadwerkelijke Pythonscript die te vervangen met de juiste virtualenv.
<pre>
sudo python3 -m virtualenv /usr/local/venvs/empty
</code>

== Stel in dat requests worden doorgegeven ==

Pas de configuratie van Apache aan, en zet daar het equivalent van het volgende neer, afhankelijk van de hostnaam en installatielocatie enzo:
<pre>
<VirtualHost *>
ServerName boom-debug.a-eskwadraat.nl

WSGIDaemonProcess whoswhopy user=apache group=apache threads=5 python-home=/usr/local/venvs/empty
WSGIScriptAlias / /mnt/wwwdebug2/lidanoniem/wwwdebug/whoswhopy.wsgi

<Directory /mnt/wwwdebug2/lidanoniem/wwwdebug>
WSGIProcessGroup whoswhopy
Order deny,allow
Allow from all
</Directory>
</VirtualHost>
</pre>

Herstart Apache nogmaals:
<pre>
sudo service httpd restart
</pre>

En nu zou het moeten werken :D

Webcie-vm

2019-03-06T14:58:55Z

2019-02-27T21:57:34Z

Timb: Deze hele sectie is overbodig met het nieuwe configbestand. /* Je eerste commit doen */

Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:

== Bestuur ==

#Toevoegen aan 'webcie' (inloggen op de server en bij de repo)

== Webcie ==

Ga naar de [[vm-www-debug]] en log in als user webcie:
ssh vm-www-debug
sudo -i -u webcie

Toevoegen aan de htpasswd:
htpasswd /srv/htpasswd $USER
Toevoegen aan de htgroups
vim /srv/config/vm-www-debug/httpd/conf.d/htgroups
vim /srv/config/vm-www/httpd/conf.d/htgroups
Toevoegen aan de <code>wwwdebug.conf</code>
cd /srv/http/www/git
vim config.yaml
Op dit punt moet je even een WebCie'er laten weten dat je jezelf een debug aan het geven bent. Die zal jou vertellen wat er ingevuld moet worden om jouw eigen debugomgeving op te zetten.
source venv/bin/activate
./scripts/debugconfig.py
git add -p
git commit
git push
sudo service httpd restart
Toevoegen aan de git repo
Vraag aan een momenteel webcie lid om dit te doen

== Nieuw lid ==

Als eerste ga je de code van de website binnenhalen en je eigen debugomgeving aanmaken. Dit doe je door de volgende commando's in een terminal te draaien:

(Weet je niet hoe je een 'terminal' moet openen? Vraag een medewebcieër!)

cd /mnt/wwwdebug2
mkdir $USER/
cd $USER
git clone https://gitlab.com/iba-aes/webcie/website.git wwwdebug
cd wwwdebug/www
./manage build --enable-debug --hostname=DEBUGNAAM-debug.a-eskwadraat.nl
ln -s /mnt/wwwdebug2/$USER/wwwdebug/ ~/wwwdebug

(Hier moet je <code>DEBUGNAAM</code> vervangen met de naam van je debugomgeving, bijvoorbeeld 'pepernoot' of 'comint'.)

Dit zorgt ervoor dat de code die in de map <code>~/wwwdebug</code> staat wordt uitgevoerd wanneer je naar <code>DEBUGNAAM-debug.a-eskwadraat.nl</code> gaat in je browser.

[[Category:WebCie]]
[[Category:HowTo]]

Nieuw WWW-lid

2019-02-27T21:56:58Z

Timb: /* Webcie */

Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:

== Bestuur ==

#Toevoegen aan 'webcie' (inloggen op de server en bij de repo)

== Webcie ==

Ga naar de [[vm-www-debug]] en log in als user webcie:
ssh vm-www-debug
sudo -i -u webcie

Toevoegen aan de htpasswd:
htpasswd /srv/htpasswd $USER
Toevoegen aan de htgroups
vim /srv/config/vm-www-debug/httpd/conf.d/htgroups
vim /srv/config/vm-www/httpd/conf.d/htgroups
Toevoegen aan de <code>wwwdebug.conf</code>
cd /srv/http/www/git
vim config.yaml
Op dit punt moet je even een WebCie'er laten weten dat je jezelf een debug aan het geven bent. Die zal jou vertellen wat er ingevuld moet worden om jouw eigen debugomgeving op te zetten.
source venv/bin/activate
./scripts/debugconfig.py
git add -p
git commit
git push
sudo service httpd restart
Toevoegen aan de git repo
Vraag aan een momenteel webcie lid om dit te doen

== Nieuw lid ==

Als eerste ga je de code van de website binnenhalen en je eigen debugomgeving aanmaken. Dit doe je door de volgende commando's in een terminal te draaien:

(Weet je niet hoe je een 'terminal' moet openen? Vraag een medewebcieër!)

cd /mnt/wwwdebug2
mkdir $USER/
cd $USER
git clone https://gitlab.com/iba-aes/webcie/website.git wwwdebug
cd wwwdebug/www
./manage build --enable-debug --hostname=DEBUGNAAM-debug.a-eskwadraat.nl
ln -s /mnt/wwwdebug2/$USER/wwwdebug/ ~/wwwdebug

(Hier moet je <code>DEBUGNAAM</code> vervangen met de naam van je debugomgeving, bijvoorbeeld 'pepernoot' of 'comint'.)

Dit zorgt ervoor dat de code die in de map <code>~/wwwdebug</code> staat wordt uitgevoerd wanneer je naar <code>DEBUGNAAM-debug.a-eskwadraat.nl</code> gaat in je browser.

=== Je eerste commit doen ===

In de root van je website (dat is de map ~/wwwdebug/www/ dus doe als je daar nog niet in zit <code>cd ~/wwwdebug/www/</code>) staat de map space/auth/ met daarin het bestand init.php. Voeg jezelf hier toe bij de $GODNRS. Om dit bestand vervolgens te committen doe je
git commit space/auth/init.php
Vervolgens moet je het bestand pushen zodat de rest van de webcieërs het binnen kunnen halen
git push

[[Category:WebCie]]
[[Category:HowTo]]

PHP-extensies

2019-02-27T21:04:52Z

Timb:

PHP-extensies kun je ook in composer.json configureren!

De volgende extensies stonden op 2019-02-27 aan op de vm-www2:

* php-json
* php-pecl-mcrypt
* php-bcmath
* php-cli
* php-fpm
* php-gd
* php-imap
* php-ldap
* php-mbstring
* php-mysqlnd
* php-pdo
* php-pecl-apcu
* php-pecl-zip
* php-process
* php-tidy
* php-xml
* php-pecl-yaml

== APCU ==

Iets met caching.

<code>yum install php-pecl-apcu</code>

== DOM ==

<code>yum install php-dom</code>

== IMAP ==

We gebruiken de IMAP extensie voor functies als <code>imap_mime_header_decode</code> binnen het <code>mail_process_bug.2</code> script.

Om het te installeren moet je eerst <code>sudo yum install php-imap</code> draaien op een CentOS systeem. Daarna, moet je apache herstarten: <code>sudo service httpd restart</code>.

== LDAP ==

Voor het SysteemAPI: <code>yum install php-ldap</code>

== MB ==

<code>yum install php-mbstring</code>

== MCrypt ==

<code>yum install php-mcrypt</code>

== PDO ==

Een OO'e manier om Databases in PHP te krijgen. We hebben ook de mysql-specifieke drivers nodig.

<code>yum install php-pdo php-mysql</code>

== XDebug ==

We gebruiken de extensie XDebug voor code coverage. Deze is alleen op <code>vm-www-debug</code> geïnstalleerd omdat het renderen best wel traag maakt.

== YAML ==

We gebruiken YAML om configuratiebestanden uit te lezen.

[[Category:WebCie]]

Databasestructuur committen

2019-02-11T10:44:17Z

Timb: Geef de hint dat wijzigingen via migraties zouden moeten gebeuren.

Zie [[WebCie Databases]] voor algemene info over de databazen.

'''WebCie TopTip:''' Om de structuur van de database te wijzigen, kun je het beste [[databasemigraties]] gebruiken. Deze houden de wijziging in de code en wijziging in de databasestructuur bij elkaar.

== Committen ==
Als je iets hebt aangepast in de database, moet je dit officieel maken door het te committen. Anders krijg je het volgende bericht regelmatig toegemaild: <code>De structuur van de database is veranderd. Commit dit ajb zsm.</code>

Om je aanpassingen te committen, doe je het volgende:

#ssh vm-www
#s webcie
#cd /srv/http/www/scripts/cron
#./dump_database_struct.sh
#cd ../
#Check databasecontent.mysql.sql, gewoon met <code>git diff</code>. Als dit klopt commit het dan. (Denk eraan om toe te voegen dat jij het hebt gecommit via "Committer: naam")

[[Category:WebCie]]
[[Category:HowTo]]

Databasemigraties

2019-02-11T10:41:17Z

Timb: Redirected page to WebCie Databases#Databasestructuur aanpassen

#REDIRECT [[WebCie_Databases#Databasestructuur_aanpassen]]

[[Category:WebCie]] [[Category:HowTo]]

Uitgebreid Zoeken

2019-02-08T12:47:56Z

Timb: /* Itemsoorten */

[[Category:WebCie]]

In het nieuwe Uitgebreid Zoeken kunnen gebruikers hun eigen kwerries samenstellen door sleuren en pleuren. Dit wordt dan op de server omgezet tot een SQL-query, die op de database uitgevoerd wordt, en waarvoor vervolgens de juiste weergave gekozen wordt. De zoekkwerrie wordt overgestuurd als een JSON-object, als een soort fancy s-expressie.

== Front-end: sleuren en pleuren ==

We gebruiken de Javascriptlibrary [https://github.com/stevendwood/html5-dropzone HTML5 Dropzone], die een fijne wrapper geeft om de sleur-en-pleurfunctionaliteit in HTML5. Je hebt hier een niet al te antieke browser voor nodig dus.
Voor elk soort item die de gebruiker in de query kan doen, maken we een template aan (iets met class "zoek-item"), die de gebruiker kan kopiëren naar gaten (iets met class "zoek-gat") in de query. Deze gaten worden dan gevuld met (maar niet vervangen door) kopietjes van dit item. In dit item mogen ook weer gaten voorkomen, bijvoorbeeld voor de "EN"- en "OF"-operatoren.
Omdat we gaten niet vervangen, hebben we ook replacement-functionaliteit: wil je een item vervangen met een ander item, dan pleur je het nieuwe item over het andere item heen. De eventhandlers van het gat zorgen ervoor dat de vervanging goedgaat.
De hele state van de query wordt in de structuur van de html-elementen opgeslagen, zodat er niets gedesynct wordt. Een nadeel is dat je niet al te veel fancy's kunt doen met de opmaak, want we gaan ervan uit dat de kwerrie eruit ziet als een <code>.zoek-gat</code>-element met als (direct) kind precies 1 <code>.zoek-root</code>-element, met als (direct) kind een aantal <code>.zoek-gat</code>-elementen, etc. In feite is de hele structuur niets meer dan een s-expressie met pretentie.

De notatie die we nu gaan aanhouden: als je een item hebt met een paar (oningevulde) gaten, schrijven we die op als <code>(zoektype ? ? ... ?)</code>, en als er een paar gaten zijn ingevuld, wordt het bijvoorbeeld <code>(en (of (vakid) ?) (niet (actief)))</code>

Op dit moment werkt het verplaatsen van al geplaatste items nog niet heel netjes: bij het pleuren wordt namelijk alleen een nieuw item gemaakt van de wortel van hetgeen wat je sleept. Een kopie van <code>(en (vakid) (actief))</code> ziet er dus uit als <code>(en ? ?)</code>, niet <code>(en (vakid) (actief))</code>.

Om formvelden binnen items te ondersteunen (denk aan "lid sinds <datum>"), kunnen items ook een dict attrs van extra waarden, naast de invulling van gaten, meedragen. In de HTML worden deze weergegeven als attributen van de vorm <code>data-zoek-*</code>, zodat <code>data-zoek-bla</code> overeenkomt met een key <code>bla</code> in de attrs. Je moet in Javascript ervoor zorgen dat deze bij elke update van het formveld dit in de attributen geupdate wordt.

== Serialisatie ==

Als de gebruiker vervolgens op de zoekknop drukt, wordt een geserialiseerde kwerrie opgestuurd. Op basis van de HTML wordt een JSON-object gemaakt dat de zoekkwerrie encodeert. Omdat de structuur om en om bestaat uit gat met misschien een item, en item met een lijst gaten, doen we ook twee serialisatiestappen in mutuele recursie. Een gat serialiseert tot ofwel de serialisatie van het item dat erinzit, ofwel <code>null</code>. Een item serialiseert tot een JSON-object van de vorm <code>{'head': ... , 'tail': ... , 'attrs': ...}</code>. De head is het zoektype van dit item (<code>'en'</code> voor de logische conjunctieoperator, <code>'vakid'</code>, etc.), de tail is een lijst van alle (geserialiseerde) gaten van dit item (inclusief <code>null</code> voor oningevulde!), en de attrs zijn een dict met strings, de extra attributen (zoals de waarden van inputs in dit zoekitem).

Zo wordt bijvoorbeeld de s-expressie:

<code><pre>(of (vakid) (en (actiefCie) (niet (actiefAlles))))</pre></code>

geserialiseerd naar:

<code><pre>{"head":"of","tail":[{"head":"vakid","tail":[],"attrs":{}},{"head":"en","tail":[{"head":"actiefCie","tail":[],"attrs":{}},{"head":"niet","tail":[{"head":"actiefAlles","tail":[],"attrs":{}}],"attrs":{}}],"attrs":{}}],"attrs":{}}</pre></code>

TODO: voorbeeld met attributen

== Itemsoorten ==

De volgende itemsoorten worden ondersteund:

{| class="wikitable sortable"
! Zoektype !! Gaten !! Attributen !! Betekenis
|-
| en || 2 || {} || conjunctie: ('''en''' ''l'' ''r'') bestaat uit de doorsnede van iedereen in ''l'' en iedereen in ''r''
|-
| of || 2 || {} || disjunctie: ('''of''' ''l'' ''r'') bestaat uit de vereniging van iedereen in ''l'' met iedereen in ''r''
|-
| niet || 1 || {} || negatie: ('''niet''' ''q'') bestaat uit iedereen die niet in ''q'' zit
|-
| lidtoestand || 0 || {'toestand': ...} || lidtoestand komt overeen met <code>attrs.toestand</code>: 'lid': "gewoon" huidig lid of BAL; 'oudlid': vroeger, maar niet meer, lid; 'bijnalid': heeft zich ingeschreven voor de intro maar is nog niet lid geworden; 'bal': Bijzonder Actief Lid (staat bij huidige leden, niet bij oudleden); 'erelid': erelid (staat niet bij huidige leden); 'verdienste': lid van verdienste (staat niet bij huidige leden).
|-
| studeert || 0 || {'studie': ...} || doet op dit moment de gegeven studie. <code>attrs.studie</code> is het ID van een Studie-object in de database.
|-
| studeerde || 0 || {'studie': ...} || studeerde vroeger, niet meer, de gegeven studie. Zie '''studeert''' voor info over <code>attrs.studie</code>.
|-
| studieOnbekend || 0 || {} || geen studiegegevens bekend
|-
| vakidPost || 0 || {} || heeft aangegeven de Vakidioot per post te willen ontvangen
|-
| aesRoots || 0 || {} || heeft aangegeven de A–Eskwadraat√roots te willen ontvangen
|-
| actiefCie || 0 || {} || is actief in een commissie
|-
| actiefAlles || 0 || {} || is actief in een commissie, groep of dispuut
|-
| actiefRecent || 0 || {} || is, of was afgelopen jaar, actief in een commissie, groep of dispuut
|-
| deelnemer || 0 || {} || staat bij de deelnemers voor een activiteit afgelopen jaar
|-
| adresBekend || 0 || {} || adres bekend in de database
|-
| emailBekend || 0 || {} || email bekend in de database
|-
| donateur || 0 || {} || is op dit moment donateur
|-
| donateurGeweest || 0 || {} || was donateur maar nu niet meer
|-
| afgestudeerd || 0 || {'coljaar': ...} || afgestudeerd in <code>attrs.coljaar</code>. Collegejaren worden gegeven als string van het jaar waarin ze beginnen, dus '2017' is 3 sept 2017 - 3 sept 2018.
|-
| almaOK || 0 || {} || willen opgenomen worden in de almanak
|-
| geluksvogel || 0 || {} || jonger dan 18 jaar
|-
| kart || 0 || {} || zit in de kart van de gebruiker
|-
| lidVan || 0 || {'coljaar': ...} || lid geworden in <code>attrs.coljaar</code>. Collegejaren worden gegeven als string van het jaar waarin ze beginnen, dus '2017' is 3 sept 2017 - 3 sept 2018.
|-
| lidTot || 0 || {'coljaar': ...} || lid-af in <code>attrs.coljaar</code>. Collegejaren worden gegeven als string van het jaar waarin ze beginnen, dus '2017' is 3 sept 2017 - 3 sept 2018.
|-
| voornaamwoord || 0 || {'voornaamwoordID': ...} || gebruikt persoonlijk voornaamwoord met ID <code>attrs.voornaamwoordID</code>.
|-
| bounces || 0 || {} || heeft bounces: e-mails die door de site zijn verstuurd maar niet zijn aangekomen
|}

Uitgebreid Zoeken

2019-02-08T12:05:32Z

Timb: /* Serialisatie */

2018-10-05T18:37:08Z

Timb:

Wat je moet doen voor een nieuw lid van de [[WebCie|www]]:

== Bestuur ==

#Toevoegen aan 'webcie' (inloggen op de server en bij de repo)

== Webcie ==

Ga naar de [[vm-www-debug]] en log in als user webcie:
ssh vm-www-debug
sudo -i -u webcie

Toevoegen aan de htpasswd:
htpasswd /srv/htpasswd $USER
Toevoegen aan de htgroups
vim /srv/config/vm-www-debug/httpd/conf.d/htgroups
vim /srv/config/vm-www/httpd/conf.d/htgroups
Toevoegen aan de wwwdebug.conf
cd /srv/http/www/git
vim webcie_leden.sh
Zet in dit bestand de lidnaam, debugnaam, en het pad waar de debugomgeving terechtkomt. Weet je niet wat hier moet staan? Doe dan <code>$USER $bla /mnt/wwwdebug2</code>.
./webcie_leden.sh
git add -p
git commit
git push
sudo service httpd restart
Toevoegen aan de git repo
Vraag aan een momenteel webcie lid om dit te doen

== Nieuw lid ==

Als eerste ga je de code van de website binnenhalen en je eigen debugomgeving aanmaken. Dit doe je door de volgende commando's in een terminal te draaien:

(Weet je niet hoe je een 'terminal' moet openen? Vraag een medewebcieër!)

cd /mnt/wwwdebug2
mkdir $USER/
cd $USER
git clone https://gitlab.com/iba-aes/webcie/website.git wwwdebug
cd wwwdebug/www
./manage build --enable-debug --hostname=DEBUGNAAM-debug.a-eskwadraat.nl
ln -s /mnt/wwwdebug2/$USER/wwwdebug/ ~/wwwdebug

(Hier moet je <code>DEBUGNAAM</code> vervangen met de naam van je debugomgeving, bijvoorbeeld 'pepernoot' of 'comint'.)

Dit zorgt ervoor dat de code die in de map <code>~/wwwdebug</code> staat wordt uitgevoerd wanneer je naar <code>DEBUGNAAM-debug.a-eskwadraat.nl</code> gaat in je browser.

=== Je eerste commit doen ===

In de root van je website (dat is de map ~/wwwdebug/www/ dus doe als je daar nog niet in zit <code>cd ~/wwwdebug/www/</code>) staat de map space/auth/ met daarin het bestand init.php. Voeg jezelf hier toe bij de $GODNRS. Om dit bestand vervolgens te committen doe je
git commit space/auth/init.php
Vervolgens moet je het bestand pushen zodat de rest van de webcieërs het binnen kunnen halen
git push

[[Category:WebCie]]
[[Category:HowTo]]

Mail sturen naar de site

2018-10-01T09:02:04Z

Timb:

Mailen naar de site werkt ongeveer zo: de [[Sysop]] zorgt ervoor op [[Ernst]] dat de juiste e-mailadressen@a-eskwadraat.nl naar de [[WebCie VM]] geleid worden, en dan zal op de VM de MTA (dit is postfix of exim ofzo) het juiste script aanroepen, zoals <code>scripts/mail_process_bug_vm-www</code>.

== Mail naar de site testen ==

Stel dat je een scriptje wil testen dat reageert op mails, zoals <code>mail_process_bug_vm-www</code>. Dan heb je het scriptje <code>schrijf_test_mail.php</code> dat je helpt om een voorbeeldmail te genereren. Bijvoorbeeld:

<pre>
$ ssh vm-www-debug
$ cd wwwdebug/scripts
$ ./schrijf_test_mail.php | ./mail_process_bug_vm-www
From? timb@a-es2.nl
To? bug7132@a-eskwadraat.nl
Subject? UTF-8 testing
Body? (Ctrl-D om te stoppen)
Hoi ik ben een test ☺
Jammer genoeg gaat UTF-8 stuk ☹
</pre>

[[Category:WebCie]]
[[Category:HowTo]]

PHP-extensies

2018-09-20T17:25:35Z

Timb:

PHP-extensies kun je ook in composer.json configureren!

== APCU ==

Iets met caching.

<code>yum install php-pecl-apcu</code>

== DOM ==

<code>yum install php-dom</code>

== IMAP ==

We gebruiken de IMAP extensie voor functies als <code>imap_mime_header_decode</code> binnen het <code>mail_process_bug.2</code> script.

Om het te installeren moet je eerst <code>sudo yum install php-imap</code> draaien op een CentOS systeem. Daarna, moet je apache herstarten: <code>sudo service httpd restart</code>.

== LDAP ==

Voor het SysteemAPI: <code>yum install php-ldap</code>

== MB ==

<code>yum install php-mbstring</code>

== MCrypt ==

<code>yum install php-mcrypt</code>

== PDO ==

Een OO'e manier om Databases in PHP te krijgen. We hebben ook de mysql-specifieke drivers nodig.

<code>yum install php-pdo php-mysql</code>

== XDebug ==

We gebruiken de extensie XDebug voor code coverage. Deze is alleen op <code>vm-www-debug</code> geïnstalleerd omdat het renderen best wel traag maakt.

[[Category:WebCie]]