On-Premises macOS

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

Voraussetzungen:

Führen Sie das Installationsskript mit sudo oder administrativem Zugriff aus, und erteilen Sie die Berechtigung "Full Disk Access".

Hinweis

Standardmäßig führt das Installationsskript folgende Schritte aus:
  • Generieren Sie den Nutzungstracker 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 dieses Feature nicht aktivieren möchten, aktualisieren Sie den Parameter --enable-user-name=false im Installationsskript. Sie können die Eigenschaftendatei des Java Usage Tracker 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. Um den FIPS-Modus in USGov-Relams zu aktivieren, aktualisieren Sie den Parameter --enable-FIPS-mode=true im Installationsskript.
  • Installieren Sie den Agent mit einer niedrigeren JMS-Telemetriehäufigkeit.

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

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 in Application Servers like Weblogic and Tomcat servers.
                            If you want to disable this feature, update the parameter --enable-user-name=false in the installation script.
                            Alternatively, modify /Library/Application Support/Oracle/Java/usagetracker.properties and add or remove 'user.name' in 'additionalProperties'.
                            Default value is true.
--enable-fips-mode          Enable FIPS mode for plugins in USGov realms.
                            Format is --enable-fips-mode=true|false (for example, --enable-fips-mode=false).
                            Modify /etc/bashrc and create a line with ENV_AGENT_PLUGIN_FIPS_APPROVED=true or false.
                            Without this parameter script won't change anything in /etc/bashrc file.
--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. All proxy parameters are optional.
--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-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").
--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").
--use-agent-installer-path  Use this file to set up Management Agent. Optional parameter.
                            If exists, script won't try to find installation files in current folder.   
                            Use the absolute path and not a relative path. For example, --use-agent-installer-path="User/testuser/Downloads"
--use-java-path             Use the Java Installation on this path to set up Management Agent. Optional parameter
                            Use the absolute path and not a relative path. Format is --use-java-path="JAVA_PATH" 
                            (for example, --use-java-path=/Library/Java/JavaVirtualMachines/jdk1.8.jdk/Contents/Home). 
--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

  1. (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_macos.sh --diagnostic
    Je nach Betriebssystem und Agent-Typ werden folgende Ergebnisse angezeigt:

    Diagnose nicht erfolgreich:

    ======================================================================================================
    Diagnostic Summary
    ======================================================================================================
    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
    Available Java for agent installation ? : Yes
    Management Agent installer available? : No
    	Script JMS_YourFleetName_macos.sh can't find the Management Agent installer /kkk.
    	Check if the path /kkk exists and check 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_macos.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 /Library/Oracle/JMSInstallScript/JMSInstallScriptLogs-<date>.log
    
    Diagnose erfolgreich abgeschlossen:
    ======================================================================================================
    Diagnostic Summary
    ======================================================================================================
    User has sudo/root privileges? : 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
    Existing Management Agent has been detected? : No
    Available Java for agent installation ? : Yes
    Management Agent installer available? : Yes
    ======================================================================================================
    Diagnostics have finished running and no error occurred.

    Eine vollständige Liste der Kriterien, die während der Diagnose geprüft wurden, sowie Lösungen oder Empfehlungen finden Sie unter Agent-Installationsdiagnose ausführen.

  2. 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_macos.sh
    • Wenn die Installation erfolgreich verläuft, wird eine Meldung wie die Folgende angezeigt:
      ...
      Management Agent installation has been completed with 'Java Usage Tracking service plugin (Service.plugin.jms)'
      JMS basic features will be enabled on this instance.
      Management Agent installation has been completed with 'Java Management service plugin (Service.plugin.jm)'
      JMS advanced features can be enabled on this instance.
      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 die Agent-Software gegebenenfalls auf die neueste Version. Wenn JMS-Plug-ins noch nicht bereitgestellt sind, stellen Sie Java Usage Tracking- und Java Management Service-Plug-ins manuell bereit, wie unter Service-Plug-ins mit der Seite "Agents" bereitstellen beschrieben. Sie können den Agent auch zusammen mit dem JMS-Plug-in-Deployment neu installieren und das Skript mit dem Parameter --force ausführen.
  3. (Optional) Um zu prüfen, ob Management Agent ausgeführt wird, geben Sie Folgendes ein:
    $ sudo launchctl print system/com.oracle.macs.agent.mgmt_agent | grep state
    Die Ergebnisse zeigen:
    state = running

    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 /Library/Oracle/mgmt_agent/plugins/jm/stateDir/log.