Installation mit dem Schnellinstallationsprogramm

Dieser Abschnitt beschreibt, wie der Avantra Server auf einer Linux-Maschine mit dem Avantra Quick Installer installiert wird. Nach der Installation stehen Ihnen folgende Komponenten zur Verfügung:

Avantra Server
Avantra Web-Benutzeroberfläche
Avantra Agent (zur Überwachung der lokalen Avantra-Instanz)
PostgreSQL-Datenbank für die Avantra-Daten

Installationsanforderungen

Um Avantra mit dem Quick Installer zu installieren und auszuführen, benötigen Sie:

Ein entsprechend dimensioniertes System (siehe den Sizing Guide)
Angemeldet als root oder ein sudo-fähiger Benutzer
Internetzugang, um den Quick Installer und erforderliche Pakete herunterzuladen
Netzwerkzugriff:
- Port 22 für SSH, um den Quick Installer auszuführen
- Port 8443, um nach der Installation auf die WebUI zuzugreifen
- Port 9050, um Remote-Agents die Kommunikation mit Avantra zu ermöglichen

Durchführung der Installation

Um den Quick Installer auszuführen, müssen Sie ein sudo-fähiger Benutzer sein oder als root angemeldet sein. Das System benötigt auch Internetzugang, um Remote-Pakete herunterzuladen.

Gehen Sie zum Avantra Customer Hub und melden Sie sich mit Ihrem Benutzerkonto an. Wenn Sie kein Konto haben, wenden Sie sich bitte an Avantra Support.

Gehen Sie zu Download Avantra auf der Startseite und wählen Sie Download Avantra Server.
Auf der linken Seite sollten Sie den Abschnitt New Installations und Quick Installer sehen. Hier finden Sie eine Schaltfläche namens Copy Install Command, um den vollständigen Installationsbefehl in die Zwischenablage zu kopieren.

Figure 1. Customer Hub - Wo Sie den Installationslink finden
Gehen Sie als nächstes zu Ihrem neuen Avantra-System, wo Sie entweder als root oder als sudo-fähiger Benutzer angemeldet sein müssen, fügen Sie den Befehl ein und führen Sie ihn aus.

Die Installation kann je nach Systemzustand (wie aktuell es ist, Internetzugangsgeschwindigkeit usw.) zwischen 7 und 20 Minuten dauern.

Figure 2. Beispiel für Quick Installer Ausgabe

Stellen Sie sicher, dass Sie das Ergebnis des Quick Installers (aus Ihrem Terminalfenster) speichern, da es das zufällig generierte Passwort für Ihren Datenbankbenutzer sowie das zufällig generierte Administratorpasswort für Ihr Avantra-System enthält. Wenn Sie diese Informationen nicht notieren, können sie nicht wiederhergestellt werden, und Sie müssen von vorne beginnen.

Öffnen Sie schließlich in Ihrem Browser die Avantra WebUI unter https://10.0.0.1:8443 (ersetzen Sie die IP-Adresse 10.0.0.1 durch den Hostnamen oder die IP Ihres neuen Avantra-Systems) und melden Sie sich mit den Anmeldeinformationen an, die Sie aus der Quick Installer-Ausgabe erhalten haben.

Installationsinformationen

Dienstnamen

Systemd-Dienstnamen
Dienst	Name	Nutzung	Zweck
Avantra Server	`avantra-server`	`sudo systemctl stop avantra-server`	Laufzeit für den Avantra-Server
Avantra UI	`avantra-ui`	`sudo systemctl stop avantra-ui`	Laufzeit für die Avantra WebUI
Avantra Agent	`avantra-agent`	`sudo systemctl stop avantra-agent`	Laufzeit für den lokalen Avantra Agent
PostgreSQL Server	`postgresql`	`sudo systemctl stop postgresql`	Laufzeit für die PostgreSQL-Datenbank

Installierte Pakete

Ubuntu
Paket	Name	Zweck
Java-Laufzeit	`openjdk-17-jre`	Laufzeit für Avantra-Dienste
Ubuntu 22.04 PostgreSQL-Datenbank	`postgresql-14`	Datenbank für Avantra-Dienste
Ubuntu 24.04 PostgreSQL-Datenbank	`postgresql-16`	Datenbank für Avantra-Dienste

RHEL
Paket	Name	Zweck
Java-Laufzeit	`java-17-openjdk`	Laufzeit für Avantra-Dienste
PostgreSQL-Datenbank	`postgresql-server`	Datenbank für Avantra-Dienste
PostgreSQL-Client	`postgresql`	Client für den Datenbankzugriff
policycoreutils-python-utils	`policycoreutils-python-utils`	Dienstprogramm-Bibliothek, die während der korrekten Einrichtung von SELinux verwendet wird
policycoreutils-python	`policycoreutils-python`	Dienstprogramm-Bibliothek, die während der korrekten Einrichtung von SELinux verwendet wird

SUSE
Paket	Name	Zweck
Java-Laufzeit	`java-17-openjdk`	Laufzeit für Avantra-Dienste
PostgreSQL-Datenbank	`postgresql15-server`	Datenbank für Avantra-Dienste
PostgreSQL-Client	`postgresql15`	Client für den Datenbankzugriff

Benutzer, Speicherorte & Ports

Avantra Server / UI
Home-Verzeichnis	`/opt/avantra/`
WebUI-Port	`8443`
Kommunikationsport für den Agenten	`9050`
Dienstbenutzer	`avantra`

Avantra Agent
Home-Verzeichnis	`/opt/avantra/agent`
Kommunikationsport für den Agenten	`9051`
Dienstbenutzer	`avantra`

Datenbank
Installationsverzeichnis	gemäß OS-Paketmanager
Datenverzeichnis	`/opt/postgres/data`
DB-Kommunikationsport	`5432`
Dienstbenutzer	`postgres`

Häufig gestellte Fragen

Kann ich Avantra mit dem Quick Installer ohne Root-Rechte installieren?

Nein, Sie müssen entweder Root oder ein sudo-fähiger Benutzer sein, um den Quick Installer zu verwenden. Wenn Sie keine Root-Rechte haben, müssen Sie eine manuelle Installation durchführen.
Ist der Avantra-Server während der Installation gehärtet?

Ja, aber nicht alle Empfehlungen werden umgesetzt (z. B. können Sie weiterhin Befehle auf Betriebssystemebene innerhalb von Automatisierungen ausführen). Wir empfehlen, den Avantra Hardening Guide zu lesen und Ihr System entsprechend den Anforderungen Ihrer Organisation zu konfigurieren.
Ist der Avantra Quick Installer für Windows verfügbar?

Nein, bitte führen Sie eine manuelle Installation durch.
Ich habe vergessen, den Benutzernamen und das Passwort aus der Quick-Installer-Ausgabe zu kopieren. Kann ich sie wiederherstellen?

Nein, Sie müssen von vorne beginnen, da die Passwörter nirgendwo gespeichert werden und verloren gehen. Um von vorne zu beginnen, folgen Sie dem Verfahren am Ende dieser Seite zum Zurücksetzen nach einem fehlgeschlagenen Quick Installer und wiederholen Sie dann den gesamten Quick Installer.

Zurücksetzen nach einem fehlgeschlagenen Quick Installer

Dieses Verfahren sollte nur verwendet werden, wenn Sie die aktuelle Maschine nach einem fehlgeschlagenen QI zurücksetzen möchten. Es sollte nicht durchgeführt werden, wenn es Bedenken hinsichtlich des Datenverlusts gibt. Bitte überprüfen und verstehen Sie diese Befehle, bevor Sie sie verwenden.

Bitte BEACHTEN Sie vor dem Ausführen dieser Schritte, dass sie destruktiv sind und den Datenbankinhalt sowie alle installierten Dateien in den Avantra-Verzeichnissen im Dateisystem zerstören.

VERSUCHEN SIE NICHT, DIESE BEFEHLE ZU VERWENDEN, OHNE SIE VOLLSTÄNDIG ZU VERSTEHEN. SIE FÜHREN ZU DATENVERLUST, WENN SIE UNSACHGEMÄSS VERWENDET WERDEN.

# Stop and disable all Avantra services.
sudo systemctl stop avantra-server
sudo systemctl disable avantra-server
sudo systemctl stop avantra-ui
sudo systemctl disable avantra-ui
sudo systemctl stop avantra-agent
sudo systemctl disable avantra-agent

# Remove the Avantra installation files
sudo rm -Rf /opt/avantra

# Drop the database that had been created.
sudo runuser -l postgres -c "psql -c \"drop database avantra_db;\""