Installation des Agenten auf Microsoft Windows

Starten Sie die Microsoft-Installationsdatei agent-24.0.n-setup.exe und folgen Sie den Anweisungen auf dem Bildschirm:

  1. Drücken Sie auf dem Einführungsbildschirm Weiter.

  2. Lesen und akzeptieren Sie die Lizenzvereinbarung und klicken Sie auf Ich stimme zu.

  3. Wählen Sie den Installationsort aus und drücken Sie Weiter.

  4. Der Installer sucht nach einer geeigneten Java-Laufzeitumgebung.

    Wenn keine geeignete Java Virtual Machine automatisch gefunden wird, klicken Sie auf Java auswählen, um eine installierte Java Virtual Machine auszuwählen.

    Drücken Sie Weiter, um fortzufahren, wenn eine Java Virtual Machine definiert ist.

  5. Um einen benutzerdefinierten Agenten-Listener-Port festzulegen, falls der Standardport (9051) nicht übereinstimmt, aktivieren Sie das Kontrollkästchen Agent-Port setzen und geben Sie den benutzerdefinierten Port ein. Wenn die Porteinstellungen korrekt sind, drücken Sie Weiter, um fortzufahren.

    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.

  6. Auf der nächsten Seite können Optionen für die Selbstregistrierung des Agenten angegeben werden. Bitte beachten Sie Installation with automatic Agent registration

  7. Lesen Sie die Konfigurationsregeln der Windows-Firewall, die zu Ihrem System hinzugefügt werden. Drücken Sie Weiter, um fortzufahren.

  8. Auf dem nächsten Bildschirm können Sie einen anderen Dienstbenutzer festlegen. Der Avantra Agent-Dienst wird standardmäßig mit dem Benutzerkonto LocalSystem ausgeführt. Dieser Benutzer hat möglicherweise keine Berechtigung, auf Netzwerkressourcen zuzugreifen. Wenn einige der Profildaten Ihres SAP Systems sich auf entfernten (freigegebenen) Ressourcen befinden, wird das SAP System höchstwahrscheinlich nicht überwacht. In diesem Fall muss der Dienstbenutzer in einen Betriebssystembenutzer geändert werden, der berechtigt ist, auf die Netzwerkressourcen zuzugreifen (z. B. den Benutzer [sid]adm des SAP Systems).

    Es wird besonders empfohlen, den Benutzer [sid]adm des SAP Systems als Dienstbenutzer zu verwenden, insbesondere für Java-Only-SAP-Systeme, die mit einer MaxDB laufen.

    Wenn Sie das Benutzerkonto ausgewählt haben, drücken Sie Installieren, um fortzufahren.

  9. Warten Sie, bis die Installation des Avantra Agent abgeschlossen ist. Drücken Sie Weiter, um fortzufahren.

  10. Wählen Sie Avantra-Agent starten, um den Windows-Dienst jetzt zu starten. Sie können Avantra Agent auch später in den Windows-Diensten starten. Drücken Sie Fertigstellen, um die Installation abzuschließen.

Falls es Probleme mit der Installation gibt, finden Sie die Protokolldateien in %TEMP%\Avantra Installation Logs\

Unattended/Silent Installation auf Microsoft Windows Betriebssystemen

Der Avantra-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:

/S

Erforderlich. Startet den Agenten im Silent-Modus.

/JAVA_PATH

Erforderlich. Pfad zum Java-Installationsverzeichnis. NICHT auf java.exe oder jvm.dll verweisen, JAVA_PATH muss auf das Verzeichnis zeigen, in dem Java installiert ist.

/PORT

Erforderlich. Der für den Agenten verwendete Port (Standard ist 9051).

/START_SERVICE

Optional. Auf 1 setzen, wenn der Agent sofort nach der Installation gestartet werden soll.

/USER

Optional. Dienstbenutzer festlegen. Wenn nicht festgelegt, wird der Benutzer des Local System-Kontos verwendet.

/PASSWORD

Optional. Passwort des Dienstbenutzers festlegen. Nur erforderlich, wenn USER gesetzt ist (siehe oben).

/D

Optional. Installationspfad. Diese Einstellung muss die letzte sein! Leerzeichen sind erlaubt. Wenn Sie Leerzeichen verwenden, setzen Sie diese nicht in "". Wenn Sie den Pfad nicht festlegen, wird Avantra Agent in %ProgramFiles%\syslink\agent installiert.

Example 1. Installieren Sie den Agenten im Standardverzeichnis
agent-24.0.n.-setup.exe /S /JAVA_PATH="C:\Program Files\Java\jre-17" /PORT=9051
Example 2. Installieren Sie den Agenten in einem anderen Verzeichnis und starten Sie ihn automatisch
agent-24.0.n-setup.exe /S /JAVA_PATH="C:\Program Files\Java\jre-17" /PORT=9051 /START_SERVICE=1 /D=C:\syslink

Installation mit automatischer Agentenregistrierung

Ab Avantra Version 24.0 können Sie unser neues Feature - Avantra Agent Self-Registration - nutzen. Es ermöglicht dem Avantra-Agenten, sich selbst zu registrieren, wodurch Administratoren diese Aufgaben nicht mehr durchführen müssen.

Es gibt zwei Optionen, den Selbstregistrierungsmodus auf Microsoft Windows zu aktivieren:

  • Aktivieren Sie das Kontrollkästchen "Self-Registration aktivieren" im Installationsprogramm und füllen Sie die entsprechenden Felder aus:

Agenten-Selbstregistrierung

  • Verwenden Sie die folgenden Silent-Befehlszeilenoptionen:

agent-24.0.0-setup.exe /S /SELF_REG=direct /SR_MASTERHOST=masterhost /SR_MASTERPORT=9050 /SR_AGENTADDRESS=the.agent.com /SR_CUSTID=1 /SR_SYSTEMROLE=development

agent-24.0.0-setup.exe /S /SELF_REG=routing /SR_MASTERROUTE=masterroute:9050 /SR_AGENTADDRESS=the.agent.com /SR_CUSTID=1 /SR_SYSTEMROLE=development