Installation per Skript

Systemvoraussetzungen

Das Installationsskript wurde auf Debian 10, 11 und 12 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

OS installieren (empfohlen und getestet: Debian 11/12)
Als root (bzw. per sudo -s oder su) anmelden
Danach git installieren (falls nicht vorhanden):
```
apt update
apt install git
```
Umgebungsvariable PATH prüfen
```
cd /root
nano .bashrc
```
Hier muss folgende Zeile ergänzt werden, falls diese nicht vorhanden ist:
```
export PATH="$PATH:/usr/local/sbin:/usr/sbin:/sbin"
```
Nano mit Strg-X beenden (Speichern) und die Konfiguration neu laden:
```
source .bashrc
```
In das Web-Verzeichnis wechseln:
```
cd /var
```
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 oder 12 umgeschaltet werden:

Debian 12
```
git checkout debian12
git pull
```
Debian 10
```
git checkout debian10
git pull
```
Mögliche Probleme

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
```
Nach erfolgreichem Klonen bzw. Herunterladen des Installers befinden sich alle Dateien im Ordner /var/gris-leibniz-installer
Falls es sich nicht um eine Testinstallation handelt, zuerst die Passworte in der Konfigurationsdatei /var/gris-leibniz-installer/config.sh anpassen.
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.

GRIS-Anmeldung

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 -->

LDAP Account Manager

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

Hinweis: Umstellung auf Ports

Falls phpMyAdmin oder der LDAP-Account-Manager nicht über den Servernamen erreichbar sein sollten, kann das an der jeweiligen DNS- und Netzwerkkonfiguraion liegen. In diesem Fall empfiehlt es sich, sattdessen Portz zu verwenden.

Dazu müssen die beiden vHost-Konfigurationen und die Port-Konfiguration folgendermaßen angepasst werden (exemplarisch für Port 8080 und 8081):

/etc/apache2/sites-available/phpmyadmin-vhost.conf

<VirtualHost *:8080>
    ServerName localhost
    DocumentRoot /usr/share/phpmyadmin
    <Directory />
        Options FollowSymLinks
        AllowOverride None
    </Directory>
</VirtualHost>

/etc/apache2/sites-available/ldap-account-manager.conf

<VirtualHost *:8081>
    ServerName localhost
    DocumentRoot /usr/share/ldap-account-manager

    ... die restlichen Eiträge bleiben bestehen ...

</VirtualHost>

/etc/apache2/ports.conf

Listen 80
Listen 8080
Listen 8081

<IfModule ssl_module>
        Listen 443
</IfModule>

<IfModule mod_gnutls.c>
        Listen 443
</IfModule>

Zur Übernahme der Konfiguraionen ist ein Neustart des Webservers notwendig:

service apache2 start

Danach sind beide Anwendungen über die jeweiligen Ports erreichbar:

http(s)://localhost:8080 (phpMyAdmin)
http(s)://localhost:8081 (LDAP-Account-Manager)