Installation unter Linux

Dieser Abschnitt beschreibt, wie der Avantra Server auf einem Unix-ähnlichen Betriebssystem installiert wird.

Für unseren Schnellinstaller, einem Einzeilen-Befehl für die Installation des Avantra Servers, aller notwendigen Abhängigkeiten (einschließlich PostgreSQL) und eines lokalen Avantra Agent, folgen Sie bitte den Anweisungen unter diesen Anweisungen.

Vorbereitung der Installation

Sie müssen mit den folgenden Themen vertraut sein, um diese Installation durchzuführen:

  • Benutzer und Gruppen hinzufügen

  • Verwenden von Paketmanagern

  • Verwaltung der cron-Einrichtung

  • Erstellen von Dateisystemen (falls gewünscht)

Führen Sie diese Schritte als Benutzer root aus:

Betriebssystem-Benutzer und -Gruppe

Wenn Sie beabsichtigen, den Avantra Server mit einem der großen Cloud-Anbieter auszuführen, können Sie den Standardbenutzer des Installations-Images verwenden und mit dem sudo-Befehl arbeiten.

  1. Erstellen Sie eine Betriebssystemgruppe avantra.

  2. Erstellen Sie einen Betriebssystembenutzer avantra. Fügen Sie diesen Benutzer der Gruppe avantra hinzu und erstellen Sie ein Home-Verzeichnis /home/avantra. Wir empfehlen die Verwendung einer sh-ähnlichen Anmeldeshell, wie bash oder ksh.

Ein Dateisystem erstellen

  1. Erstellen Sie, sofern noch nicht geschehen, ein Dateisystem /avantra mit einer Größe von mindestens 30 GB oder erstellen Sie ein Verzeichnis in einem vorhandenen Dateisystem (mit mindestens dem erforderlichen freien Speicherplatz) und erstellen Sie einen symbolischen Link /avantra zu dem neu erstellten Verzeichnis.

  2. Ändern Sie die Besitzrechte des Verzeichnisses /avantra auf den Benutzer und die Gruppe avantra:

root$ chown -R avantra:avantra /avantra

Installation der 64-Bit-Java-Laufzeitumgebung (auf Unix-ähnlichen Betriebssystemen)

Auf Unix-ähnlichen Betriebssystemen können Sie die 64-Bit-Java-17-Laufzeitumgebung normalerweise mithilfe des Standard-Paketmanagers des Betriebssystems installieren. Dies ist der empfohlene Weg, da er in der Regel auch Möglichkeiten für automatische Updates bietet.

Wenn Sie keinen Paketmanager verwenden möchten, siehe Avantra und Java.

Installation des PostgreSQL-RDBMS

PostgreSQL ist in verschiedenen Linux-Distributionen enthalten, und das PostgreSQL-Projekt beschreibt viele Möglichkeiten, das RDBMS so zu installieren, dass es gut in den Linux-Paketmanagementprozess integriert ist. Der große Vorteil dieser Installationen ist, dass sie automatisch Patch-Updates abdecken. Daher lautet unsere Best-Practice-Empfehlung, Ihren eigenen OS-Paketmanager gemäß den IT-Richtlinien und -Anweisungen Ihres Unternehmens zu verwenden.

Darüber hinaus bieten alle großen Cloud-Anbieter PostgreSQL als Dienst an. Unsere Avantra für AWS-Lösung nutzt Amazon RDS für PostgreSQL auf die gleiche Weise, wie Avantra für GCP Cloud SQL für PostgreSQL verwendet. Microsoft Azure bietet Azure Database für PostgreSQL, und AWS bietet eine PostgreSQL-kompatible Version von Amazon Aurora an. All diese verschiedenen Optionen – Linux-Pakete und Cloud-Dienste – funktionieren hervorragend mit dem Avantra Server, wenn Sie einige Überlegungen im Hinterkopf behalten.

Der Avantra Server auf Unix unterstützt die folgenden PostgreSQL-Versionen:

  • PostgreSQL 15.x

  • PostgreSQL 14.x

  • PostgreSQL 13.x

  • PostgreSQL 12.x

Avantra unterstützte früher PostgreSQL 9.6 und 11, diese sind jedoch nicht mehr von PostgreSQL unterstützt und werden nicht mehr für die Verwendung mit Avantra empfohlen.

Wenn Sie sich für die Verwendung eines Standardpakets entscheiden, stellen Sie sicher, dass es sich um eine der unterstützten Versionen handelt. Selbst weit verbreitete Linux-Distributionen bieten möglicherweise relativ alte (und daher nicht unterstützte) Versionen von PostgreSQL an.

Verfahren: Konfigurieren von PostgreSQL für den Avantra Server

Schritt 1. Erstellen Sie einen Datenbankbenutzer, der über die Berechtigung zum Erstellen von Datenbanken verfügt, damit das Avantra-Setup ausgeführt werden kann. Wenn Sie eines der Standardpakete installiert, den Datenbank-Cluster initialisiert und gestartet haben, können Sie dies mit dem folgenden Befehl tun:

sudo -u postgres createuser --interactive --createdb --no-createrole --no-superuser --pwprompt

Wenn Sie einen der Cloud-Dienste verwenden, lesen Sie bitte die zugehörige Dokumentation.

Schritt 2. Standardmäßig hört PostgreSQL nur auf die Loopback- (oder localhost-)Adresse. Wenn Ihr Avantra Server nicht auf demselben Server wie die PostgreSQL-Datenbank installiert ist, müssen Sie den PostgreSQL-Listener so konfigurieren, dass er Datenverkehr auf allen Netzwerkschnittstellen akzeptiert. Dies kann in der Datei postgresql.conf erfolgen.

Verwenden Sie den folgenden Befehl, um den Speicherort der Datei postgresql.conf zu ermitteln:

sudo -u postgres psql -c "show config_file"

Ändern Sie dann die Zeile, die die Anweisung listen_address enthält, in:

listen_addresses = '*'       # auf welche IP-Adresse(n) gehört wird;
                             # kommagetrennte Liste von Adressen;
                             # Standardmäßig 'localhost'; '*' für alle verwenden
                             # (Änderung erfordert Neustart)

Stellen Sie sicher, dass Sie PostgreSQL nach diesen Änderungen neu starten. Wenn Sie einen der Cloud-Dienste verwenden, müssen Sie wahrscheinlich nichts weiter tun.

Schritt 3. Standardmäßig beschränkt PostgreSQL den Zugriff auf den Listener mithilfe von hostbasierten Zugriffskontroll-Dateien nur auf lokale Verbindungen. Wenn Ihr Avantra Server nicht auf demselben Server wie die PostgreSQL-Datenbank installiert ist, müssen Sie den PostgreSQL-Listener so konfigurieren, dass er Verbindungen vom Avantra Server zulässt. Dies geschieht in der Datei pg_hba.conf.

Verwenden Sie den folgenden Befehl, um den Speicherort der Datei pg_hba.conf zu ermitteln:

sudo -u postgres psql -c "show hba_file"

Fügen Sie dann die Zeile host all all <address> md5 hinzu, wobei <address> die IP-Adresse des Avantra Servers (oder des Netzwerks, in dem er sich befindet) in CIDR-Notation ist.

Lesen Sie auch die Datei pg_hba.conf.

Stellen Sie sicher, dass Sie PostgreSQL nach diesen Änderungen neu starten. Wenn Sie einen der Cloud-Dienste verwenden, müssen Sie wahrscheinlich nichts weiter tun.

Schritt 4. Der letzte Schritt besteht darin sicherzustellen, dass keine hostbasierte Firewall oder SE-Linux-Konfiguration auf dem PostgreSQL-Server die Verbindung vom Avantra Server verhindert. Dasselbe gilt für jede Netzwerk-Firewall. Dies ist besonders wichtig, wenn Sie Cloud-Dienste verwenden.

Frühere Versionen von Avantra (vor und einschließlich 20.5) enthielten einen optionalen vorkonfigurierten PostgreSQL-Installer, um die Installation in Demo- und Nicht-Produktionsumgebungen zu vereinfachen. Bitte beachten Sie, dass dieses Paket nicht mehr unterstützt wird und nicht gewartet wird. Wir empfehlen dringend, auf eine paketmanager-basierte und unterstützte Version von PostgreSQL zu wechseln, um sicherzustellen, dass Sie regelmäßige Updates für Ihre Datenbankinstallation erhalten. Weitere Anweisungen zur Migration auf eine andere PostgreSQL-Installation finden Sie unter diesem Lösungsszenario.

Installation der Avantra-Server-Komponenten

Führen Sie die folgenden Schritte als Benutzer avantra aus (oder als Benutzer root, wenn Sie die Ports 80 und/oder 443 wie im Punkt Running the UI on port 80/443 von Installation Notes beschrieben verwenden möchten):

Stellen Sie sicher, dass Sie das Paket Fontconfig und DejaVu-Schriften entsprechend Ihrer Linux-Distribution installieren. Für Redhat 8 oder CentOS 8 installieren Sie bitte auch das Paket libnsl: sudo dnf install libnsl.

Verfahren: Ausführen des Avantra Server-Installers:

  1. Laden Sie avantra-server-24.0-[os].bin aus dem Abschnitt SERVER RELEASE 24.0 unter the Support menu of avantra.com herunter und speichern Sie es in /avantra.

    Stellen Sie sicher, dass die Datei ausführbar ist:

    avantra$ chmod 755 avantra-server-24.0-[os].bin

  2. Wenn die Java Runtime Environment 8 installiert und in Ihrem Pfad enthalten ist, führen Sie aus:

    avantra$ ./avantra-server-24.0-[os].bin

    Andernfalls führen Sie aus:

    avantra$ ./avantra-server-24.0-[os].bin -- --jvm=[path_to_java_executable]

    wobei [path_to_java_executable] der absolute Pfad der java-Ausführungsdatei ist.

    NOTE: Ja, es ist wirklich -- zuerst und dann --jvm.

  3. Sie werden aufgefordert, die HTTP- und HTTPS-Ports für Avantra WebUI festzulegen. Wir empfehlen, den HTTP-Port auf den HTTPS-Port umzuleiten und standardmäßig HTTPS zu verwenden.

  4. Nach Abschluss startet der Installer automatisch Avantra Server und Avantra WebUI über die Webbenutzeroberfläche.

Es stehen mehrere Befehlszeilenflags zur Verfügung, um den Installer zu beeinflussen.

Die Flags müssen einem -- nach dem Installernamen folgen, z. B. ./avantra-server-23.0.3.bin — --no-start --silent
Installer-Flag Zweck

--jvm, -j

Legen Sie den Speicherort der Java Virtual Machine fest

--no-start

Starten Sie keine Dienste nach der Installation oder dem Upgrade

--jvmargs

Argumente, die an die zugrunde liegende JVM übergeben werden sollen

--skip-xangui

Installieren/aktualisieren Sie die UI-Komponente nicht

--skip-master

Installieren/aktualisieren Sie die Server-Komponente nicht

--silent

Fordern Sie den Benutzer nicht zur Eingabe auf

-C xangui.port=8080

Setzen Sie den UI-HTTP-Port auf 8080

-C xangui.sslPort=8443

Setzen Sie den UI-HTTPS-Port auf 8443

-C xangui.redirectHttpToHttps=yes

Leiten Sie den HTTP-Port auf HTTPS um

-C xangui.keyStorePath=/path/file.ks

Der Pfad zum Keystore, in dem sich das UI-Zertifikat befindet

-C xangui.keyStorePassword=trustMe123

Das Passwort für den Keystore

-C xangui.trustStorePath=/path/file.ts

Der Pfad zum Keystore, in dem sich der Truststore befindet

-C xangui.trustStorePassword=trustMe123

Das Passwort für den Truststore

-C xangui.certAlias=certificateAliasName

Der Alias für das UI-Zertifikat im Keystore

Bereitstellen der Avantra-Datenbank auf Unix

  1. Öffnen Sie Ihren Browser unter https://[avantra_server]:[port] (mit dem oben definierten Port).

  2. Wählen Sie PostgreSQL und drücken Sie Weiter.

  3. Geben Sie den Namen Ihres Avantra Server in Host / Port ein. Sie müssen den Port nicht definieren. Drücken Sie Weiter.

  4. Geben Sie den Benutzer und das Passwort ein, das Sie in Schritt 3 von Procedure: Running the PostgreSQL installer definiert haben, in SQL-Benutzer / Passwort. Drücken Sie Weiter.

  5. Definieren Sie einen Namen für die Datenbank. Normalerweise lassen Sie diesen auf den Standardwert avantra eingestellt. Drücken Sie die Datenbank erstellen & prüfen-Schaltfläche.

  6. Definieren Sie den Anwendungs-Stammbenutzer. Füllen Sie die Felder für Stammbenutzername und Stammbenutzerkennwort aus und drücken Sie die Erstellen-Schaltfläche.

    Notieren Sie sich diese Anmeldedaten sorgfältig und halten Sie sie bereit. Für den Moment wird dies der einzige Weg sein, um auf die Anwendung zuzugreifen!

  7. Drücken Sie Speichern und zur Avantra UI wechseln, um die Installation abzuschließen.

Einbinden von Avantra-Daemons in den System-Init-Prozess

Um sicherzustellen, dass die Avantra Server-Komponenten beim Hochfahren des Systems automatisch gestartet und beim Herunterfahren ordnungsgemäß beendet werden, sollten Sie sie in Ihren Systeminitialisierungsprozess einbinden. Konsultieren Sie Ihre Systemdokumentation.

Starten Sie die verschiedenen Komponenten in folgender Reihenfolge:

  1. Avantra Database

  2. Avantra Server

  3. Avantra WebUI

Für das Herunterfahren verwenden Sie die umgekehrte Reihenfolge.

Manuelles Starten und Stoppen von Avantra-Serverkomponenten

Sie können die folgenden Befehle verwenden, um Avantra Server-Komponenten manuell zu stoppen. Verwenden Sie diese Reihenfolge, um das gesamte System zu stoppen:

Avantra WebUI

/avantra/xangui/rc.xangui stop

Avantra Server

/avantra/master/rc.master stop

Sie können die folgenden Befehle verwenden, um Avantra Server-Komponenten manuell zu starten. Verwenden Sie diese Reihenfolge, um das gesamte System zu starten:

Avantra Server

/avantra/master/rc.master start

Avantra WebUI

/avantra/xangui/rc.xangui start

Früher (Version 20.5 und darunter) lieferte Avantra eine vorgepackte PostgreSQL 9.6-Installation. Bitte beachten Sie, dass diese PostgreSQL-Version und ihre Verwendung mit Avantra nicht unterstützt werden, da diese Version von PostgreSQL nicht mehr unterstützt wird.

Wir empfehlen, auf eine paketmanager-basierte Installation von PostgreSQL zu migrieren. Kunden, die diese Version weiterhin zu Test- und Demo-Zwecken verwenden, können die folgenden Befehle verwenden.

Um das System zu stoppen:

Avantra WebUI

/avantra/xangui/rc.xangui stop

Avantra Server

/avantra/master/rc.master stop

Avantra Database

/avantra/xandriadb/rc.xandriadb stop

Um das System zu starten:

Avantra Database

/avantra/xandriadb/rc.xandriadb start

Avantra Server

/avantra/master/rc.master start

Avantra WebUI

/avantra/xangui/rc.xangui start