Linux vor Ort

In diesem Abschnitt werden die Schritte zum Einrichten von Oracle Management Agent und zum Bereitstellen der JMS-Plug-ins auf einem On-Premise-Linux-Host mit dem Installationsskript beschrieben.

Voraussetzungen:

Führen Sie das Installationsskript mit sudo oder administrativem Zugriff aus.

Hinweis

Standardmäßig führt das Installationsskript folgende Schritte aus:

Erstellen oder aktualisieren Sie die Java Usage Tracker-Eigenschaftendatei mit zusätzlichen Funktionen zur Erfassung der Eigenschaft user.name, um Anwendungen besser zu identifizieren, die auf Anwendungsservern wie WebLogic und Tomcat ausgeführt werden. Wenn Sie diese Funktion nicht aktivieren möchten, führen Sie das Installationsskript mit dem Argument --enable-user-name=false aus. Sie können die Eigenschaftendatei für den Java-Nutzungstracker in Zukunft ändern, um user.name zum Abschnitt additionalProperties hinzuzufügen oder daraus zu entfernen.
Deaktivieren Sie den FIPS-(Federal Information Processing Standards-)Modus für Plug-ins.
Das Plug-in liest die Systemumgebungsvariable ENV_AGENT_PLUGIN_FIPS_APPROVED. Wenn es gefunden wird, aktivieren Sie den FIPS-Modus für Plug-ins. USGov relams. Um diese Variable zu erstellen oder zu ändern, führen Sie das Installationsskript mit dem Argument --enable-fips-mode=true aus.
Installieren Sie den Agent mit der MACS-Standardtelemetriehäufigkeit.

Führen Sie den Befehl --help aus, um die Beschreibung der Optionen anzuzeigen, wie das Aktivieren oder Deaktivieren von Benutzernamen, Proxyeinstellungen, FIPS usw.

Im Folgenden werden die optionalen Parameter zusammen mit der Beschreibung aufgeführt:


-u, --uninstall               Uninstall plug-ins, delete configuration files or restore originals from backups and exit.
-r, --reinstall               Uninstall plug-ins, delete configuration files or restore originals from backups and continue installation.
-h, --help                    Print usage message end exit.
--diagnostic                  Determines if prerequisite conditions are met on the host machine to allow for successful agent installation or upgradation, and plug-in deployment. 
                              Installation attempt will be skipped.
--enable-user-name            Generate usage tracker with additional functionality to collect the 'user.name' property for better identification 
                              of applications running on Application Servers like WebLogic and Tomcat servers. 
                              Default value is 'true'. 
--enable-fips-mode            Enable FIPS mode for plug-ins in USGov realms.
                              Format is --enable-fips-mode=true|false (for example, --enable-fips-mode=false).
                              Modify /etc/environment and create a line with ENV_AGENT_PLUGIN_FIPS_APPROVED=true or false.
                              Default value is false.
--install-management-agent    Installation of OMA on the OCI compute instance.                               
--uninstall-management-agent  Uninstallation of OMA on the OCI compute instance.                                
--reinstall-management-agent  Force OMA installation on the OCI compute instance and remove existing OMA.                               
--ignore-unsupported          The setup will proceed on an unsupported platform. 
                              Installation might be successful, but not all functionality might work as intended.
--proxy-host                  Add proxy host to curl commands, add or replace line 'ProxyHost = VALUE' in install key before Management Agent setup.
                              Format is --proxy-host="VALUE" (for example, --proxy-host="100.0.0.10").
                              Default is no proxy.
--proxy-port                  Add proxy port to curl commands, add or replace line 'ProxyPort = VALUE' in install key before Management Agent setup.
                              Format is --proxy-port="VALUE" (for example, --proxy-port="8050").
--proxy-user                  Add proxy user to curl commands, add or replace line 'ProxyUser = VALUE' in install key before Management Agent setup.
                              Format is --proxy-user="VALUE" (for example, --proxy-user="opc").
--proxy-password              Add proxy password to curl commands, add or replace line 'ProxyPassword = VALUE' in install key before Management Agent setup.
                              Format is --proxy-password="VALUE" (for example, --proxy-password="example").
--proxy-realm                 Add or replace line 'ProxyRealm = VALUE' in install key before Management  Agent setup.
                              Format is --proxy-realm="VALUE" (for example, --proxy-realm="OC1").
--use-agent-installer-path    Path to management agent installation file if it isn't in the same folder as the install script.  
                              Use the absolute path and not a relative path. For example, --use-agent-installer-path="home/testuser/Downloads"
--use-java-path               Specify the Oracle Java 8 installation path for agent installation.  
                              If the path is not specified, the script will attempt to find a suitable Oracle Java 8 installation path from the file system. 
                              Use the absolute path and not a relative path. Format is --use-java-path={CUSTOM_PATH}(for example, --use-java-path=/usr/java/jdk1.8.0_451).       
--use-agent-display-name      Specify the name to be displayed on the MACS console of your Management Agent.
                              If the name is not specified, the script will generate the name automatically.

Schritte

(Optionale Diagnoseprüfung) Navigieren Sie zu dem Ordner, in dem Sie das Installationsskript und die Management Agent-Software gespeichert haben. Führen Sie das Skript mit dem folgenden Befehl aus:

$ sudo bash ./JMS_YourFleetName_linux.sh --diagnostic

Je nach Betriebssystem und Agent-Typ werden folgende Ergebnisse angezeigt:

Diagnose nicht erfolgreich:

======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI https://oracle.com endpoint? : Yes
Meets Java requirement? : Yes
Valid Management Agent installer? : No    
   Found 2 files with 'oracle.mgmt_agent*.rpm' pattern in /home/opc folder.    
   Please, run script test_linux.sh again with --use-agent-installer-path parameter.
Management Agent has been detected? : No
======================================================================================================
Diagnostics have failed. Please resolve all issues and run script test_linux.sh again.

Diagnose erfolgreich abgeschlossen:

======================================================================================================
Diagnostic Summary
======================================================================================================
Shell is supported? : Yes
User has sudo/root privileges? : Yes
Certified OS? : Yes
Meets minimum disk requirements? : Yes
Meets minimum memory requirements? : Yes
Able to reach OCI https://oracle.com endpoint? : Yes
Meets Java requirement? : Yes
Valid Management Agent installer? : Yes
Existing Management Agent has been detected? : Yes
Existing Management Agent has JMS plugins? : Yes
Existing Management Agent can be upgraded? : Yes
======================================================================================================
Diagnostics have finished running and no error occurred.

Eine vollständige Liste der Fragen mit Lösungen oder Empfehlungen finden Sie unter Agent-Installationsdiagnose ausführen.

Wechseln Sie zu dem Ordner, in dem Sie das Installationsskript und die Management Agent-Software gespeichert haben. Führen Sie das Skript mit dem folgenden Befehl aus:
```
$ sudo bash ./JMS_YourFleetName_linux.sh
```
- Bei erfolgreicher Installation wird eine Meldung wie die Folgende angezeigt:
```
...
Management Agent installation has been completed.
Management Agent plugin 'Java Management Service' installation has been completed.
Management Agent plugin 'Java Usage Tracking' installation has been completed.
Management Agent was successfully registered using key YourFleetName (ocid1.managementagentinstallkey.oc1.iad.<ocid hash>).Assigned JMS Fleet is YourFleetName (ocid1.jmsfleet.oc1.iad.<ocid hash>).
```
- Falls der Agent bereits installiert ist, aktualisiert das Skript gegebenenfalls die Agent-Software auf die neueste Version. Wenn JMS-Plug-ins noch nicht bereitgestellt werden, stellen Sie die Plug-ins Java Usage Tracking und Java Management Service manuell bereit, wie unter Service-Plug-in mit der Seite "Agents" bereitstellen beschrieben. Sie können den Agent auch zusammen mit dem JMS-Plug-in-Deployment neu installieren. Führen Sie das Skript mit dem Parameter --force aus.

(Optional) Um zu prüfen, ob Management Agent ausgeführt wird, geben Sie Folgendes ein:

$ sudo systemctl status mgmt_agent

Die Ergebnisse werden angezeigt:

mgmt_agent.service - mgmt_agent
   Loaded: loaded (/etc/systemd/system/mgmt_agent.service; enabled; vendor preset: disabled)
   Active: active (running) since Wed 2022-08-24 07:05:38 GMT; 24s ago
  Process: 1772 ExecStart=/opt/oracle/mgmt_agent/agent_inst/bin/agentcore start sysd (code=exited, status=0/SUCCESS)
 Main PID: 1864 (wrapper)
   Memory: 414.6M
   CGroup: /system.slice/mgmt_agent.service
           ├─1864 /opt/oracle/mgmt_agent/agent_inst/bin/./wrapper /opt/oracle/mgmt_agent/agent_inst/bin/../config/wrapper.conf wrapper.syslog.ident=mgmt_agent wrapper.pidfile=/opt/oracle/mgmt_agent/agent_inst/bin/../log...
           └─2171 /usr/java/jdk1.8.0_301-amd64/bin/java -Dorg.tanukisoftware.wrapper.WrapperSimpleApp.maxStartMainWait=5 -Djava.security.egd=file:///dev/./urandom -XX:+HeapDumpOnOutOfMemoryError -Dpolyglot.engine.AllowE...

Aug 24 07:05:21 name-agent-stage systemd[1]: Starting mgmt_agent...
Aug 24 07:05:21 name-agent-stage agentcore[1772]: Removed stale pid file: /opt/oracle/mgmt_agent/agent_inst/bin/../log/mgmt_agent.pid
Aug 24 07:05:21 name-agent-stage agentcore[1772]: Starting mgmt_agent...
Aug 24 07:05:33 name-agent-stage agentcore[1772]: Waiting for mgmt_agent..............
Aug 24 07:05:34 name-agent-stage sudo[2752]: mgmt_agent : TTY=unknown ; PWD=/opt/oracle/mgmt_agent/agent_inst/bin ; USER=root ; ENV=ORACLE_CLOUD_AGENT_PLUGIN_COOKIE=<Cookie_ID> LOGDIR=/opt/or...
Aug 24 07:05:38 name-agent-stage systemd[1]: Started mgmt_agent.

Sie können auch die Konsole anzeigen, um zu prüfen, ob der Management Agent ausgeführt wird. Weitere Informationen finden Sie unter Überblick über die Management Agent-Konsole.

Die Logdateien befinden sich im Verzeichnis /opt/oracle/mgmt_agent/plugins/jm/stateDir/log.

Oracle Cloud Infrastructure-Dokumentation

Linux vor Ort