Installation per Skript

Systemvoraussetzungen

Das Installationsskript wurde auf Debian 10 und 11 getestet. Es sollte jedoch mit geringen Anpassungen auch auf anderen Linux-Distributionen laufen.

Auf dem Server sollten folgende Voraussetzungen erfüllt sein:

  • Root-Zugang (bzw. sudo -s)

  • Zugang via SSH (Konsole)

  • Zugang via SFTP, FTP oder shared folder

  • Zugang via Port 80 (HTTP) für alle Clients, die GRIS nutzen sollen

Eine Installation unter Windows ist ebenfalls möglich. Hierzu gibt es jedoch kein Installationsskript als Anhaltspunkt.

Vorbereitung und Installation

  1. OS installieren (empfohlen und getestet: Debian 11)

  2. Als root (bzw. per sudo -s oder su) anmelden

  3. Danach git installieren (falls nicht vorhanden):

    apt update
    apt install git
    
  4. Umgebungsvariable PATH prüfen

    cd /root
    nano .bashrc
    
  5. Hier muss folgende Zeile ergänzt werden, falls diese nicht vorhanden ist:

    export PATH="$PATH:/usr/local/sbin:/usr/sbin:/sbin"
    
  6. Nano mit Strg-X beenden (Speichern) und die Konfiguration neu laden:

    source .bashrc
    
  7. In das Web-Verzeichnis wechseln:

    cd /var
    
  8. Anschließend den Code herunterladen:

git clone https://git.gesis.org/gris/gris-leibniz-installer.git /var/gris-leibniz-installer
cd /var/gris-leibniz-installer
git checkout master

Hinweis

Der Standard-Installer setzt Debian 11 voraus. Durch Wechsel des Branches kann auf Debian 10 umgeschaltet werden:

git checkout debian10
git pull

Hinweis

Falls der Download aus dem Repository mit einer Fehlermeldung ...server certificate verification failed... abbricht, müssen zunächst die Zertifikate erneuert werden:

# Zertifikate aktualisieren
apt-get install apt-transport-https ca-certificates -y
update-ca-certificates
  1. Nach erfolgreichem Klonen bzw. Herunterladen des Installers befinden sich alle Dateien im Ordner /var/gris-leibniz-installer

  2. Falls es sich nicht um eine Testinstallation handelt, zuerst die Passworte in der Konfigurationsdatei /var/gris-leibniz-installer/config.sh anpassen.

  3. Im Ordner /var/gris-leibniz-installer nun das Installscript ausführen und das Ergebnis als Logfile speichern:

    cd /var/gris-leibniz-installer
    ./install.sh > install.log
    

Abschließen der Installation

Hinweis

Nach der Installation müssen noch die Sprach- und Genderdateien erzeugt werden, damit alle Übersetzungen und Genderformen korrekt angezeigt werden.

Dazu muss einmalig der Parser aufgerugen werden:

http://localhost/master/gris/tools/parse_lang_csv.php

Oder optional über die Befehlszeile (im GRIS-Ordner unter tools:

php parse_lang_csv.php

Erste Anmeldung

Nach erfolgreicher Erstinstallation im Testmodus kann die Anmeldung im Browser mit der IP-Nummer oder dem DNS-Namen des Servers erfolgen. Der Benutzername lautet dann muster und das Passwort test123.

Hinweis

Bei der ersten Anmeldung müssen die LDAP-Settings in die Datenbank übernommen werden. Die wird durch den Parameter reload=true erreicht:

http(s)://[URL des Servers]/index.php?reload=true
<!-- Bsp.: http://localhost/index.php?reload=true -->

phpMyAdmin

  • User: admin

  • Passwort: admin

http(s)://phpmyadmin.[URL des Servers]
<!-- Bsp.: http://phpmyadmin.localhost -->

phpLdapAdmin

http(s)://phpldapadmin.[URL des Servers]
<!-- Bsp.: http://phpldapadmin.localhost -->