doc: Add installation procedure

1 files changed, 59 insertions, 0 deletions

diff --git a/doc/documentation.txt b/doc/documentation.txt
index a9deb2e..8229136 100644
--- a/doc/documentation.txt
+++ b/doc/documentation.txt
@@ -226,6 +226,65 @@ Vergleich eher nebensaechlich zubetrachten ist, stellt sich diese Loesung am
 geeignetsten fuer das Problem der Benutzertrennung unter den aktuellen
 Umstaenden da.
 
+== Installation
+
+Das Modul verzeichnis (sqlbox/ im Projektordner) muss zunächst auf den Server
+in das mod Verzeichnis der Moodle-Installation kopiert werden:
+
+[source,sh]
+----
+cp -R sqlbox/ /path/to/moodle/htdocs/mod/
+
+----
+
+Es sollte im weiteren eine Datenbank für die Tests und dazugehörige Nutzer
+angelegt werden:
+
+[source,sh]
+----
+su - postgres
+# Read-Write Nutzer: sqlbox
+psql -c "create user sqlbox createdb;" template1
+psql -c "alter user sqlbox with encrypted password 'sqlbox_pw';" template1
+
+# Read-Only Nutzer: sqlbox_read
+psql -c "create user sqlbox_read;" template1
+psql -c "alter user sqlbox_read with encrypted password 'sqlbox_pw';" template1
+
+# Datenbank: sqlbox
+psql -c "create database sqlbox with encoding 'unicode';" -U sqlbox template1
+psql -c "alter user sqlbox nocreatedb;" template1
+
+# Leserechte für sqlbox vergeben
+psql -c "grant select on all tables in schema public to sqlbox_read;" sqlbox
+
+# Reload Postgresql, e.g:
+/etc/init.d/postgresql-X.Y reload
+----
+
+Die KAPV-Datenbasis kann über die im Projekt enthaltenen Schemata
+und Daten erreicht, diese sind in separaten SQL-Datein abgespeichert:
+
+[source,sh]
+----
+psql -f oracle-conversion/kapv-schema.sql sqlbox
+psql -f oracle-conversion/kapv.sql sqlbox
+----
+
+Nun kann in Moodle Die Konfiguration des Plugins vorgenommen.
+Als Administration wird die Datenbankkonfiguration über:
++Einstellungen->Website-Administration->Plugins->Aktivitäten->sqlbox+ erreicht.
+Hier müssen Hostname, Datenbank, Nutzer und Passwort entsprechend der zuvor
+getätigten Konfiguration eingetragen werden.
+
+In dem Kurs, in dem die Tests aufgeführt werden sollen, muss nun die
+Edititierung über +Einstellungen->Kurs-Administration->Bearbeiten einschalten+
+aktiviert werden, sodass unterhalb jeder Sektion die Möglichkeit eingeblendet
+wird, eine Aktivität anzulegen.
+In der Aktivitätsliste wird SQLBox gewählt und eine Aufgabe mit Beschreibung und
+Referenz-Abfrage angelegt. Dieser Prozess wiederholt sich für jede zu
+stellendene Aufgabe.
+
 == Literatur
 
 * Nils Weber, Diplomarbeit