Ubuntu/Debian-Installation#

Dieses Kapitel beschreibt eine vereinfachte Installationsmethode für Allegra unter Ubuntu 22/24 LTS (oder Debian 12) mithilfe einer vorgepackten ZIP-Datei von unserer Ressourcenseite. Zur Aktualisierung von Allegra auf eine neuere Version siehe Aktualisierung von Allegra.

Achtung

Diese Anleitung dient nicht dazu, Ihren Server für den öffentlichen Internetzugriff abzusichern. Für diesen Zweck sind zusätzliche individuelle Sicherheitsmaßnahmen erforderlich.

Vorbereitung#

Bevor Sie mit der Installation beginnen, stellen Sie sicher, dass folgende Voraussetzungen erfüllt sind:

Linux-System (Ubuntu 22/24 LTS oder Debian 12 empfohlen)
Ausreichend Speicherplatz (mindestens 20 GB, siehe Hardwareanforderungen)
Java 21 JRE/JDK ist installiert und in Ihrem System-PATH verfügbar (kann über APT installiert werden)
Laufende, von Allegra unterstützte Datenbank (empfohlen: PostgreSQL 18, siehe Datenbankeinrichtung)
Verfügbarer Netzwerkport (Standard 8080 oder benutzerdefiniert) für den Allegra-Server
Berechtigungen zum Ausführen von Shell-Skripten; sudo-Rechte, wenn Allegra als systemd-Dienst installiert werden soll
Grundlegende Dienstprogramme, die in der Regel bereits vorinstalliert sind (curl/wget, unzip, sha256sum)

Installation#

Führen Sie die folgenden Schritte aus, um Allegra unter Ubuntu 24 LTS mit dem ZIP-Paket und dem Verwaltungsskript zu installieren.

Laden Sie das ZIP-Paket herunter von der Allegra-Ressourcenseite. Speichern Sie es z. B. als /tmp/allegra.zip.

cd /tmp
# Mit wget (ersetzen Sie ZIP_URL durch den direkten ZIP-Link von der Ressourcenseite)
wget -O allegra.zip "<ZIP_URL>"

# Oder mit curl
curl -L -o allegra.zip "<ZIP_URL>"

Entpacken Sie die ZIP-Datei in Ihr Installationsverzeichnis (z. B. /home/ubuntu/allegra). Dieses wird als <INSTALLATION_DIRECTORY> bezeichnet.
```
mkdir -p /home/ubuntu/allegra
cd /home/ubuntu/allegra
unzip /tmp/allegra.zip
```
Nach dem Entpacken sollten Sie Folgendes sehen:
- allegra.sh — Verwaltungsskript
- bin/ — Enthält allegra.jar
- conf/ — Enthält application.properties
- allegra.service — systemd-Dienstvorlage
Machen Sie das Verwaltungsskript ausführbar.
```
chmod +x allegra.sh
```
Überprüfen Sie die Java-Installation.
```
./allegra.sh check-java
```
Wenn Java nicht gefunden oder nicht Version 21+ ist, installieren Sie Java 21 und stellen Sie sicher, dass es sich im PATH befindet.
Führen Sie den Setup-Assistenten aus.
```
./allegra.sh install
```
Folgen Sie den Anweisungen zur Konfiguration von: * Home-Verzeichnis (empfohlen: /home/ubuntu/allegra/allegra-home) * Datenbankverbindung * Server-Port und Kontextpfad * Speichereinstellungen

(Diese entsprechen den Einträgen in conf/application.properties.)
(Optional) Installieren Sie Allegra als systemd-Dienst für den automatischen Start nach einem Neustart.
```
sudo ./allegra.sh install-service
```
Vor der Installation wird Ihnen die erzeugte Servicedatei angezeigt. Bestätigen Sie, um fortzufahren.
Starten Sie Allegra.

Achtung

Wenn Sie Allegra als systemd-Dienst installiert haben, starten Sie es mit sudo systemctl start allegra.
```
./allegra.sh start
```
Greifen Sie auf Allegra zu über Ihren Browser unter http://localhost:8080 (oder Ihrem konfigurierten Port oder Kontextpfad) und melden Sie sich an mit:
- Benutzername: admin
- Passwort: tissi

Bemerkung

Das <INSTALLATION_DIRECTORY> enthält die Programmdateien und Skripte von Allegra. Während der Einrichtung erstellt Allegra außerdem ein separates <ALLEGRA_HOME>-Verzeichnis, in dem alle Anhänge und Konfigurationsdateien gespeichert werden.

Stellen Sie sicher, dass Java 21 JRE/JDK und ein unterstützter Datenbankserver installiert sind, bevor Sie den Installer ausführen. Ändern Sie das Standard-Admin-Passwort unmittelbar nach der ersten Anmeldung.

Betrieb#

Manueller Start und Stopp#

Achtung

Wenn Sie Allegra als systemd-Dienst installiert haben, verwenden Sie sudo systemctl <Befehl> allegra.

Um Allegra manuell zu starten, zu stoppen oder den Status zu prüfen, öffnen Sie ein Terminal im Installationsverzeichnis und führen aus:

cd <INSTALLATION_DIRECTORY>
./allegra.sh start
./allegra.sh stop
./allegra.sh status

Automatischer Start (Dienst)#

Wenn Allegra als Dienst installiert wurde, wird es beim Systemstart automatisch gestartet. Sie können es mit systemctl verwalten:

sudo systemctl start allegra
sudo systemctl stop allegra
sudo systemctl restart allegra
sudo systemctl status allegra
sudo journalctl -u allegra -f   # Live-Logs anzeigen

Systemd-Dienst deinstallieren#

Zum Entfernen des Allegra-systemd-Dienstes führen Sie aus:

sudo ./allegra.sh uninstall-service

Aktualisierung#

Zur Aktualisierung auf eine neuere Version siehe Aktualisierung von Allegra.

Nächste Schritte#

Nach erfolgreicher Installation sollten Sie:

Zugriff absichern
- Melden Sie sich an und ändern Sie sofort das Standard-Admin-Passwort.
- Überprüfen Sie Ihre Firewall-Einstellungen und beschränken Sie den Zugriff auf den Allegra-Port.
- Für öffentlich zugängliche Installationen verwenden Sie einen Reverse-Proxy (Apache, Nginx) und aktivieren Sie HTTPS/SSL.
  Siehe:
  - Nginx als Proxy
  - Apache als Proxy
Backups einrichten
- Richten Sie regelmäßige Backups für die Datenbank und das ALLEGRA_HOME-Verzeichnis ein.
Allegra konfigurieren
- Projekte, Benutzer und Workflows einrichten.
- Siehe das Allegra-Benutzerhandbuch.
Installation pflegen
- Halten Sie Allegra mit ./allegra.sh update aktuell.
- Verwenden Sie sichere Datenbankpasswörter und beschränken Sie den Netzwerkzugriff auf die Datenbank.
Optional
- Richten Sie den Gantt-Druckdienst ein — siehe Gantt-Druckserver.
- Installieren Sie Allegra Service Desk — siehe Allegra Service Desk.

Fehlerbehebung#

Anwendung startet nicht#

Java-Installation prüfen:
```
./allegra.sh check-java
```

Prüfen, ob der Standardport (8080) bereits belegt ist:

sudo ss -tulpn | grep :8080
# oder:
sudo netstat -tulpn | grep :8080

Startprotokoll prüfen:
```
cat allegra-startup.log
```
Anwendungsprotokoll prüfen:
```
tail -f $ALLEGRA_HOME/log/catalina.out
```
Datenbankverbindung prüfen:

Stellen Sie sicher, dass der Datenbankserver läuft und vom Allegra-Host erreichbar ist.
```
# PostgreSQL
pg_isready -h localhost -p 5432

# MySQL
mysqladmin ping -h localhost
```

Anwendung stoppt nicht#

Wenn ./allegra.sh stop nicht funktioniert:

ps aux | grep allegra.jar
kill <PID>         # oder: kill -9 <PID> falls nötig
rm -f allegra.pid  # Alte PID-Datei entfernen

Skriptberechtigung verweigert#

Wenn beim Ausführen des Skripts „Permission denied“ erscheint:

chmod +x allegra.sh
./allegra.sh help

Speicherfehler (Out of Memory)#

Wenn im Log ein OutOfMemoryError auftritt:

./allegra.sh stop
./allegra.sh setup-memory   # Höheren Speicherwert eingeben, wenn Sie dazu aufgefordert werden
./allegra.sh start

Datenbankverbindungsfehler#

Wenn Allegra keine Verbindung zur Datenbank herstellen kann:

Stellen Sie sicher, dass der Datenbankserver läuft.

# PostgreSQL
sudo systemctl status postgresql

# MySQL
sudo systemctl status mysql

Firewall- und Netzwerkeinstellungen prüfen:
```
sudo ufw status
```
Datenbank-Zugangsdaten und Konfiguration prüfen:
```
./allegra.sh show-config
```
Verbindung mit einem Datenbank-Client testen.

Probleme mit systemd-Dienst#

Wenn der systemd-Dienst nicht startet:

sudo systemctl status allegra
sudo journalctl -u allegra -n 50
sudo systemctl cat allegra

# Dateibesitz/Berechtigungen für den Dienstbenutzer prüfen:
ls -la /home/ubuntu/allegra/allegra.sh
ls -la /home/ubuntu/allegra/allegra.pi

Zusätzliche Befehle#

Die folgenden nützlichen Befehle stehen im Verzeichnis <INSTALLATION_DIRECTORY> zur Verfügung:

./allegra.sh help                 # Hilfeinformationen anzeigen
./allegra.sh install              # Vollständige interaktive Einrichtung
./allegra.sh setup-home           # Allegra-Home-Verzeichnis konfigurieren
./allegra.sh setup-db             # Datenbankverbindung konfigurieren
./allegra.sh setup-server         # Servereinstellungen konfigurieren (Port, Kontext)
./allegra.sh setup-memory         # Speichereinstellungen konfigurieren
./allegra.sh show-config          # Aktuelle Konfiguration anzeigen
./allegra.sh check-java           # Java-Installation überprüfen
./allegra.sh version              # Aktuelle Version anzeigen
./allegra.sh update               # Allegra auf die neueste Version aktualisieren
./allegra.sh update-script        # allegra.sh-Skript auf die neueste Version aktualisieren
./allegra.sh check-script-updates # Skriptversion auf Updates prüfen
sudo ./allegra.sh install-service   # Als systemd-Dienst installieren (erfordert sudo)
sudo ./allegra.sh uninstall-service # systemd-Dienst entfernen

Wichtige Eigenschaften#

Die folgenden wichtigen Konfigurationseigenschaften sind in <INSTALLATION_DIRECTORY>/conf/application.properties gespeichert:

# Allegra-Home-Verzeichnis
allegra.home=/home/ubuntu/allegra/allegra-home

# Datenbankkonfiguration
allegra.db.adapter=postgresql
allegra.db.driver=org.postgresql.Driver
allegra.db.url=jdbc:postgresql://localhost:5432/allegra
allegra.db.username=allegra
allegra.db.password=secret

# Serverkonfiguration
server.port=8080
server.servlet.context-path=/

# Speicherkonfiguration (in MB)
allegra.server.memory=2048

Ubuntu/Debian-Installation

Inhalt

Ubuntu/Debian-Installation#

Vorbereitung#

Installation#

Betrieb#

Manueller Start und Stopp#

Automatischer Start (Dienst)#

Systemd-Dienst deinstallieren#

Aktualisierung#

Nächste Schritte#

Fehlerbehebung#

Anwendung startet nicht#

Anwendung stoppt nicht#

Skriptberechtigung verweigert#

Speicherfehler (Out of Memory)#

Datenbankverbindungsfehler#

Probleme mit systemd-Dienst#

Zusätzliche Befehle#

Wichtige Eigenschaften#