Installation von kritikom

Systemvoraussetzungen

Bei dieser Software handelt es sich um eine reine Web-Anwendung, welche als Infrastruktur einen Apache Tomcat benötigt. Auf den Einzelplatz-Rechnern ist keine Installation nötig. Die Benutzer greifen einfach per Web-Browser auf die Anwendung zu.

Die Installation des Servers kann unter Windows- oder Linux-Systemen erfolgen. Wir empfehlen 2 GB Hauptspeicher und 20GB Plattenplatz falls die Datenbank auf dem gleichen Server installiert werden soll. Es kann allerdings auch schon auf bereits vorhandene Datenbanksysteme aufgesetzt werden.

Die Kommunikation der Clients mit dem Server läuft standardmäßig über das Protokoll http und den Port 8080. Der Port kann allerdings beliebig angepasst werden falls er schon belegt ist.

Übersicht der Installation

Für den Betrieb von kritikom sind folgende Komponenten nötig:

Diese Anleitung führt Sie Schritt für Schritt durch die Installation. Die Links für die benötigten Downloads finden Sie direkt in den entsprechenden Abschnitten. Lediglich Ihre Lizenzdatei erhalten Sie per Email.

Installation der Java Laufzeitumgebung

Für kritikom wird mindestens Java 7 benötigt.

Unter Windows

Um die aktuelle Java-Version für Ihr System herunter zu laden verwenden Sie am besten folgenden Link:

https://www.java.com/de/download/

Hier sollten Sie automatisch die aktuelle und zu Ihrem System passende Java-Version angeboten bekommen. Falls Sie den Download nicht von dem Rechner aus durchführen, auf dem kritikom  installiert werden soll verwenden Sie bitte folgenden Link und wählen die zum Ziel-System passende Version :

https://www.java.com/de/download/manual.jsp

Anschließend starten Sie bitte den Installer und folgen den angezeigten Anweisungen.

Unter Linux

Unter Linux empfielt es sich die passende JDK-Version einfach über den Packet-Manager Ihrer Linux-Distribution zu installieren und aktuell zu halten. Wir empfehlen mindestens Java 7 zu verwenden.

Installation des Apache Tomcat

Unter Windows

Um den aktuellen Tomcat 8.5 für Ihr System herunter zu laden verwenden Sie am besten folgenden Link:

https://tomcat.apache.org/download-80.cgi

Hier empfehlen wir die Variante " 32-bit/64-bit Windows Service Installer". Anschließend starten Sie bitte den Installer und folgen den Anweisungen. Falls kein weiter Webserver auf Port 80 läuft und die Anwendung nur im Intranet erreichbar sein soll, können Sie den Port im entsprechenden Feld des Installers von 8080 auf 80 ändern. Damit entfällt später die Angabe des Ports in der URL zum Aufruf der Anwendung im Webbrowser.

Bevor der Tomcat später gestartet wird, sollte noch der maximal für den Tomcat zur Verfügung stehende Speicher erhöht werden. Starten Sie dazu im Startmenü die Anwendung Monitor Tomcat. Es erscheint die Monitor-Anwendung in der Taskbar und Sie können über die rechte Maustaste den Punkt Configure auswählen. In dem nun erscheinenden Fenster wählen Sie den Reiter Java aus und tragen in das Feld Java-Optionen den Wert -Xmx512m ein.

Unter Linux

Unter Linux empfielt es sich den passenden Tomcat einfach über den Packet-Manager Ihrer Linux-Distribution zu installieren und aktuell zu halten. Voraussetzung ist aber ein Tomcat mindestens in Version 7!

Installation des DBMS und Anlegen einer Datenbank

Unter Windows

Falls Sie nicht auf ein bestehendes DBMS in Ihrem Haus aufsetzen möchten und Sie kein DBMS präferieren, empfehlen wir kritikom auf PostgreSQL aufzusetzen. Hiermit kennen wir uns am besten aus und können Sie bei Problemen kompetent unterstützen. Hier beschreiben wir lediglich die Installation und Einrichtung dieses Systems. Falls Sie ein anderes DBMS verwenden ist dort analog ein Benutzer kritikom und eine Datenbank kritikom anzulegen. Der Benutzer benötigt Rechte um DDL auf der Datenbank auzuführen.

Installation von PostgreSQL

Zunächst benötigen Sie den Installer für PostgreSQL - diesen erhalten Sie per Download:

http://www.enterprisedb.com/products-services-training/pgdownload#windows

Damit alles reibungslos funktioniert, empfehlen wir die Installation unter dem lokalen Administrator auszuführen. Wenn Sie als Domänen-Administrator angemeldet sind, wird wahrscheinlich die Installation abbrechen!

Der Installer führt Sie per Dialog durch die Installation. Bitte notieren Sie sich das Passwort, dass Sie für den Dienste-Benutzer postgres vergeben - Sie werden es später noch benötigen!

Bei der Abfrage, ob der Stack-Builder gestartet werden soll, entfernen Sie bitte den Haken und schließen die Installation ab.

Anlegen der Datenbank

In diesem Schritt wird lediglich ein Benutzer und eine Datenbank angelegt. Die benötigten Tabellen werden später durch die Installationsroutine von kritikom selbst angelegt.

Über das Startmenü können Sie nun die Anwendung PgAdminIII starten. Durch Doppelklick auf den (einzigen) Servereintrag postgres verbinden Sie sich mit dem DB-Server. Hier werden Sie nun nach dem Dienstepasswort gefragt welches Sie bei der Installation vergeben haben.

Über das Kontextmenü über dem Eintrag Benutzer wählen Sie bitte neuen Benutzer aus. In dem nun folgenden Dialog vergeben Sie bitte den Benutzernamen kritikom sowie ein Passwort für diesen Benutzer. Es handelt sich dabei um einen technischen DB-Benutzer unter welchem sich die Anwendung dann gegen die Datenbank verbindet. Die Anwender von kritikom benötigen keinen eigenen DB-Benutzer und werden später direkt in kritikom über ein entsprechendes Web-Formular angelegt.

Anschließend wird über das Kontextmenü des Eintrags Datenbanken der Punkt neue Datenbank ausgewählt. Als Datenbankname vergeben Sie hier bitte kritikom. Als Eigentümer wählen Sie einfach den im vorherigen Schritt angelegten Benutzer kritikom aus. Im 2. Reiter wählen Sie als Vorlage template0 aus und als Tablespace pg_default. Als Encoding sollte UTF-8 ausgewählt sein.

Unter Linux

Einrichten von PostgreSQL

Sie können die Konfiguration der Datenbank über die Kommandozeile vornehmen. Wird PostgreSQL über die Paketverwaltung installiert, dann stehen auch Kommandozeilentools zum Anlegen von Benutzern und einrichten von Datenbanken zur Verfügung.

Die Kommandos werden als Unix-Benutzer "postgres" ausgeführt. Damit erfolgt die Authentifizierung gegen PostgreSQL über diesen Unix-Benutzer, und ein Passwort ist nicht notwendig.

  • Benutzer anlegen (Benutzer kritikom, mit Passwort)
    sudo -u postgres createuser kritikom -P
  • Datenbank anlegen (DB "kritikom" für Owner "kritikom", mit UTF8)
    sudo -u postgres createdb -O kritikom -E UTF8 kritikom
  • Test
    psql -h localhost -d kritikom -U kritikom
    • Das Passwort wird abgefragt. -h localhost stellt sicher, dass die Anmeldung über TCP erfolgt. Dies ist der von kritikom benötigte Anmeldemechanismus.

Download von kritikom

Für das Deployment von kritikom  werden 4 Dateien von unserem Server sowie der zu Ihrem DBMS passende JDBC-Treiber benötigt.

kritikom.war

kritikom.properties

Um Ihnen die Arbeit zu erleichtern, bieten wie Ihnen hier für die gängingen Datanbank-Systeme vorbereitete Konfigurationsdateien sowie Links zu den korrekten JDBC-Treibern an:

PostgreSQL

kritikom.xml

kritikom_hibernate.cfg.xml

Den JDBC-Treiber für PostgreSQL finden Sie hier.

MySQL

kritikom.xml

kritikom_hibernate.cfg.xml

Den JDBC-Treiber zu MySQL finden Sie hier.

MS SQL Server

kritikom.xml

kritikom_hibernate.cfg.xml

Den JDBC-Treiber zum MS SQL Server finden Sie hier.

Deployment und Konfiguration von kritikom

Achten Sie bitte darauf, dass für diesen Schritt der Tomcat-Dienst nicht gestartet ist!

Zunächst müssen 5 Dateien an die richtigen Stellen in das Verzeichnis Ihrer Tomcat-Installation kopiert werden:

In der Datei conf/Catalina/localhost Ihrer Tomcat-Installation muss jetzt noch der Eintrag für "password" angepasst werden. Tragen Sie hier bitte das Passwort ein, welches Sie für den DB-Benutzer " kritikom" vergeben haben.

Jetzt kann der Tomcat Dienst gestartet werden. Falls Sie den Standard-Port des Tomcat nicht geändert haben, sollten sich folgende URLs (auf dem Server) direkt aufrufen lassen. Ansonsten ist natürlich die Port-Angabe der URLs entsprechend anzupassen.

Wenn der Dienst vollständig gestartet ist (das kann das erste Mal bis zu einer Minute dauern) kann die Installation durch Start der Installationsroutine über folgende URL fertig gestellt werden:

http://localhost:8080/kritikom/admin/CStart.do

Hier werden Sie nun aufgefordert Ihre Lizenzdatei in das System zu laden. Danach werden durch Klick auf den Button Datenbank initialisieren und anschließende Bestätigung alle benötigten Datenbank-Tabellen sowie ein initialer Benutzer angelegt.

Mit diesem Benutzer und dem angezeigten Passwort können Sie sich nun über folgende URL im Backend von kritikom anmelden:

http://localhost:8080/kritikom/team/CStart.do

Hier können nun weitere Benutzer, Meldekreise sowie die Stammdaten angelegt werden. Üblicherweise geschieht das im Rahmen einer entsprechenden Schulung durch Berater der GRB Gesellschaft für Risiko-Beratung mbH

Die anonyme Meldeseite ist einfach unter folgender URL zu erreichen:

http://localhost:8080/kritikom/complaint/Start.do

Herzlichen Glückwunsch - damit ist die Installation des Systems abgeschlossen!

Backup einrichten

Die erfassten Daten sollten natürlich regelmäßig per Backup gesichert werden!

Für die mitgelieferte Datenbank PostgreSQL kann das mit dem Kommando pg_dump im Verzeichnis bin Ihrer PostgreSQL-Installation im laufenden Betrieb erledigt werden:

pg_dump.exe -U kritikom -f kritikom_backup.sql kritikom

bzw. unter Linux:

pg_dump -U kritikom -f kritikom_backup.sql kritikom

Damit sichern Sie alle Daten der Datenbank kritikom in die Datei kritikom_backup.sql

Die Parameter im einzelnen:

-U gibt den DB-User an, dem die Datenbank gehört - normalerweise ist das der Benutzer kritikom

-f gibt den Dateinamen (hier kann natürlich auch ein kompletter Pfad angegeben werden) für die gesicherten Daten an.

Der letzte Parameter ist der Name der zu sichernden Datenbank - normalerweise ist das kritikom

Wenn diese Kommandos aus einem Script aufgerufen werden sollen ist natürlich die Passwortabfrage unerwünscht. Sie lässt sich folgendermaßen umgehen:

es gibt mehrere Möglichkeiten die Passwortabfrage zu umgehen.

  1. Sie können in der Datei "pg_hba.conf" im Verzeichnis data Ihrer PostgreSQL-Installation folgende Zeile am Ende hinzufügen:
    host kritikom kritikom-admin 127.0.0.1/32 trust
    Damit ist vom lokalen Rechner aus der Zugriff auf die Datenbank kritikom für den Benutzer kritikom-admin allerdings gar nicht mehr geschützt. Von allen anderen Rechnern aus aber schon.

  2. Sie können im aufrufenden Script die Umgebungsvariable PGPASSWORD mit dem Passwort setzen.

Optionale Konfiguration

Empfohlene Konfiguration für Zugriff aus dem Internet

Falls kritikom aus dem Internet erreichbar sein soll, empfehlen wir einen Apache Web-Server vorzuschalten und die gesamte Kommunikation per SSL zu verschlüsseln.

So kann über die Konfiguration des Web-Servers z.B. auch nur die Meldeseite im Internet verfügbar gemacht werden, so dass der Zugriff des Backends weiterhin nur aus dem Intranet möglich ist.

Wenn Sie hier Unterstützung brauchen kommen Sie gerne auf uns zu!

E-Mail-Versand einrichten

Damit kritikom Email-Benachrichtigungen verschicken kann, kann eine Anbindung an Ihren SMTP-Server eingerichtet werden.

Dazu sind folgende Einträge in der Datei kritikom.properties im Unter-Verzeichnis conf Ihrer Tomcat-Installation anzupassen:

SMTP_HOST=ihr.smtp.server
SMTP_USER=
SMTP_PWD=
FROM_NAME=kritikom
FROM_ADDRESS=kritikom@...ihre-einrichtung..de
REPLY_TO=admin@...ihre-einrichtung..de

Falls Ihr SMTP-Server eine Authentifizierung benötigt, legen Sie am besten einen technischen Email-Account an und tragen die entsprechenden Daten unter SMTP_USER und SMTP_PWD ein.

Anschließend ist der Tomcat-Dienst neu zu starten.