Installation des Avantra-Server

Bevor Sie mit der Installation von Avantra beginnen, lesen Sie bitte die Versionshinweise für Avantra 24 und verwenden Sie die neuesten Softwareversionen und Patches von Avantra.

Der folgende Abschnitt soll einige der allgemeinen Aspekte der Installation der Avantra-Lösung erklären. Bitte machen Sie sich vor der Softwareinstallation mit diesen Konzepten vertraut.

License: Sie benötigen eine Lizenz, um Avantra auszuführen. Bitte folgen Sie den Anweisungen aus dem Artikel Obtaining and Installing the License, um die Lizenz zu erhalten und zu installieren, die Sie am Ende des Avantra Server-Installationsprozesses benötigen.
Supported Platforms: Bitte überprüfen Sie Avantra Server Components auf unterstützte Plattformen.
Permissions: Sie müssen über lokale Administratorrechte (auf Microsoft Windows-Betriebssystemen) oder root-Berechtigungen (auf Unix-ähnlichen Betriebssystemen) verfügen, um die Installation durchzuführen.
Database: Avantra auf Unix-ähnlichen Betriebssystemen erfordert einen PostgreSQL-Datenspeicher und wird für größere Avantra-Installationen empfohlen. Die Installation wird unter {https://docs.avantra.com/product-guide/24/avantra/installations/server/linux.html} beschrieben.

Wenn Sie beabsichtigen, Ihren Avantra Server bei einem großen Cloud-Anbieter bereitzustellen, sollten Sie in Erwägung ziehen, einen Datenbankdienst wie Amazon Web Services Relational Database Service, Microsoft Azure SQL Database Service oder Google Cloud Platform Cloud SQL zu verwenden. Für Amazon Web Services und Google Cloud Platform stellen Sie bitte sicher, dass Sie die PostgreSQL-Varianten der entsprechenden Dienste verwenden. Siehe auch diesen Artikel.

Avantra auf Microsoft Windows-Betriebssystemen ist ebenfalls mit PostgreSQL (empfohlen) oder MSSQL verfügbar. Für Produktevaluierungen sowie sehr kleine Installationen können Sie Microsoft SQL Server 2019 Express Edition installieren (bitte beachten Sie jedoch die Einschränkungen hinsichtlich der Datenmenge bei dieser Version).

Wenn Sie bereits eine Microsoft SQL Server-Installation zur Verfügung haben (Microsoft SQL Server 2017 oder höher) oder eine gemeinsame Installation durchführen, stellen Sie bitte sicher, dass lokale und entfernte TCP/IP-Verbindungen aktiviert sind.

Wenn Sie planen, die Avantra Database auf einem Microsoft SQL Server zu betreiben, der auf einem Server getrennt von anderen Avantra Server-Komponenten gehostet wird, stellen Sie sicher, dass die Avantra Server-Komponenten über die erforderlichen Berechtigungen zum Zugriff auf den Microsoft SQL Server verfügen.
Installation in einer Cluster-Umgebung: Als allgemeine Empfehlung, wenn Sie den Avantra Server in einer Cluster-Umgebung installieren möchten, sollten Sie zwei virtuelle Server (oder Umschaltgruppen) erstellen: einen mit dem RDBMS (Microsoft SQL Server oder PostgreSQL, abhängig vom Betriebssystem), das die Avantra Database enthält, und den anderen mit Avantra Server und Avantra WebUI.

Stellen Sie sicher, dass Sie während des Installationsprozesses Installationsorte wählen, die ordnungsgemäß mit den virtuellen Servern umgeschaltet werden.

Während der Installation des Avantra Server haben Sie die Möglichkeit, die Avantra Database auf einem remote installierten RDBMS zu platzieren.
Sicherheitsüberlegungen: Die Kommunikation zwischen Avantra Agents und Avantra Server ist über HTTPS verschlüsselt.

Wir empfehlen, dass die Kommunikation zwischen Webbrowsern und der Avantra WebUI ebenfalls über HTTPS verschlüsselt wird. Wenn Sie planen, HTTPS-Kommunikation zu verwenden, lesen Sie bitte diese Knowledge-Base-Artikel: UI-SSL-Probleme und Verwenden Sie ein von der CA signiertes Zertifikat für HTTPS in der UI.

Die UI auf Port 80/443 ausführen (nur Unix): Auf Unix-basierten Systemen sind die Ports 80 und 443 geschützt; typischerweise kann nur der Superuser root diese öffnen. Aus Sicherheitsgründen ist es nicht wünschenswert, den Avantra Server als root auszuführen. Standardmäßig verwendet Avantra WebUI die Ports 8080 und 8443. Wenn Sie möchten, dass Benutzer auf Avantra WebUI über die Standard-HTTP/HTTPS-Ports zugreifen, empfehlen wir, Avantra Server als Nicht-Root-Benutzer zu installieren und die Ports 80 und 443 entsprechend auf 8080 und 8443 mithilfe der Betriebssystemmittel umzuleiten.

Auf Linux können Sie iptables (oder ipchains) verwenden.

Bitte konsultieren Sie Ihre Betriebssystemdokumentation.

Wenn Sie den Avantra Server-Installer als root ausführen, können Sie Avantra Server und Avantra WebUI so konfigurieren, dass die Standard-Ports 80 und 443 verwendet werden.

Wenn Sie eine der großen Cloud-Plattformen verwenden, gibt es Dienste, die das Host- und Port-Mapping für Sie übernehmen, wie z. B. einen Load Balancer oder Endpoint Services. In diesem Szenario ist es in der Regel nicht erforderlich, die Dienste als root-Benutzer auszuführen.

Verschiedene Unix-Befehle: Die in dieser Dokumentation verwendeten Dateipfade und Verzeichnisnamen sowie die Syntax in Betriebssystemdateien (insbesondere für crontab) können je nach System oder sogar zwischen verschiedenen Versionen oder Distributionen desselben Betriebssystems variieren. Für weitere Informationen konsultieren Sie bitte Ihre Betriebssystemdokumentation, z. B. man cron, man crontab und andere, oder fragen Sie Ihren Betriebssystemadministrator.

Unterstützte Installationsmethoden

Avantra kann auf verschiedene Arten installiert werden. Wir empfehlen die Verwendung eines Linux-basierten Betriebssystems mit einer PostgreSQL-Datenbank und bieten eine schnelle Installationsmethode an, um schnell auf einer Cloud-VM zu starten. Nach jeder Installationsmethode folgen Sie bitte den Nach-Installationsschritten.

Verwendung des Avantra-Schnellinstallationsprogramms

Für eine einfache Ersteinrichtung bieten wir eine automatisierte Installationsoption nur für neue Systeme auf Linux an. Diese Option installiert eine Ein-Node-Installation des neuesten Avantra-Servers sowie alle Abhängigkeiten, einschließlich PostgreSQL mit einem vorinstallierten Avantra-Agent auf der lokalen Maschine. Wenn Sie von dieser Installation abweichen möchten, empfehlen wir eine manuelle Installation gemäß den untenstehenden Installationsanleitungen.

Die Schnellinstallation dauert etwa 10-15 Minuten und wird auf den folgenden Betriebssystemen unterstützt:

SUSE Linux 15 SP5 und höher
Red Hat Enterprise Linux 9
Ubuntu 22.04

Um diese Methode zu verwenden, folgen Sie den Anweisungen zum Install using the Quick Installer.

Manuelle Installation

Für Installationen, bei denen Abhängigkeiten angepasst, eine bestimmte Datenbank oder ein Cloud-Datenbankdienst ausgewählt werden soll, ist eine manuelle Installation erforderlich.

Folgen Sie der entsprechenden Anleitung für Unix-ähnliche (Linux) oder Microsoft Windows-Installationen.

Installation auf Kubernetes

Ab Avantra 23.0 unterstützen wir die Installation von Avantra auf einem Kubernetes-Cluster in bestimmten Fällen.

Bitte folgen Sie den folgenden Installationsanweisungen.

Installing on Kubernetes

Kunden, die diese Installationsmethode verwenden möchten, sollten sich an den Avantra-Support wenden, um Zugriff zu erhalten.

Vorbereitung der Avantra-Agent-Bereitstellung

Sie können den Avantra Server verwenden, um die anfängliche Bereitstellung des Avantra Agent auf jedem System zu vereinfachen.

Dies kann nützlich sein, um zu vermeiden, dass Sie die Dateien immer wieder von unserer Website herunterladen müssen, für jeden Server, auf dem Sie den Avantra Agent installieren. Stattdessen können Sie einen Browser oder ein Tool wie wget oder curl verwenden, um die Dateien direkt von Ihrem Avantra Server abzurufen.

Laden Sie die folgenden Dateien von the Support menu of avantra.com herunter:

agent-24.0.n.bin aus dem Abschnitt AGENT RELEASE 24.0.n
agent-24.0.n-setup.exe aus dem Abschnitt AGENT RELEASE 24.0.n
transports-for-avantra-24.zip aus dem Abschnitt CONTRIB RELEASE 24.0

Speichern Sie sie im Verzeichnis AgentUpdate auf dem Avantra-Server, das sich unter %ProgramFiles%\AgentUpdate (auf Microsoft Windows-Betriebssystemen) oder /avantra/AgentUpdate (auf Unix-ähnlichen Betriebssystemen) befindet.

Sie können dann auf die Pakete mit den folgenden Befehlen in Ihrem eigenen Netzwerk zugreifen:

$ wget http://avantra-server:9050/AgentUpdate/agent-24.0.n.bin

oder

$ curl http://youravantra-server:9050/AgentUpdate/transports-for-avantra-24.zip > transports-for-avantra-24.zip