OCI Linux

In diesem Abschnitt werden die Schritte zum Einrichten von Oracle Cloud Agent und zum Deployment der JMS-Plug-ins auf einer Oracle Linux-Compute-Instanz mit dem Installationsskript beschrieben. Befolgen Sie für Oracle Linux-Instanzen in verschiedenen Regionen und/oder Mandanten sowie für andere unterstützte Linux-Plattformen die Anweisungen unter On-Premise-Linux, um Oracle Management Agent einzurichten.

Hinweis

Der empfohlene Ansatz für das Onboarding von OCI-Linux-Instanzen in die Flotte besteht darin, die Aktion Verwaltete Instanzen hinzufügen der Flotte in der Ansicht Verwaltete Instanzen zu verwenden. Anweisungen dazu finden Sie im Abschnitt OCI Linux in der Manuellen Methode unter Management-Agent installieren und JMS-Plug-in bereitstellen.
Im Fall von OCI-Instanzpools müssen Sie den Agent einzeln für jeden Instanzteil des OCI-Instanzpools einrichten.

Voraussetzungen:

Führen Sie das Installationsskript mit sudo oder administrativem Zugriff aus.
Stellen Sie sicher, dass die folgende Policy hinzugefügt wird, bevor Sie das Installationsskript auf OCI Linux-Instanzen ausführen.
```
 ALLOW dynamic-group JMS_DYNAMIC_GROUP TO MANAGE instances IN
    COMPARTMENT <instance_compartment_ocid>
```

Anweisungen finden Sie unter OCI-Linux-Instanz für JMS einrichten.

Hinweis

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

Generieren Sie Nutzungstracker mit zusätzlichen Funktionen, um die Eigenschaft user.name für eine bessere Identifizierung von Anwendungen zu erfassen, die auf Anwendungsservern wie WebLogic und Tomcat ausgeführt werden. Wenn Sie dieses Feature nicht aktivieren möchten, aktualisieren Sie den Parameter --enable-user-name=false im Installationsskript. Sie können die Eigenschaftsdatei für Java Usage Tracker in Zukunft ändern, um user.name im Abschnitt additionalProperties hinzuzufügen oder daraus zu entfernen.
Deaktivieren Sie den FIPS-(Federal Information Processing Standards-)Modus für Plug-ins. Um den FIPS-Modus in USGov-Relams zu aktivieren, aktualisieren Sie den Parameter --enable-FIPS-mode=true im Installationsskript.
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-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. 
                              Format is --use-java-path={CUSTOM_PATH}(for example, --use-java-path=/usr/java/jdk1.8.0_361)).  
--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 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 endpoint? : No
	Check your internet connection and proxy setting.
Is clock sync with OCI platform? : Unknown
	The clock sync check was skipped. Can't read headers as provided OCI endpoint is not reachable.
Certificate verification has been passed? : Unknown
	The certificate check was skipped. Can't read certificate as provided OCI endpoint is not reachable.
Prerequisites for Oracle Cloud Agent were installed? : No
	OCI Metadata and Instance Config are not available but are required for installation.
	Try to manually install 'oci-metadata' and run the JMS_YourFleetName_linux_updated.sh script again.
	Or force Management Agent installation on the instance using the '--install-mgmt-agent' argument.
Meets Java requirement? : No
	Management Agent requires a minimum Oracle JDK 1.8 (1.8.0_281). The recommended version is 1.8.0_361 or later.
	Try to install Java manually and run the JMS_YourFleetName_linux_updated.sh script again.
Valid Management Agent installer? : No
	Found 0 files with the 'oracle.mgmt_agent*.rpm' pattern in the /home/opc folder.
	Run the JMS_YourFleetName_linux_updated.sh script again with the '--use-agent-installer-path' parameter.
Existing Management Agent has been detected? : No
=================================================================================================================================================================================
Diagnostics have failed. Please resolve all issues and run script JMS_YourFleetName_linux_updated.sh again.
Please refer troubleshooting guide https://docs.oracle.com/en-us/iaas/jms/doc/troubleshooting.html for more details.

A copy of this installation log can be found at /var/log/oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log

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 endpoint? : Yes
Certificate verification has been passed? : Yes
Is clock sync with OCI platform? : Yes
Meets Java requirement? : Yes
Certified OS for Oracle Cloud Agent? : Yes
Oracle Cloud Agent has been detected? : Yes
=======================================================================================================================================================
Diagnostics have finished running and no error occurred.

A copy of this installation log can be found at /var/log/oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log

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

Navigieren Sie zu dem Ordner, in dem Sie das Installationsskript 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>).

(Optional) Um zu prüfen, ob das JMS-Plug-in ausgeführt wird, führen Sie das folgende Skript auf Ihrem Linux-Rechner aus:
```
curl -H "Authorization: Bearer Oracle" http://169.254.169.254/opc/v2/instance/
```
Dabei ist 169.254.169.254 die IP-Adresse des OCI Compute-Instanzmetadatenservice.
Die folgende Meldung sollte angezeigt werden:
```
{
 "desiredState": "ENABLED",
 "name": "Oracle Java Management Service"
}
```

Die Logdateien befinden sich im Verzeichnis /var/log/oracle-cloud-agent/plugins/oci-jms/.

Oracle Cloud Infrastructure-Dokumentation

OCI Linux