Kapitel 22. Die lokale Installation - Q. Desktop

Die aktuellen Versionen von Q. Desktop und Q. Android stehen als sich automatisch installierende Archive unter http://www.gessgroup.de/qdownload frei zur Verfügung. Analog zur Datei GESS_Q_xxx_Setup.exe bietet die Seite für Android eine .apk Datei, um die Software auf einem Tablet/Smartphone installieren zu können. An dieser Stelle sei aber auf Kapitel 24, Die Android App - Q. Android verwiesen, das sich mit der Konfiguration von Android Geräten und speziellen Funktionalitäten von Q. Android beschäftigt. Die Installation unter Windows lässt sich einfach bewerkstelligen, indem man den Anweisungen des Setups folgt. Im Zweifel hilft aber auch ein Video im Youtube Channel von GESS Software.

Damit Q. Desktop auf dem Rechner läuft, muss eine Java 8 Laufzeitumgebung^[12] auf dem PC installiert sein. Sie können überprüfen, ob Java installiert ist bzw. ob das System die Java-Installation findet, indem sie in einer Eingabeaufforderung (cmd.exe) bzw. Kommandozeile den Befehl

java -version

eingeben. Kennt Ihr Betriebssystem den Javabefehl, wird eine entsprechende Versionsinformation zurückgeliefert. Sollte keine Java RE installiert sein, können Sie die aktuellste auf www.java.com/de/download/ herunterladen.

Vorhandene Q.-Installationen können mit neueren Setup-Programmen einfach überschrieben werden. Studien, Daten und nutzerspezifische Einstellungen bleiben dabei erhalten.

Mit Java Version 8 kann es unter Linux dazu kommen, dass sich Q. Desktop nicht starten lässt. Der automatische Aufruf des Browsers geht schief und daraufhin beendet sich das Programm wieder. Das Verhalten wird durch einen Fehler in Java verursacht. Mit dem Anlegen der Datei noautostart.txt in dem Verzeichnis, in dem Verzeichnis, in dem auch startcapi.bat liegt, startet Q. den Browser nicht mehr automatisch. Die Adresse http://localhost:8080, unter der Q. Desktop läuft, kann man dann per Hand eingeben.

Eine Serverinstallation benötigt neben Java zusätzlich einen Application Server wie JBoss oder Tomcat, der GESS Q. als Webservice bereitstellt. Zur vollen Unterstützung von internationalen Studien und Zeichensätzen wie Kyrillisch oder Chinesisch, muss der Application Server so konfiguriert sein, dass alle Requests und Responses als UTF-8 interpretiert bzw. codiert werden. Q. Server wird in diesem Rahmen üblicherweise als Web-Archiv (.war) im Application Server untergebracht. Rund um den Server leistet GESS selbstredend jegliche Art von Service: Bereitstellung, Installation, Wartung, ...

GESS Q. arbeitet dateibasiert mit größtenteils menschenleserlichen Inhalten in den Dateien ohne Notwendigkeit einer Datenbank. Dies bringt den Vorteil mit sich, jederzeit »einfach in eine Datei reingucken« zu können ohne auf Zusatzprogramme angewiesen zu sein. Unter Android gibt es bisher keinen Anlass von der Standardstruktur abzuweichen, bei Q. Server und Q. Desktop kann es abhängig vom Arbeitsumfeld aber sinnvoll sein, individuelle Anpassungen vorzunehmen. Während ein Selbständiger möglicherweise gut mit einer unabhängigen Einzelplatzinstallation zurecht kommt, haben Betriebe mit vielen Anwendern, die womöglich auch gleichzeitig am selben Projekt arbeiten, das Bedürfnis, die Studien zentral abzulegen, damit sie für alle Beteiligten erreichbar sind. „Konfigurationsdatei qonline.cfg“ und „Einrichtungsbeispiele und Projektverwaltung mit Q. Desktop“ beschreiben unter anderem die Stellschrauben, an denen hier angesetzt werden kann und stellen drei typische Szenarien vor.

Auf den ersten Blick erscheint es eventuell merkwürdig, dass ein Q. Projekt zwangsweise in ein Projekt- und ein Medienverzeichnis getrennt ist. Hierzu eine kurze Erklärung: Als Onlinebefragung muss ein Fragebogen vom Webbrowser dargestellt werden. Während Q. den eigentlichen Content der Seite Screen für Screen ausgibt, müssen die Mediendateien (Bilder, Videos, Anwendungen) für den Browser (und damit öffentlich) zugänglich sein. Jede Mediendatei ist damit direkt über eine bestimmte Web-Adresse erreichbar. Dies ist für alle anderen studienrelevanten Informationen wie z.B. dem Q. Skript, Quotenständen, Logfiles oder zugelassenen IDs aber explizit nicht gewünscht. Während der Medienpfad auf dem Server also in einem öffentlichen Bereich liegt, sind sämtliche anderen Teile von Außen unzugänglich.

Nach der Installation und ohne Änderungen der Konfiguration erwartet GESS Q. unterhalb des Installationsverzeichnisses folgende Struktur:

Im Installationsverzeichnis liegen die Java-Dateien für das Programm GESS Q. Desktop und die Dateien, mit denen sich das Programm starten lässt: für Windows startcapi.bat, für Linux startcapi.sh. Konfigurationsdateien liegen im Verzeichnis config. Dateien, die für den Betrieb auf einem Webserver öffentlich sein müssen, liegen unter root. Die Skripte, die einen Fragebogen ausmachen, liegen pro Studie (hier durch den Platzhalter [fragebogen] gekennzeichnet) in einem eigenen Verzeichnis unter surveys. Das Fragebogenverzeichnis selbst muss mit text und kann mit gtc weitere Unterverzeichnisse enthalten. Im Verzeichnis text sucht GESS Q. nach der Datei skript.q, die als Ausgangspunkt für einen Fragebogen dient. Das Verzeichnis gtc enthält Steuerungsdateien für GESStabs, wenn das Programm für die Ausgabe von Tabellen eingebunden ist.

Grundsätzliche Einstellungen im Umgang mit Projekten und laufenden Interviews können in der Konfigurationsdatei vorgenommen werden. Sie heißt standardmäßg qonline.cfg und befindet sich im Ordner config des Installationsverzeichnisses. Auch der Pfad und Name dieses Ordners kann zumindest für Q. Desktop und Q. Server theoretisch modifiziert werden. Er wird als Startparameter für die entsprechende Webanwendung übergeben. Die Konfigurationsdatei wird einmalig beim Programmstart geladen. Änderungen erfordern also immer einen Neustart der Q. Applikation.

Nach der beispielhaften, vollständigen Darstellung einer Konfigurationsdatei werden die enthaltenen Parameter einzeln erläutert. Die mit einem Sternchen markierten Parameter sind für die grundsätzliche Programmfunktion zwingend notwendig.

adbApp=config/adb/adb.exe
archivePath=archive
backupPath=backup
docPath=doc
documentRoot=root
gtcApp=C:/Program Files/GESStabs/GTC.exe
logRequests=false
maxIdleSeconds=20
maxMemoryLoad=80
mediaRoot=root/media
method=GET
modelPath=models
presetDataPath=preset
surveyPath=surveys
timeOutCheckInterval=20
URLName=SurveyServlet
jdbcDriver=org.postgresql.Driver
jdbcUrl=jdbc:postgresql://localhost:5432/translation
jdbcUser=qdot
jdbcPassword=XpAssWoRdY
jdbcDropAndCreateTables=false
        

Im Verzeichnis config, das GESS Q. im »documentRoot« erwartet, liegt auch die Datei users.lst. Die Datei enthält pro Zeile ein Nutzerkonto, das durch fünf Felder festgelegt wird:

id=demo;company=GESS;name=demo;password=omed;access=full
      

Die Einträge können zwar per Hand eingefügt werden, aber die Server-Oberfläche hält im Bereich »Main« unter »Users« auch einen Menüpunkt bereit, über den sich die Datei users.lst editieren lässt. Da der Rollenname in der Datei von der Bezeichnung der Rollen abweicht, dürfte es praktischer sein, die Web-Oberfläche zu nutzen. Bei dieser Gelegenheit trägt der Server dann auch nur den Hash eines Passworts ein.

Rollen lassen sich grob in zwei Gruppen unterteilen: »Admin« und »Regular User« eignen sich für Nutzer die Studien verwalten oder skripten. Die verschiedenen Kombinationen aus Reporting, Datenexport, Datenbearbeitung und Quotenkorrekturen sind dagegen eher für Kunden gedacht, die eine laufende Studie begleiten.

Die übrigen Rollen Rep + Exp + Data (rep_export_data), Rep + Exp + Quota> (rep_export_quota), Rep + Data + Quota> (rep_data_quota), Rep + Exp + Data + Quota> (rep_export_data_quota) bieten unterschiedliche Kombinationen der verschiedenen Zugriffsrechte.

Das Gegenstück zu den in users.lst allgemein festgelegten Zugriffsrechten bildet auf der Ebene der einzelnen Studie die Datei access.lst. Sie liegt direkt im Fragebogenverzeichnis. In ihr sind zeilenweise die IDs der Nutzer vermerkt, die auf die Studie zugreifen dürfen. Die Zugriffsrechte werden dabei durch die dem Nutzer in der Datei users.lst zugeordnete Rolle bestimmt. Damit also der Nutzer demo auf eine Studie zugreifen darf, muss die dazu gehörige Datei access.lst den Eintrag

demo
    

enthalten. Die Web-Oberfläche von Q. ermöglicht die Verwaltung der Datei (s. „User assignment - Nutzerkonten“).

Im Konfigurationsverzeichnis hinterlegt Q. eine Datei namens blacklist.txt, die alle von GESStabs reservierten Schlüsselwörter aufführt und nicht in einem Fragebogen verwendet sollten um die weitere Verarbeitung der Daten nicht zu erschweren. Der Blacklist können auch eigene Schlüsselwörter hinzugefügt werden.

GESS Q. unterstützt die Trennung von Entwicklungs- und Live-Systemen. Um einen fertigen Fragebogen vom Entwicklungssystem auf einen Server für die Befragung zu kopieren, bietet die Web-Oberfläche Q. Admin unter »Surveys« den Punkt »Upload«. Die Server-Liste im Ausklappmenü bezieht GESS Q. aus der Datei server.lst. Sie enthält pro Zeile einen Eintrag für einen Server in Form einer URL unter der die GESS Q.-Installation erreichbar ist:

https://test1.domain.de/SurveyServlet
http://test2.domain.de/SurveyServlet
  

Es gibt zwei Wege eine Q.Version zu lizenzieren: Manuell im Dateisystem oder über die Benutzeroberfläche. Allgemein ist zu beachten, dass nur eine Q.Desktop Version parallel betreibbar ist, da diese sich sonst gegenseitig die Lizenz entziehen. Außerdem erkennt der Lizenzschlüssel nicht den PC wieder, sodass jede Neulizenzierung als Neufreischaltung gezählt wird.

Lizenzierung im Dateisystem

Im Ordner config des Installationsverzeichnisses muss die von GESS zugeschickte key.lic-Datei abgespeichert werden.

Abbildung 22.1. Verzeichnis - Einbinden des Lizenzschlüssels

Wenn Q. das nächste mal gestartet wird, überprüft es automatisch die Gültigkeit des Lizenzcodes, generiert eine check.lic-Datei und lässt die key.lic verschwinden.

Lizenzierung in der Benutzeroberfläche

Über die Benutzeroberfläche kann Q. durch Klicken auf das Schloss lizenziert werden. Es öffnet sich eine neue Ebene, in die der vollständige Lizenzcode eingetragen werden soll.

Abbildung 22.2. Oberfläche - Öffnen und Einbinden des Lizenzschlüssels

Anschließend wird aus dem roten ein grünes Schloss. Zusätzlich wird der Firmenname, die Restdauer und eine eindeutige ID innerhalb der Lizenz ausgespielt. Sollte der Lizenzcode sich ändern, kann dieser über einen Klick auf das (grüne) Schloss eingeben werden.

Unter Windows einfach setup.exe ausführen und in das Verzeichnis der bestehenden Installation installieren/überschreiben. Individuelle Einstellungen (Benutzer, Serverliste, config, Studien, ...) bleiben erhalten.