Installation des Agenten auf Unix

Unter Linux muss die GNU C Library (glibc) in Version 2.7 oder höher installiert sein.

Es wird empfohlen, ein dediziertes Dateisystem für den Avantra Agent von mindestens 1,5 GB Größe zu erstellen.

  1. Erstellen Sie ein Verzeichnis, um die Avantra Agent-Software zu speichern, z. B. /opt/avantra.

    root$ mkdir /opt/avantra

  2. Erstellen Sie einen Betriebssystembenutzer avantra, der Mitglied einer Betriebssystemgruppe avantra ist, um den Avantra Agent auszuführen.

    Wenn Sie den Avantra Agent mit einem anderen Betriebssystembenutzer (z. B. sidadm) ausführen möchten, folgen Sie einfach den Anweisungen mit dem Benutzer sidadm anstelle von avantra.

  3. Fügen Sie den Benutzer avantra der Gruppe sapsys hinzu.

    Der Benutzer, der den Avantra Agent ausführt, benötigt die Berechtigungen, um auf die Home-Verzeichnisse aller Benutzer [sid]adm der installierten Instanzen sowie auf die Profilverzeichnisse /usr/sap/[SID]/SYS/profile zuzugreifen.

  4. Überprüfen Sie, ob die folgenden Zugriffsberechtigungen für das Verzeichnis /home/[sid]adm festgelegt sind, d. h. die Gruppenleseberechtigungen sind für die Gruppe sapsys gesetzt:

    drwxr-x---   2 [sid]adm    sapsys    2048 Jan 24 17:28 .
-rw-r-----   1 [sid]adm    sapsys    1515 Apr  9  2002 .cshrc
-rw-r-----   1 [sid]adm    sapsys    2820 Apr 17  2002 .dbenv_[hostname].csh
-rw-r-----   1 [sid]adm    sapsys    7307 Apr 17  2002 .sapenv_[hostname].csh

  5. Überprüfen Sie auf die gleiche Weise die Gruppenberechtigung von /usr/sap/[SID]/SYS/profile.

    1. Für SAP-Installationen auf der Grundlage einer Oracle-Datenbank fügen Sie den Benutzer avantra der Gruppe dba hinzu.

      Für SAP-Installationen auf der Grundlage einer Oracle-Datenbank benötigt der Benutzer avantra Berechtigungen, um auf das Verzeichnis /oracle/[SID] (und alle Unterverzeichnisse) zuzugreifen. Insbesondere benötigt er die Berechtigung, alle init*-Dateien in /oracle/[SID]/[ORA-VERS]/dbs zu lesen.

    2. Für SAP-Installationen auf der Grundlage einer IBM DB2 UDB/LUW-Datenbank fügen Sie den Benutzer avantra der Gruppe db[sid]adm hinzu.

      Für SAP-Installationen auf der Grundlage einer IBM DB2 UDB/LUW-Datenbank benötigt der Benutzer avantra Berechtigungen, um auf das Failover-Protokollarchivpfadverzeichnis (FAILARCHPATH), falls konfiguriert, zuzugreifen.

  6. Es wird empfohlen, dass der Pfad zur java-ausführbaren Datei in der PATH-Umgebung des Benutzers avantra enthalten ist. Zusätzlich wird im Pfad /opt/avantra/java nach geeigneten Java Virtual Machines gesucht.

    Wenn während der Installation keine Java-executable-Datei gefunden werden kann, wird die Installation abgebrochen.

  7. Ändern Sie den Besitzer des Verzeichnisses /opt/avantra zu avantra.

    root$ chown avantra /opt/avantra

  8. Wechseln Sie den Benutzer zu avantra und das Verzeichnis zu /opt/avantra.

    root$ su - avantra
avantra$ cd /opt/avantra

  9. Kopieren Sie die Avantra Agent-Installationssoftware agent-[version].bin in Ihr aktuelles Arbeitsverzeichnis /opt/avantra und starten Sie das Installationsprogramm:

    xandria$ chmod +x agent-24.0.n.bin
xandria$ ./agent-24.0.n.bin

    Der Installer wird während der Installation nach dem Agent-Listener-Port und fragen, ob der Agent gestartet werden soll. Normalerweise können Sie den Standardport 9051 bestätigen, indem Sie die Eingabetaste drücken. Sie können den Agent auch sofort starten.

    Bitte geben Sie den Agent-Listener-Port ein[9051]:
Starten Sie Avantra Agent [version]? [y,n] y

    Wenn Sie diesen Wert ändern, müssen Sie den AgentListenerPort Monitoring Parameter für diesen Server entsprechend einstellen. Siehe Maintaining Parameter Sets und Maintaining Parameter Sets.

    Wenn alles gut funktioniert, erhalten Sie eine Meldung:

    Starten von 'avantra_agent' mit der Eigenschaft 'agent.cfg': Senden von nohup-Ausgaben an nohup.out.
Fertig, läuft mit PID 4128818
Entfernen von 'agent-inst'

  10. Sie sollten den Avantra Agent in Ihren Systeminitialisierungsprozess einbinden. Wie dies erreicht wird, hängt vom Unix-Typ ab.

    Um den Avantra Agent manuell zu starten und zu stoppen, führen Sie einfach das rc-Skript entweder mit dem Parameter start oder stop aus. Dies kann entweder vom Benutzer root oder vom Benutzer avantra durchgeführt werden. Beispiel:

    root$ /syslink/agent/rc.agent start
agent läuft mit PID 12345
xandria$ /syslink/agent/rc.agent stop
Stoppen von 'avantra_agent' mit der Eigenschaft 'agent.cfg': Fertig

Unattended/Silent-Installation auf Unix-ähnlichen Betriebssystemen

Der Unix-Agent kann im Unattended (Silent)-Modus installiert werden. Dies ist nützlich, wenn der Agent auf vielen Servern mit Skripten installiert wird.

Folgende Optionen können eingestellt werden, um die Installation zu konfigurieren:

--

Erforderlich, um Argumente an das integrierte Selbstinstallationsskript zu übergeben.

--silent

Erforderlich. Schaltet die Unattended/Silent-Installation ein, ohne Fragen zu stellen.

--target-dir=vollständiger Pfad zum Zielverzeichnis

Optional. Pfad zum Zielverzeichnis, in dem der Agent installiert wird. Standard: <current working dir>/agent.

--jvm=beginnen Sie mit der Suche nach kompatiblen JVM in diesem Verzeichnis

Optional. Pfad zu dem Verzeichnis, in dem die Suche nach einer kompatiblen Java beginnt. Wenn nicht angegeben, wird die PATH-Umgebung durchsucht. Um eine bestimmte JVM zu verwenden, geben Sie den Pfad so spezifisch wie möglich an, z. B. /usr/lib/jvm/java-17/.

--port=<Nummer>

Optional. Der TCP/IP-Port, auf dem der Agent lauscht (Standard ist 9051).

--start=no

Optional. Starten Sie den Agent-Prozess nach der Installation nicht automatisch.

Example 1. Installieren Sie den Agenten in ./agent, finden Sie java und starten Sie ihn automatisch
./agent-24.0.n.bin -- --silent
Example 2. Installieren Sie den Agenten in einem separaten Verzeichnis mit einer separaten JVM, auf einem anderen Port und ohne automatischen Start
./agent-24.0.n.bin -- --silent --target-dir=/opt/agent --jvm=/usr/lib/jvm/java-17/ \
    --port=9052 --start=no

Installation mit automatischer Agentenregistrierung

Ab Avantra Version 21.11 haben Sie die Möglichkeit, unser neues Feature - Avantra Agent Self-Registration - zu nutzen. Diese Funktion ermöglicht es dem Avantra-Agenten, sich selbst zu registrieren, sodass Administratoren diese Aufgaben nicht mehr durchführen müssen.

Alle zuvor beschriebenen Voraussetzungen müssen erfüllt sein, d. h. Sie müssen die erforderlichen Berechtigungen überprüfen, ein Verzeichnis erstellen und die Agent-Binärdatei in das Installationsverzeichnis hochladen.

Um den Agenten im Selbstregistrierungsmodus auf Unix-Betriebssystemen zu starten, führen Sie den folgenden Befehl aus:

$> agent-24.0.n.bin -- --masterhost=yourmasterhost.x.y.z --custid=yourcustomerid

Um den Agenten im Selbstregistrierungsmodus auf Microsoft Windows zu starten, aktivieren Sie das Kontrollkästchen Self-Registration aktivieren im Installationsprogramm und füllen Sie die entsprechenden Felder aus.

Die folgende Tabelle listet alle verfügbaren Selbstregistrierungsoptionen für die Agenteninstallation auf.

Name Unix-Befehlszeilenoption Erforderlich Beschreibung

Master-Host

--masterhost=…​

Erforderlich (wenn die Master-Connect-Route nicht definiert ist)

FQDN oder IP-Adresse des Servers, wie er vom Agenten gesehen wird, wenn sich der Agent direkt mit dem Server verbindet

Master-Port

--masterport=…​

Optional

Listener-Port des Servers, wird nur verwendet, wenn der Server-Host angegeben ist. Wenn nicht definiert, wird 9050 verwendet.

Master-Connect-Route

--masterconnectroute=".."

Erforderlich (wenn Server-Host nicht definiert ist)

Route, die für den Agenten gültig ist, wenn der Server nicht direkt verbunden werden kann. Kopieren Sie diesen Wert aus dem Feld MasterConnectRoute der entsprechenden Route im Route-Konfigurator, siehe The Route Configurator.

Kunden-ID

--custid=…​

Erforderlich

Numerische Kunden-ID des Kunden, für den der Server registriert werden soll. Sie können die Kunden-ID in den Kundendetails in Avantra WebUI nachschlagen.

Agent-IP-Adresse

--ipaddress=…​

Optional

FQDN/IP-Adresse des Agenten, wie sie vom Server gesehen wird. Wenn dies nicht definiert ist, verwendet Avantra die Remote-IP-Adresse des Agenten, wenn der Server-Host verwendet wird, oder die Adresse des letzten Knotens in der Route, wenn die Server-Connect-Route verwendet wird.

Systemrolle

--srtype="…​"

Optional

Systemrollenname, der für den Server festgelegt werden soll. Wenn nicht definiert, wird Test festgelegt. Der Rollenname muss mit einer der Systemrollen in Einstellungen > Customizing > Systemrollen in Avantra WebUI übereinstimmen.

Agent-Port

--port=…​

Optional

Listener-Port des Agenten. Wenn nicht definiert, wird 9051 verwendet. Wenn festgelegt, lauscht der Agent auf diesem Port, und der Avantra-Server konfiguriert den entsprechenden AgentListenerPort-Überwachungsparameter für den Server.

Das Festlegen der Parameter MasterHost oder MasterConnectRoute führt dazu, dass sich der Agent während der Installation selbst registriert. Falls die Selbstregistrierung des Agenten aus irgendeinem Grund fehlschlägt, wird die Installation dennoch abgeschlossen.

Sobald der Avantra Server die Daten vom selbstregistrierten Agenten erhält, führt er die folgenden Schritte aus:

  • Erstellen eines Servers, falls dieser noch nicht existiert (Server werden mit dem Flag Automatisch erkannt erstellt)

  • Setzen der vom Parameter custid angegebenen Kunden

  • Setzen einer Systemrolle

Nach Abschluss der Installation navigieren Sie zu Avantra WebUI, wo der neu installierte Server/die neu installierten Server unter Systeme > Server angezeigt werden. Öffnen Sie die Serverdetails, überprüfen Sie die orangefarbenen Felder und drücken Sie Bestätigen. Diese Bestätigung ist aus Sicherheitsgründen erforderlich, und sobald sie erfolgt ist, beginnt die automatische Überwachung des Servers.

Installation mit systemd-Konfiguration auf Linux-Hosts

Ab Avantra Version 21.11 können Sie zusätzlich die systemd-Konfigurationsfunktion verwenden, die den Agenten automatisch als systemd-Dienst einrichtet.

Die systemd-Konfiguration kann zusammen mit der Agenten-Selbstregistrierungsfunktion oder unabhängig davon verwendet werden. Sie können den Agenten selbst registrieren lassen und ihn gleichzeitig als systemd-Dienst konfigurieren lassen. Sie können aber auch nur die Selbstregistrierung ohne systemd-Konfiguration durchführen und umgekehrt.

Um Ihren Agenten während der Installation als systemd-Dienst zu konfigurieren, müssen Sie das Installationsprogramm mit Superuser-Rechten ausführen.

Führen Sie den folgenden Befehl aus:

$> sudo agent-24.0.n.bin -- --systemd --user=youravantraosuser

Die folgende Tabelle listet alle verfügbaren systemd-Optionen für die Agenteninstallation auf.

Unix-Befehlszeile Erforderlich Beschreibung

--systemd

Erforderlich

Schalter zur Auslösung der systemd-Konfiguration.

--user=…​

Erforderlich*

OS-Benutzer, der als Anwendungsbesitzer und als Sudo-Benutzer für systemd-Operationen festgelegt wird. *Wenn Sie keinen Benutzer angeben, wird der Agent für den Benutzer 'root' erstellt, was dringend abgeraten wird.

--service=…​

Optional

Dienstname des systemd-Dienstes. Wenn nicht definiert, wird avantra-agent verwendet.

Eine systemd-Konfiguration löst die folgenden Aktionen auf dem Agent-Host aus:

  • Eine systemd-Dienstdatei für den Agenten wird erstellt und nach /etc/systemd/system/ verschoben.

  • Der systemd-Dienst wird aktiviert.

  • Eine sudoers-Datei für den angegebenen Benutzer wird erstellt und nach /etc/sudoers.d/ verschoben, die die Berechtigungen zum Starten, Stoppen und Neustarten des Agenten mit systemctl enthält.

Unabhängig von Fehlern während der systemd-Konfiguration wird die Agenteninstallation abgeschlossen. Überprüfen Sie daher, ob die systemd-Konfiguration erfolgreich war und der Agent läuft, indem Sie (passen Sie den Dienstnamen bei Bedarf an) ausführen:

$> sudo systemctl status avantra-agent