Installation des Avantra-Agenten

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.

The installation of the Avantra Agent is not a complicated task to complete as the agent is designed to be light weight and require minimal dependencies.

Dependencies

Before you install your Avantra Agent (on any platform) there are two main dependencies to check:

Java Runtime

Avantra ist eine Java-Anwendung und benötigt daher eine gültige Laufzeitumgebung, um zu funktionieren. Dies gilt sowohl für die Avantra Server Laufzeit als auch für die Avantra Agent Laufzeit, wobei die JRE-Anforderungen für beide geringfügig voneinander abweichen können. Bitte beachten Sie, dass Avantra die Verwendung der Temurin JRE, bereitgestellt von Adoptium der Eclipse Foundation (früher bekannt als Adopt OpenJDK) empfiehlt und dass dies die JRE ist, auf der wir unsere eigenen Massentests durchführen.

Die Avantra-Software wird derzeit auf die Verwendung der Java-Laufzeitversion 17 umgestellt. Während dieser Umstellung müssen bestimmte Komponenten unter Java 17 und andere unter Java 8 ausgeführt werden. Bitte lesen Sie alle Versionshinweise und Upgrade-Anleitungen sorgfältig durch, um sicherzustellen, dass Sie Ihre Umgebung während dieser Umstellung korrekt einrichten. Mit der Veröffentlichung von Avantra 24.X Ende 2023 wird erwartet, dass alle Avantra-Komponenten die Java-Laufzeitversion 17 erfordern werden.

Bevor Sie ein Upgrade von Avantra Server oder Avantra Agent durchführen, stellen Sie bitte sicher, dass Ihre Java-Laufzeitversion die neueste Patch-Version für Ihre Version ist, d. h. den neuesten verfügbaren Patch für Java 8 oder Java 17.

JRE für Avantra Server

Für den Avantra Server unterstützen wir die Verwendung der Java-Laufzeitversion 8 für Avantra Server-Versionen 23.x und darunter. Für Avantra Server Versionen 24.x und höher müssen Sie eine Java-Laufzeitversion 17 verwenden. Während der Installation können Sie den Speicherort Ihrer gewünschten JRE angeben, andernfalls versucht das Installationsprogramm, eine gültige JRE-Installation zu erkennen.

Supported JRE versions for Avantra Server
Server Version	JRE 8	JRE 17
23.x und darunter	JA	NEIN
24.x und darüber	NEIN	JA

JRE für Avantra Agent

Für Avantra Agent 23.2.x und darunter unterstützt Avantra nur die Verwendung von Java 8. Für Avantra Agent 24.x und höher unterstützt Avantra nur die Verwendung von Java 17. Avantra Agent 23.3.x unterstützt sowohl Java 8 als auch 17, um ein nahtloses Upgrade auf die neue Java-Laufzeitumgebung zu ermöglichen.

Supported JRE versions for Avantra agents
Agent Version	JRE 8	JRE 17
23.2.x und darunter	JA	NEIN
23.3.x bis 23.9.x	JA	JA
24.x und höher	NEIN	JA

Upgrade-Pfad zu Java 17 für Avantra Agents

Kunden, die ihre bestehenden Installationen von einer früheren Version aktualisieren, wird empfohlen, dieses Verfahren zu befolgen:

Das allgemeine Verfahren ist in der folgenden Abbildung dargestellt:

Bringen Sie Ihren Avantra Server auf mindestens Version 23.3.x
[WICHTIG] Bringen Sie alle Agenten mithilfe der integrierten Funktion Agent Updates im Menü Administration auf eine Mindestversion von 23.3.x. Dies ist die einzige Agentenversion, die sowohl Java Runtime 8 als auch 17 unterstützt.
Laden Sie eine Java 17-Laufzeitumgebung in Avantra Server unter Administration - Agent Updates im neuen Reiter Java Packages hoch. Beachten Sie, dass dieser Reiter nicht angezeigt wird, wenn Ihr Avantra Server nicht auf 23.3.x oder höher ist.
Beginnen Sie mit der Aktualisierung EINES (1) Agenten eines nicht kritischen Systems, um die neue Java 17-Laufzeitumgebung zu verwenden, indem Sie auf die Registerkarte Status gehen und Select systems for a Java update auswählen, Ihr System auswählen und die neue JRE auswählen, die Sie gerade hochgeladen haben.
- Sobald das Java-Update erfolgreich abgeschlossen wurde und der Agent ordnungsgemäß funktioniert (warten Sie 15 Minuten, bis alle Zyklen abgeschlossen sind, oder erzwingen Sie einen vollständigen Prüfzyklus). Stellen Sie sicher, dass Avantra innerhalb von 15 Minuten nach dem Update anzeigt, dass der Server unter Java 17 läuft.
Sobald Sie ein Upgrade für einen Agenten erfolgreich durchgeführt haben, können Sie weitere Upgrades durchführen. Wir empfehlen, diese in aufsteigenden Gruppen von Agenten durchzuführen, falls Probleme auftreten sollten. Wenn Sie beispielsweise 100 Agenten aktualisieren müssen, gehen Sie wie folgt vor:
- 1 Agent zur Überprüfung des Prozesses
- 4 Agenten zur Überprüfung des Prozesses
- 15 Agenten
- 30 Agenten
- 50 Agenten

Your Java runtime can either be installed system-wide for all applications to use or you can specify a Java location that is non-standard for your Avantra Agent process to use. This is particularly useful when working on a system that already has a version of Java in-place that is not compatible for running Avantra.

Verify Network Connectivity

Network communication diagram showing a server communicating with an agent and the reverse.

By default, the Avantra Agent contacts the Avantra Server on TCP port 9050. The other way round, the Avantra Server connects to the Avantra Agent on TCP Port 9051 (unless you have changed either of these in your environment).

Before starting your installation on the remote server to be monitored, we suggest verifing the connectivity from the Avantra Agent to the Avantra Server. For example, you can use telnet` as follows:

telnet <your-avantra-hostanme> 9050
Trying 192.168.27.5...
Connected to <your-avantra-hostanme>.
Escape character is '^]'.
hello
You have reached Avantra Server version 23.2.0 (Build:1106-fc922) running on <your-avantra-hostanme>
Good bye.Connection closed by foreign host.

Note that once the connection was established in the example above, we typed the word hello to verify that we were connected to the right server. All Avantra network services will introduce themselves in this way when sent a hello command and this is useful for verification.

The telnet tool will report an error if a connection cannot be established.

If network restrictions are in place on your network, please contact your network staff to enable the communication in both directions, from the Avantra Agent to Avantra Server on port 9050, and the other direction on port 9051.