Management-Agents installieren
Nachdem Sie die unter Voraussetzungen für das Deployment von Management-Agents ausführen beschriebenen Voraussetzungen erfüllt haben, führen Sie die folgenden Schritte aus, um die Management-Agents zu installieren.
- Schritt 1: Management Agent-Software herunterladen
- Schritt 2: Installationsschlüssel erstellen
- Schritt 3: Antwortdatei konfigurieren
- Schritt 4: Management-Agent installieren
- Schritt 5: Management Agent-Installation überprüfen
- Probleme bei der Management Agent-Installation beheben
Weitere Informationen, einschließlich der Installation von Management Agent auf allen Betriebssystemen und der Möglichkeit, Management Agent herunterzuladen, finden Sie in den folgenden Anweisungen.
Laden Sie die Management Agent-Software herunter
Option 1: Management Agent-Software mit der Oracle Cloud-Konsole herunterladen
In der Oracle Cloud-Konsole können Sie die Management Agent-Software wie folgt herunterladen:
- Klicken Sie in der Oracle Cloud-Konsole auf das Navigationsmenü, gehen Sie zu "Beobachtbarkeit und Management", und wählen Sie unter "Management-Agents" die Option Downloads und Schlüssel aus.
- Wählen Sie das Betriebssystem aus den Optionen für den Softwaredownload.
- Wählen Sie im Bereich Softwaredownload in der Spalte Herunterladen das Betriebssystem aus, unter dem der Management Agent installiert werden soll.
- Klicken Sie auf den Link für Ihr Betriebssystem, um die Agent-Softwaredatei herunterzuladen.
Exadata-Umgebungen: Um Management Agent auf Exadata und Exadata Cloud einschließlich Cloud@Customer und auf Oracle Cloud Infrastructure zu installieren, müssen Sie die Anweisungen zum Installieren von Management Agent auf einem externen Volume mit einer Linux-ZIP-Datei befolgen.Hinweis
Der RPM-Packagetyp für Linux wird in Exadata nicht unterstützt.Beispiel: Klicken Sie unter Windows auf Agent für WINDOWS (X86_64).
Die Softwaredatei wird jetzt auf Ihrem Host gespeichert.
Nach dem Herunterladen der Datei können Sie die Dateiintegrität prüfen, indem Sie den Wert der Spalte SHA-256 Checksum prüfen. Beispiel: Wenn Sie Linux verwenden, sollte es mit der Ausgabe des folgenden Befehls übereinstimmen: sha256sum <download_file>
Option 2: Management Agent-Software mit CLI herunterladen
- Rufen Sie den Wert
object-url
mit dem CLI-Befehl agent-image list ab.oci management-agent agent-image list --compartment-id <tenancyId>
Der Rückgabewert
object-url
ähnelt dem folgenden Wert:https://objectstorage.<region_identifier>.oraclecloud.com/n/<namespace>/b/<bucketName>/o/Linux-x86_64/latest/oracle.mgmt_agent.rpm
Notieren Sie sich die Werte <namespace> und <bucketName>.
- Laden Sie die Management Agent-Software mit dem authentifizierten OCI-Principal mit den Werten <namespace> und <bucketName> aus Schritt 1 herunter:
-
Unter Linux:
oci os object get --namespace <namespace> --bucket-name <bucketName> --name Linux-x86_64/latest/oracle.mgmt_agent.rpm --file oracle.mgmt_agent.rpm
-
Unter Windows Server:
oci os object get --namespace <namespace> --bucket-name <bucketName> --name Windows-x86_64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
-
Für Solaris:
oci os object get --namespace <namespace> --bucket-name <bucketName> --name Solaris-Sparc64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
-
Für AIX:
oci os object get --namespace <namespace> --bucket-name <bucketName> --name AIX-ppc64/latest/oracle.mgmt_agent.zip --file oracle.mgmt_agent.zip
- Für Linux ARM:
oci os object get --namespace <namespace> --bucket-name <bucketName> --name Linux-Aarch64/latest/oracle.mgmt_agent.rpm --file oracle.mgmt_agent.rpm
-
Für macOS und Windows-Desktop: Management Agent wird bei Verwendung des Java Management-Service unterstützt. Weitere Informationen finden Sie unter Java Management-Service, insbesondere im Abschnitt Management-Agent installieren.
3 Nach dem Herunterladen der Datei können Sie die Dateiintegrität prüfen, indem Sie den Wert der Spalte SHA-256 Checksum prüfen. Beispiel: Wenn Sie Linux verwenden, sollte es mit der Ausgabe des folgenden Befehls übereinstimmen:
sha256sum <download_file>
-
Option 3: Management Agent-Software mit der REST-API herunterladen
So laden Sie die Management Agent-Software herunter:
- Details zur REST-API
ListManagamentAgentImages
mit gültiger OCI-Authentifizierung finden Sie in der REST-API-DokumentationListManagementAgentImages
. - Rufen Sie den Wert von
object-url
aus der Ausgabe ab, und laden Sie die Management Agent-Software mit dieser URL herunter. Weitere Informationen finden Sie in der Dokumentation zur Object Storage Service-API im VorgangGetObject
.
Installationsschlüssel erstellen
Sie müssen einen Installationsschlüssel erstellen, bevor Sie Management Agent installieren können.
Ein Installationsschlüssel wird für Ihre Identitätsdomain ausgegeben und validiert die Authentizität der Installation. Stellen Sie sicher, dass Sie den Installationsschlüssel erstellen, bevor Sie die Management Agent-Installation starten.
So erstellen Sie einen Installationsschlüssel:
- Klicken Sie auf der Management Agent-Homepage im linken Menü auf Downloads und Schlüssel, um den Bereich Installationsschlüssel anzuzeigen.
Der Bereich Installationsschlüssel wird unten auf der Seite angezeigt.
-
Klicken Sie im Bereich Installationsschlüssel auf Schlüssel erstellen, um einen Schlüssel zu erstellen.
-
Geben Sie im Fenster Schlüssel erstellen die erforderlichen Details ein.
-
Geben Sie im Feld Schlüsselname einen Namen zur Identifizierung des Schlüssels an.
-
Wählen Sie im Feld Compartment in der Dropdown-Liste das Compartment aus. Dies ist das Compartment, in dem die Agent-Ressource erstellt wird.
-
Geben Sie im Feld Maximale Installationen die Höchstanzahl der Installationen an, die mit dem Schlüssel verknüpft werden können. Der Standardwert ist 1000.
-
Geben Sie im Feld Gültig für den Gültigkeitszeitraum des Schlüssels an. Der Standardwert ist 1 Woche.
-
Das Kontrollkästchen Unbegrenzt ist optional.
Bei Auswahl kann der Schlüssel für eine unbegrenzte Anzahl von Agent- und Gatewayinstallationen verwendet werden, und der Schlüssel läuft nie ab.
Risiken für die Verwendung unbegrenzter Schlüssel: Oracle empfiehlt, die Lebensdauer eines Installationsschlüssels auf einen minimal erforderlichen Zeitraum und eine begrenzte Anzahl von Agents zu beschränken. Stellen Sie sicher, dass Sie den heruntergeladenen Schlüssel an einem sicheren Ort aufbewahren, um die Vertraulichkeit zu erhalten. Wenn der unbegrenzte Installationsschlüssel gefährdet ist, kann ein Angreifer Rogue-Agents in Ihrem Mandanten installieren. Mit einem regelmäßigen Audit der Agents Ihres Mandanten können potenzielle Risiken im Zusammenhang mit unbegrenzten Installationsschlüsseln gemindert werden. Wenn kein unbegrenzter Installationsschlüssel mehr benötigt wird, müssen Sie ihn entweder mit der Management Agents-Konsole oder der CLI löschen.
Ein neuer Schlüssel wird erstellt.
-
Im Bereich Installationsschlüssel stehen verschiedene Optionen zur Verwaltung der Schlüssel zur Verfügung. In einem späteren Schritt ist die Option Schlüssel in Datei herunterladen nützlich, um eine Datei herunterzuladen, die als Antwortdateivorlage verwendet werden kann, wie unter Antwortdatei konfigurieren beschrieben.
Weitere Informationen zum Verwalten der Installationsschlüssel finden Sie unter Installationsschlüssel verwalten.
Wenn Sie ein Management Gateway installieren, können Sie Management Gateway und Management Agent mit demselben Installationsschlüssel installieren. Informationen zu Management Gateway finden Sie unter Management Gateway.
Antwortdatei konfigurieren
Das Management Agent-Installationsskript verwendet eine Antwortdatei, um die für Ihre Umgebung spezifischen Agent-Parameter zu lesen.
Agent-Parameter prüfen
Bei der Ausführung des Agent-Setupskripts ist eine Antwortdatei mit den Agent-Parametern erforderlich.
Im folgenden Abschnitt werden die in der Antwortdatei unterstützten Parameter beschrieben:
Tabelle 3-1: Antwortdateiparameter
Parametername | Parametertyp | Beschreibung |
---|---|---|
ManagementAgentInstallKey |
Obligatorisch | Installationsschlüssel, der zur Validierung der Identität der Domain und der Authentizität der Installation erforderlich ist. |
CredentialWalletPassword |
Optional | Kennwort des Agent-Wallets, wenn der Benutzer ein benutzerdefiniertes Kennwort für das Wallet zum Speichern sensibler Informationen angibt.
Das Kennwort muss mindestens 8 Zeichen enthalten und folgende Spezifikationen erfüllen:
Alle Zeichen des Kennworts müssen aus den oben definierten Zeichen stammen. Beispiel: Wenn das Kennwort das Zeichen |
GatewayServerHost |
Optional | Hostname oder Adresse des Management Gateway-Servers oder -Proxyservers.
Wenn angegeben, muss auch Wenn Management Gateway im High Availability-Modus konfiguriert ist, müssen Sie den Hostnamen des Load Balancers als |
GatewayServerPort |
Optional | Portnummer des Management Gateway-Servers oder Proxy-Servers.
Wenn angegeben, muss auch Wenn Management Gateway im High-Availability-Modus konfiguriert ist, müssen Sie die Load-Balancer-Portnummer als |
GatewayServerUser |
Optional | Benutzername, wenn der Management Gateway-Server oder der Proxy-Server eine Authentifizierung erfordert.
Wenn angegeben, muss auch |
GatewayServerPassword |
Optional | Kennwort, wenn der Management Gateway-Server oder der Proxy-Server eine Authentifizierung erfordert.
Wenn angegeben, muss auch |
GatewayServerRealm |
Optional | Die Authentifizierungs-Realm für den Proxyserver.
Bei Verwendung von Management Gateway ist dieser Wert nicht erforderlich. |
AgentDisplayName |
Optional | Der Anzeigename für den Agent. Wenn dieser Wert nicht angegeben wird, ist der Standardwert Agent (host-name) .
|
Service.plugin.<plugin_name>.download=true |
Optional | Der Name des Plug-ins, das Sie während der Agent-Installation bereitstellen möchten. <plugin_name> ist ein vom Management Agent-Service unterstütztes Plug-in.
Beispiel: Wenn Sie das DataSafe-Plug-in während der Agent-Installation bereitstellen möchten, lautet der Wert |
FreeFormTags = [{"<key1>":"<value1>"}, {"<key2>":"<value2>"}] |
Optional | Die Tagmetadatenverknüpfung, wenn Tags in OCI verwendet werden.
Sie besteht aus einem Schlüssel und einem Wert. Der Schlüssel ist ein beliebiger Name, mit dem Sie das Tag referenzieren. Der Wert ist der Wert, den der das Tag anwendende Benutzer dem Tagschlüssel hinzufügt. Wenn dieser Management Agent für die Verbindung über ein Management Gateway konfiguriert ist, fügen Sie unter Verknüpfter Agent ein Tag mit dem Namen Beispiel: |
DefinedTags = [{"namespace1":{"<key1>":"<value1>"}}, {"namespace2":{"<key2>":"<value2>"}}] |
Optional | Die Tagmetadatenverknüpfung, wenn Tags in OCI verwendet werden. Der Tagadministrator erstellt und verwaltet alle Tags, die Benutzer auf Ressourcen anwenden. Die Benutzer müssen Tag-Policys definieren.
Der Tag-Namespace ist ein Container für die Tagschlüssel. Der Tagschlüssel ist ein Schlüssel innerhalb des Namespace. Sie müssen Tagschlüssel für definierte Tags in einem Namespace erstellen. Bei definierten Tags hat der Tagwert einen Typ, der entweder eine Zeichenfolge oder eine Liste von Zeichenfolgen sein kann. Wenn beim Definieren des Tagwerttyps der definierte Typ eine Zeichenfolge war, kann ein beliebiger Wert eingegeben werden. Wenn dagegen eine Liste von Zeichenfolgen definiert wurde, muss dieser Wert eine Zeichenfolge aus dieser Liste sein. Im folgenden Beispiel gibt es 2 Namespaces
|
GatewayServerRootCACertOcid |
Optional | Dieser Parameter ist ab Agent-Version 221019.0021 verfügbar.
Wenn der Agent eine Verbindung zu einem Managementgateway der Version 221019.0021.1667404647 oder höher herstellt, wird die Verbindung verschlüsselt. Dieser Parameter gibt die |
importTrustedCertsDirectory |
Optional |
Speicherort der zusätzlichen Root-CA-Zertifikate im PEM-Format. Verwenden Sie diesen Parameter, wenn Sie zusätzliche Root-CA-Zertifikate im PEM-Format hinzufügen möchten. Der Management Agent hat in diesem Verzeichnis gesucht und die Zertifikate während der Installation hinzugefügt. Beispiel: |
maxHeapInMb |
Optional | Maximaler Heap in Megabyte.
Der Standard-Heap-Wert beträgt 512 MB. Verwenden Sie diesen Parameter, um den Agent so zu optimieren, dass mehr Heap verwendet wird, wenn Sie vor der Installation wissen, dass der Agent mit einer großen Last konfiguriert wird, wie Logs und Datenbanken. Beispiel: |
BufferingEnabled |
Optional | Ermöglicht die Pufferung für verschiedene Endpunkte über Management Gateway, wie Log Analytics- und Object Storage-OCI-Services. |
Antwortdatei erstellen
Stellen Sie sicher, dass Sie die unter Agent-Parameter prüfen angegebenen Informationen gelesen und verstanden haben, bevor Sie fortfahren.
Um Agents zu installieren und zu konfigurieren, müssen Sie eine Antwortdatei erstellen und ein Skript mit der neu erstellten Antwortdatei ausführen, das den Agent auf die korrekte OCI-Region verweist und die Erstellung einer Ressource für den Agent ermöglicht.
Prüfen Sie beim Erstellen einer Antwortdatei den Dateispeicherort und die Berechtigungen. Stellen Sie sicher, dass die Antwortdatei Leseberechtigungen für den BS-Benutzer
mgmt_agent
hat.
Verwenden Sie zum Erstellen einer Antwortdatei eine der folgenden Optionen:
Option 1: Antwortdateivorlage zum Erstellen einer Antwortdatei herunterladen
Sie können eine Vorlagendatei mit den Agent-Parametern herunterladen, die während der Agent-Installation gespeichert und als Antwortdatei verwendet werden kann.
-
Klicken Sie im linken Menü auf Downloads und Schlüssel, um den Bereich Agent-Installationsschlüssel zu öffnen. Wählen Sie in der Liste der Agent-Installationsschlüssel den Schlüssel aus, den Sie herunterladen möchten.
-
Klicken Sie rechts neben dem ausgewählten Schlüssel auf das Aktionsmenü
, und wählen Sie Schlüssel in Datei herunterladen aus.
Eine Datei wird heruntergeladen. Weitere Informationen finden Sie unter Installationsschlüssel herunterladen.
Beim Herunterladen des Agent-Installationsschlüssels in eine Datei enthält die heruntergeladene Datei die Agent-Parameter, darunter den Wert des spezifischen Agent-Installationsschlüssels.
- Öffnen Sie die Datei mit einem Texteditor, prüfen Sie sie, und bearbeiten Sie die obligatorischen Agent-Parameter. Siehe Agent-Parameter prüfen.
- Kommentieren Sie die für Ihre spezifische Agent-Konfiguration nicht erforderlichen Agent-Parameter aus (fügen Sie das Zeichen
#
am Anfang der Zeile ein), oder entfernen Sie diese Parameter. - Entfernen Sie die Kommentarzeichen (
#
am Anfang der Zeile) der für Ihre spezifische Agent-Konfiguration erforderlichen Agent-Parameter, und aktualisieren Sie bei Bedarf die Werte der Agent-Parameter. - Speichern Sie die aktualisierte Antwortdatei. Beispiel: Die Antwortdatei kann als
input.rsp
gespeichert werden.
Option 2: Antwortdateien mit einem Texteditor erstellen
Sie können eine Antwortdatei manuell mit einem Texteditor erstellen. Beispiel: Sie können eine Datei mit Ihrem bevorzugten Texteditor erstellen, die für Ihre Agent-Konfiguration erforderlichen Agent-Parameter hinzufügen und die Antwortdatei speichern. Beispiel: Die Antwortdatei kann als input.rsp
gespeichert werden.
input.rsp
:managementAgentInstallKey = MS4wLHVzLWFzaGJ1cm4tMSxvY2lkMS50ZW5hbmN5
CredentialWalletPassword = Abcdefgh1#
Prüfen Sie nach dem Erstellen der Antwortdatei mit einer der obigen Optionen die Dateiberechtigungen, und stellen Sie sicher, dass Leseberechtigungen für den Benutzer mgmt_agent
(BS-Benutzer, der während des Management Agent-Installationsprozesses erstellt wurde) erteilt wurden.
Management Agent installieren
Nachdem Sie die Agent-Software heruntergeladen, einen Installationsschlüssel und eine Antwortdatei erstellt haben, können Sie mit der Installation des Management Agent fortfahren, um Daten aus den Quellen zu sammeln, die Sie über Oracle Cloud Infrastructure verwalten und überwachen möchten.
- Management Agent auf Linux installieren (RPM-Datei)
- Management Agent auf Linux (ZIP-Datei) installieren
- Management Agent auf dem Mac installieren
- Management Agent auf Windows Server installieren
- Management Agent auf Windows Desktop installieren
- Management Agent unter Solaris installieren
- Management Agent auf AIX installieren
- Mehrere Management Agents installieren
-
Exadata: Um Management Agent auf Exadata und Exadata Cloud zu installieren, laden Sie Management Agent mit der ZIP-Dateeinstallationsmethode herunter, und installieren Sie ihn, um Probleme mit Exadata-Lebenszyklusmanagementvorgängen zu vermeiden. Verwenden Sie die RPM-Installation nicht in Exadata-Deployments, einschließlich On Premise, Cloud@Customer und Oracle Cloud Infrastructure. Stellen Sie bei Exadata Cloud-Deployments in Cloud@Customer und Oracle Cloud Infrastructure sicher, dass der Management Agent im Dateisystem
/u02
installiert ist.Anweisungen zur Installation finden Sie unter Management Agent auf einem externen Volume mit Linux-ZIP-Datei installieren.
Weitere Einzelheiten und wichtige Überlegungen bei der Installation von Management Agent in Exadata Cloud finden Sie unter OCI: Observability & Management Support For Exadata Cloud Dok.-ID 3015115.1 auf My Oracle Support.
-
Massen-Deployment: Das Massen-Deployment von Management Agent wird unterstützt. Weitere Informationen finden Sie im Tutorial Oracle Management Agent - Bulk-Deployment mit Ansible-Playbooks.
-
Sie können Management Agent auf mehreren virtuellen Maschinen installieren. Einzelheiten finden Sie im Video OCI Management Agent: So installieren Sie Management Agent über mehrere virtuelle Maschinen hinweg.
Management Agent auf Linux installieren (RPM-Datei)
Exadata: Verwenden Sie die RPM-Installation nicht auf Exadata-Deployments, einschließlich On-Premises, Cloud@Customer und Oracle Cloud Infrastructure. Anweisungen zur Installation finden Sie unter Management Agent auf einem externen Volume mit Linux-ZIP-Datei installieren.
- Melden Sie sich als Benutzer mit
sudo
-Berechtigungen an. Wenn Sie den Standardbenutzer ändern möchten, finden Sie weitere Informationen unter Nicht standardmäßigen BS-Benutzer zum Installieren von Management Gateway verwenden. - Installieren Sie die Agent-Software.
Navigieren Sie zu dem Verzeichnis, in das Sie die
RPM
-Datei der Management Agent-Software heruntergeladen haben, und führen Sie den folgenden Befehl aus, um dieRPM
-Datei zu installieren:sudo rpm -ivh <rpm_file_name.rpm>
Beispiel:
sudo rpm -ivh oracle.mgmt_agent-<VERSION>.rpm
Die Ausgabe sollte wie folgt aussehen:Preparing... ################################# [100%] Checking pre-requisites Checking if any previous agent service exists Checking if OS has systemd or initd Checking available disk space for agent install Checking if /opt/oracle/mgmt_agent directory exists Checking if 'mgmt_agent' user exists 'mgmt_agent' user already exists, the agent will proceed installation without creating a new one. Checking Java version JAVA_HOME is not set. Trying default path Java version: 1.8.0_281 found at /usr/bin/java Updating / installing... 1:oracle.mgmt_agent-<VERSION>################################# [100%] Executing install Unpacking software zip Copying files to destination dir (/opt/oracle/mgmt_agent) Initializing software from template Creating 'mgmt_agent' daemon Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer-log-0 Setup agent using input response file (run as any user with 'sudo' privileges) Usage:sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=[RESPONSE_FILE] Agent install successful
Der Agent-Installationsprozess führt folgende Schritte aus:- Ein neuer Benutzer mit dem Namen
mgmt_agent
wird erstellt. Dies ist der Management Agent-Benutzer. Wenn der Benutzermgmt_agent
bereits vorhanden ist, wird er vom Agent-Installationsprozess zur Installation der Agent-Software verwendet. - Wenn der
mgmt_agent
-Daemon erstellt wird, werden die Hard- und Soft-Benutzergrenzwerte für nofile auf 5000 gesetzt. - Alle Agent-Dateien werden vom Benutzer
mgmt_agent
kopiert und installiert. Das Basisverzeichnis der Agent-Installation ist das Verzeichnis, in dem der Agent installiert wird. Das Verzeichnis wird als Teil des Agent-Installationsprozesses unter dem Verzeichnis/opt/oracle/mgmt_agent
erstellt. - Der Service
mgmt_agent
ist standardmäßig aktiviert und wird automatisch nach der Agent-Installation gestartet.
Die Logdateien der Agent-Installation befinden sich im Verzeichnis/opt/oracle/mgmt_agent/installer-logs
. Um die Logdateien oder andere Agent-Installationsdateien anzuzeigen, melden Sie sich als Benutzermgmt_agent
an, und führen Sie den folgenden Befehl aus:sudo -u mgmt_agent sh
- Ein neuer Benutzer mit dem Namen
-
Konfigurieren Sie den Management Agent, indem Sie das Skript
setup.sh
mit einer Antwortdatei ausführen.sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=<full_path_of_response_file>
Die Ausgabe sollte wie folgt aussehen:sudo /opt/oracle/mgmt_agent/agent_inst/bin/setup.sh opts=<response_file_directory>/input.rsp Executing configure Generating communication wallet Parsing input response file Validating install key Generating security artifacts Registering management agent Configuration Logs: /opt/oracle/mgmt_agent/configure-logs Agent configuration successful Starting agent... Agent started successfully In future agent can be started by directly running: sudo systemctl start mgmt_agent Please make sure that you delete input.rsp or store it in a secure location.
Weitere Informationen zum Erstellen von Antwortdateien finden Sie unter Antwortdatei erstellen.
Management Agent unter Linux installieren (ZIP
-Datei)
Exadata: Um Management Agent auf Exadata und Exadata Cloud zu installieren, laden Sie Management Agent mit der ZIP-Dateeinstallationsmethode herunter, und installieren Sie ihn, um Probleme mit Exadata-Lebenszyklusmanagementvorgängen zu vermeiden. Verwenden Sie die RPM-Installation nicht in Exadata-Deployments, einschließlich On Premise, Cloud@Customer und Oracle Cloud Infrastructure. Stellen Sie bei Exadata Cloud-Deployments in Cloud@Customer und Oracle Cloud Infrastructure sicher, dass der Management Agent im Dateisystem /u02
installiert ist.
Anweisungen zur Installation finden Sie unter Management Agent auf einem externen Volume mit Linux-ZIP-Datei installieren.
Weitere Einzelheiten und wichtige Überlegungen bei der Installation von Management Agent in Exadata Cloud finden Sie unter OCI: Observability & Management Support For Exadata Cloud Dok.-ID 3015115.1 auf My Oracle Support.
ZIP
-Datei:
Der Standardinstallationsspeicherort befindet sich unter dem Volume
/opt
. Wenn Sie den Management Agent lieber mit einem externen Volume installieren möchten, lesen Sie Management Agent auf einem externen Volume mit Linux-ZIP-Datei installieren.
-
Extrahieren Sie die Management Agent-Software.
Navigieren Sie zu dem Verzeichnis, in das Sie die
ZIP
-Datei der Management Agent-Software heruntergeladen haben, und dekomprimieren Sie sie an einem beliebigen bevorzugten Speicherort. -
Melden Sie sich als Benutzer mit
sudo
-Berechtigungen an. -
Installieren und richten Sie den Management Agent ein, indem Sie das Skript
installer.sh
mit einer Antwortdatei ausführen. Informationen zum Erstellen einer Antwortdatei finden Sie unter Antwortdatei erstellen.Navigieren Sie zu dem Verzeichnis, in dem Sie dieZIP
-Datei der Management Agent-Software dekomprimiert haben, und führen Sie den folgenden Befehl aus:sudo ./installer.sh <full_path_of_response_file>
Beispiel:
sudo ./installer.sh /tmp/input.rsp
Die Ausgabe sollte wie folgt aussehen:sudo ./installer.sh <user_home_directory>/input.rsp Checking pre-requisites Checking if any previous agent service exists Checking if OS has systemd or initd Checking available disk space for agent install Checking if /opt/oracle/mgmt_agent directory exists Checking if 'mgmt_agent' user exists Checking Java version JAVA_HOME is not set or not readable to root Trying default path /usr/bin/java Java version: 1.8.0_282 found at /usr/bin/java Checking agent version Executing install Unpacking software zip Copying files to destination dir (/opt/oracle/mgmt_agent) Initializing software from template Creating 'mgmt_agent'daemon Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0 Agent install successful Executing configure Parsing input response file Validating install key Generating communication wallet Generating security artifacts Registering Management Agent Starting agent... Agent started successfully Agent setup completed and the agent is running. In the future agent can be started by directly running: sudo systemctl start mgmt_agent Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
Der Agent-Installationsprozess führt folgende Schritte aus:- Ein neuer Benutzer mit dem Namen
mgmt_agent
wird erstellt. Dies ist der Management Agent-Benutzer. Wenn der Benutzermgmt_agent
bereits vorhanden ist, wird er vom Agent-Installationsprozess zur Installation der Agent-Software verwendet. - Wenn der
mgmt_agent
-Daemon erstellt wird, werden die Hard- und Soft-Benutzergrenzwerte für nofile auf 5000 gesetzt. - Alle Agent-Installationsdateien sind Eigentum des Benutzers
mgmt_agent
. Das Basisverzeichnis der Agent-Installation ist das Verzeichnis, in dem der Agent installiert wird. Das Verzeichnis wird als Teil des Agent-Installationsprozesses unter dem Verzeichnis/opt/oracle/mgmt_agent
erstellt. - Der Service
mgmt_agent
ist standardmäßig aktiviert und wird automatisch nach der Agent-Installation gestartet.
Die Logdateien der Agent-Installation befinden sich im Verzeichnis
/opt/oracle/mgmt_agent/installer-logs
.Die Logdateien des ausgeführten Agent befinden sich im Verzeichnis
/opt/oracle/mgmt_agent/agent_inst/log
.Um die Logdateien oder andere Agent-Installationsdateien anzuzeigen, melden Sie sich als Benutzermgmt_agent
an, und führen Sie den folgenden Befehl aus:sudo -u mgmt_agent sh
- Ein neuer Benutzer mit dem Namen
Management Agent auf einem externen Volume mit der Linux-Datei ZIP
installieren
Exadata: Um Management Agent auf Exadata und Exadata Cloud zu installieren, laden Sie Management Agent mit der ZIP-Dateeinstallationsmethode herunter, und installieren Sie ihn, um Probleme mit Exadata-Lebenszyklusmanagementvorgängen zu vermeiden. Verwenden Sie die RPM-Installation nicht in Exadata-Deployments, einschließlich On Premise, Cloud@Customer und Oracle Cloud Infrastructure. Stellen Sie bei Exadata Cloud-Deployments in Cloud@Customer und Oracle Cloud Infrastructure sicher, dass der Management Agent im Dateisystem /u02
installiert ist.
Weitere Einzelheiten und wichtige Überlegungen bei der Installation von Management Agent in Exadata Cloud finden Sie unter OCI: Observability & Management Support For Exadata Cloud Dok.-ID 3015115.1 auf My Oracle Support.
In einigen Linux-Umgebungen ist der Speicherplatz des Volumes /opt
begrenzt und kann nicht zur Installation von Software verwendet werden. In diesen Fällen können Sie den Management Agent mit der Linux-Datei ZIP
auf einem externen Volume installieren und einen symbolischen Link erstellen.
So installieren Sie Management Agent auf einem externen Volume unter Linux:
- Erstellen Sie das Management Agent-Installationsverzeichnis auf einem externen Volume.
Beispiel:
sudo mkdir -p /devext/oracle/mgmt_agent
Im obigen Beispiel ist
/devext
ein externes Volume. - Erstellen Sie einen symbolischen Link im Verzeichnis
/opt/oracle
, der auf das externe Volume verweist.Bevor Sie den folgenden Befehl ausführen, bestätigen Sie, dass das Verzeichnis
/opt/oracle
bereits vorhanden ist.Beispiel:sudo ln -s /devext/oracle/mgmt_agent /opt/oracle/mgmt_agent
- Vergewissern Sie sich, dass die Linux-Datei
ZIP
der Management Agent-Software heruntergeladen wurde. Weitere Informationen finden Sie unter Management Agent-Software herunterladen. - Wechseln Sie zu einer Root-Shell, legen Sie die Umgebungsvariable
OPT_ORACLE_SYMLINK = true
fest, und installieren Sie die Management Agent-Software als Root-Benutzer.sudo /bin/bash export OPT_ORACLE_SYMLINK=true ./installer.sh <full_path_of_response_file>
Beispiel:sudo /bin/bash export OPT_ORACLE_SYMLINK=true ./installer.sh ./input.rsp
- Stellen Sie nach Abschluss des Installationsprozesses sicher, dass der Linux-Benutzer
mgmt_agent
der Eigentümer des Management Agent-Installationsverzeichnisses ist.stat -c '%U' /opt/oracle/mgmt_agent mgmt_agent sudo stat -c '%U' /opt/oracle/mgmt_agent/agent_inst mgmt_agent
Management Agent auf dem Mac installieren
Die Installation von Management Agent auf einem Mac wird bei Verwendung des Java Management-Service unterstützt. Weitere Informationen finden Sie unter Java Management-Service, insbesondere im Abschnitt Management-Agent installieren.
Management Agent auf Windows Server installieren
-
Extrahieren Sie die Management Agent-Software.
Navigieren Sie zu dem Verzeichnis, in das Sie die
ZIP
-Datei der Management Agent-Software heruntergeladen haben, und dekomprimieren Sie sie an einem beliebigen bevorzugten Speicherort. -
Melden Sie sich als Benutzer "Administrator" an, und öffnen Sie ein Eingabeaufforderungsfenster.
-
Installieren und konfigurieren Sie den Management Agent, indem Sie das Skript
install.bat
mit einer Antwortdatei ausführen.installer.bat <full_path_of_response_file>
Die Ausgabe sollte wie folgt aussehen:installer.bat C:\<user_home_directory>\input.rsp Checking pre-requisites Checking if previous agent service exists Checking if C:\Oracle\mgmt_agent\agent_inst directory exists Checking if C:\Oracle\mgmt_agent\200820.0751 directory exists Checking available disk space for agent install Checking Java version Java version: 1.8.0_281 found at C:\Program Files\Java\jdk1.8.0_281 Executing install Unpacking software zip Copying files to destination dir (C:\Oracle\mgmt_agent) Initializing software from template Creating mgmt_agent service Agent install successful Executing configure Parsing input response file Generating communication wallet Validating install key Generating security artifacts Registering Management Agent The mgmt_agent service is starting.... The mgmt_agent service was started successfully. Agent setup completed and the agent is running In the future agent can be started by directly running: NET START mgmt_agent Please make sure that you delete C:\<user_home_directory>\input.rsp or store it in secure location.
Weitere Informationen zum Erstellen von Antwortdateien finden Sie unter Antwortdatei erstellen.
- Als Teil des Agent-Installationsprozesses wird ein neues Verzeichnis erstellt:
C:\Oracle\mgmt_agent
. - Das Basisverzeichnis der Agent-Installation ist das Verzeichnis, in dem der Agent installiert wird. Standardmäßig wird der Agent im Verzeichnis
C:\Oracle
installiert. Sie können dieses Standardverzeichnis ändern, indem Sie die UmgebungsvariableAGENT_INSTALL_BASEDIR
festlegen, bevor Sie das Skriptinstall.bat
ausführen. -
Die Logdateien der Agent-Installation befinden sich im Verzeichnis
C:\Oracle\mgmt_agent\installer-logs
.
Management Agent auf Windows Desktop installieren
Die Installation von Management Agent auf einem Windows-Desktop wird bei Verwendung des Java Management-Service unterstützt. Weitere Informationen finden Sie unter Java Management-Service, insbesondere im Abschnitt Management-Agent installieren.
Management Agent unter Solaris installieren
-
Extrahieren Sie die Management Agent-Software.
Navigieren Sie zu dem Verzeichnis, in das Sie die ZIP-Datei der Management Agent-Software heruntergeladen haben, und dekomprimieren Sie sie an einem beliebigen bevorzugten Speicherort.
-
Wenn der Pfad zu sudo nicht in Ihrer
PATH
festgelegt ist, legen Sie die UmgebungsvariableSUDO_PATH
mit dem Pfad auf sudo fest. Sie können mit der Optionsudo -E
Umgebungsvariablen beibehalten, während der Befehl als sudo ausgeführt wird.Stellen Sie sicher, dass sich
useradd
undgroupadd
in der UmgebungsvariablenPATH
befinden. Beispiel: Wenn sie sich im Verzeichnis/sbin/useradd
befinden, stellen Sie sicher, dass dieses Verzeichnis im Pfad enthalten ist.Stellen Sie sicher, dass
sudo
in der UmgebungsvariablenPATH
enthalten ist. Beispiel: Wenn sich sudo in Speicherort/usr/bin/sudo
befindet, bestätigen Sie, dass die UmgebungsvariablePATH
den Speicherort"/usr/bin"
enthält. -
Melden Sie sich als Benutzer mit
sudo
-Berechtigungen an. -
Installieren und konfigurieren Sie den Management Agent, indem Sie das Skript
installer.sh
mit einer Antwortdatei ausführen.Informationen zum Erstellen von Antwortdateien finden Sie unter Antwortdatei erstellen.
Navigieren Sie zu dem Verzeichnis, in dem Sie dieZIP
-Datei der Management Agent-Software dekomprimiert haben, und führen Sie Folgendes aus:sudo ./installer.sh <full_path_of_response_file>
Die Ausgabe sieht in etwa wie folgt aus:sudo ./installer.sh <user_home_directory>/input.rsp Checking pre-requisites Checking if any previous agent service exists Checking if OS has systemd or initd Checking available disk space for agent install Checking if /opt/oracle/mgmt_agent directory exists Checking if 'mgmt_agent' user exists Checking Java version JAVA_HOME is not set or not readable to root Trying default path /usr/bin/java Java version: 1.8.0_282 found at /usr/bin/java Checking agent version Executing install Unpacking software zip Copying files to destination dir (/opt/oracle/mgmt_agent) Initializing software from template Creating 'mgmt_agent'daemon Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0 Agent install successful Executing configure Parsing input response file Validating install key Generating communication wallet Generating security artifacts Registering Management Agent Starting agent... Agent started successfully Agent setup completed and the agent is running. In the future agent can be started by directly running: sudo systemctl start mgmt_agent Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
Die Agent-Installation führt folgende Schritte aus:- Ein neuer Benutzer mit dem Namen
mgmt_agent
wird erstellt. Dies ist der Benutzer des Management-Agents. Wenn der Benutzermgmt_agent
bereits vorhanden ist, wird er vom Agent-Installationsprozess zur Installation der Agent-Software verwendet. - Wenn der
mgmt_agent
-Daemon erstellt wird, werden die ulimit-Werte für harte und weiche Nofile auf 5000 gesetzt. - Der Benutzer
mgmt_agent
ist Eigentümer aller Agent-Installationsdateien. Das Basisverzeichnis der Agent-Installation ist das Verzeichnis, in dem der Agent installiert ist. Das Verzeichnis wird als Teil des Agent-Installationsprozesses unter dem Verzeichnis/opt/oracle/mgmt_agent
erstellt. - Standardmäßig ist der
mgmt_agent
-Service aktiviert und wird automatisch nach der Agent-Installation gestartet.
Logdateien von der Agent-Installation befinden sich im Verzeichnis
/opt/oracle/mgmt_agent/installer-logs
.Logdateien vom ausgeführten Agent befinden sich unter
/opt/oracle/mgmt_agent/agent_inst/log
.Um die Logdateien oder andere Agent-Installationsdateien anzuzeigen, melden Sie sich als Benutzermgmt_agent
an, der Folgendes ausführt:sudo -u mgmt_agent sh
- Ein neuer Benutzer mit dem Namen
Management Agent auf AIX installieren
sudo
, unzip
und OpenJDK 8 für AIX sind erforderlich, bevor Sie mit der Management Agent-Installation fortfahren.
-
Extrahieren Sie die
ZIP
-Datei der Management Agent-Software.Navigieren Sie zu dem Verzeichnis, in das Sie die
ZIP
-Datei der Management Agent-Software heruntergeladen haben, und dekomprimieren Sie sie an einem beliebigen bevorzugten Speicherort.Das Dienstprogramm
unzip
ist für die Installation erforderlich. Informationen zuunzip
für AIX finden Sie unter AIX Toolbox für Open Source-Software. -
Melden Sie sich als Benutzer mit
sudo
-Berechtigungen an. -
Installieren und richten Sie den Management Agent ein, indem Sie das Skript
installer.sh
mit einer Antwortdatei ausführen.Informationen zum Erstellen einer Antwortdatei finden Sie unter Antwortdatei erstellen.
Navigieren Sie zu dem Verzeichnis, in dem Sie die
ZIP
-Datei der Management Agent-Software dekomprimiert haben, und führen Sie den folgenden Befehl aus:sudo sh installer.sh <full_path_of_response_file>
Beispiel:
sudo sh installer.sh /usr/input.rsp
Die Ausgabe sollte wie folgt aussehen:Checking pre-requisites Checking if any previous agent service exists Checking if OS has systemd or initd Checking available disk space for agent install Checking if /opt/oracle/mgmt_agent directory exists Checking if 'mgmt_agent' user exists Checking Java version Trying /tmp/java/jdk8u372-b07 Java version: 1.8.0_372 found at /tmp/java/jdk8u372-b07/bin/java Checking agent version Executing install Unpacking software zip Copying files to destination dir (/opt/oracle/mgmt_agent) Initializing software from template Checking if JavaScript engine is available to use Creating mgmt_agent daemon Agent Install Logs: /opt/oracle/mgmt_agent/installer-logs/installer.log.0 Agent install successful Executing configure Parsing input response file Validating install key Generating communication wallet Generating security artifacts Registering Management Agent Starting agent... 0513-059 The mgmt_agent Subsystem has been started. Subsystem PID is 16122232. Agent started successfully Agent setup completed and the agent is running. In the future agent can be started by directly running: sudo startsrc -s mgmt_agent Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
Der Agent-Installationsprozess führt folgende Schritte aus:- Ein neuer Benutzer mit dem Namen
mgmt_agent
wird erstellt. Dies ist der Management Agent-Benutzer. Wenn der Benutzermgmt_agent
bereits vorhanden ist, wird er vom Agent-Installationsprozess zur Installation der Agent-Software verwendet. - Wenn der
mgmt_agent
-Daemon erstellt wird, werden die Hard- und Soft-Benutzergrenzwerte für nofile auf 5000 gesetzt. - Alle Agent-Installationsdateien sind Eigentum des Benutzers
mgmt_agent
. Das Basisverzeichnis der Agent-Installation ist das Verzeichnis, in dem der Agent installiert wird. Das Verzeichnis wird als Teil des Agent-Installationsprozesses unter dem Verzeichnis/opt/oracle/mgmt_agent
erstellt. - Der Service
mgmt_agent
ist standardmäßig aktiviert und wird automatisch nach der Agent-Installation gestartet.
Die Logdateien der Agent-Installation befinden sich im Verzeichnis
/opt/oracle/mgmt_agent/installer-logs
.Die Logdateien des ausgeführten Agent befinden sich im Verzeichnis
/opt/oracle/mgmt_agent/agent_inst/log
.Um die Logdateien oder andere Agent-Installationsdateien anzuzeigen, melden Sie sich als Benutzermgmt_agent
an, und führen Sie den folgenden Befehl aus:sudo -u mgmt_agent sh
- Ein neuer Benutzer mit dem Namen
Mehrere Management Agents installieren
Das Feature "Mehrere Management Agents installieren" ist derzeit nur unter Linux verfügbar.
Agent-Service-IDs
Agent-Service-IDs werden verwendet, um einen Agent-Service in Anwesenheit anderer Agent-Instanzen auf einem bestimmten Rechner zu identifizieren, um Verwechslungen zu vermeiden. Jeder Management Agent-Service kann mit einer bestimmten ID installiert werden, mit der diese bestimmte Agent-Instanz lokalisiert und verwaltet wird.
Wenn eine Management Agent-Installation gestartet wird, ohne eine Service-ID anzugeben, wird eine Standardinstallation angenommen.
mgmt_agent-
beginnen, gefolgt von einer Zeichenfolge, die nur alphanumerische Werte, Bindestriche oder Unterstriche als zulässige Zeichen enthält. Beispiel:
mgmt_agent-oc1_phx-abc123
So installieren Sie den Management Agent mit einer Service-ID:
-
Extrahieren Sie die Management Agent-Software.
Navigieren Sie zu dem Verzeichnis, in das Sie die
ZIP
-Datei der Management Agent-Software heruntergeladen haben, und dekomprimieren Sie sie an einem beliebigen bevorzugten Speicherort. -
Melden Sie sich als Benutzer mit
sudo
-Berechtigungen an. -
Installieren und richten Sie den Management Agent ein, indem Sie das Skript
installer.sh
mit einer Antwortdatei ausführen.Informationen zum Erstellen von Antwortdateien finden Sie unter Antwortdatei erstellen.
Navigieren Sie zu dem Verzeichnis, in dem Sie dieZIP
-Datei der Management Agent-Software dekomprimiert haben, und führen Sie den folgenden Befehl aus:sudo ./installer.sh <full_path_of_response_file> <service identifier>
Beispiel:sudo ./installer.sh /tmp/input.rsp mgmt_agent-oc1_phx-abc123
Die Ausgabe sollte wie folgt aussehen:sudo ./installer.sh <user_home_directory>/input.rsp mgmt_agent-oc1_phx-abc123 Checking pre-requisites Checking if any previous agent service exists Checking if OS has systemd or initd Checking available disk space for agent install Checking if /opt/oracle/mgmt_agent-oc1_phx-abc123 directory exists Checking if 'mgmt_agent' user exists Checking Java version JAVA_HOME is not set or not readable to root Trying default path /usr/bin/java Java version: 1.8.0_282 found at /usr/bin/java Checking agent version Executing install Unpacking software zip Copying files to destination dir (/opt/oracle/mgmt_agent-oc1_phx-abc123) Initializing software from template Checking if JavaScript engine is available to use Creating mgmt_agent-oc1_phx-abc123 daemon Agent Install Logs: /opt/oracle/mgmt_agent-oc1_phx-abc123/installer-logs/installer.log.0 Agent install successful Executing configure Parsing input response file Validating install key Generating communication wallet Generating security artifacts Registering Management Agent Starting agent... Agent started successfully Agent setup completed and the agent is running. In the future agent can be started by directly running: sudo systemctl start mgmt_agent-oc1_phx-abc123 Please make sure that you delete <user_home_directory>/input.rsp or store it in secure location.
- Ein neuer Benutzer mit dem Namen
mgmt_agent
wird erstellt. Dies ist der Management Agent-Benutzer. Wenn der Benutzermgmt_agent
bereits vorhanden ist, wird er vom Agent-Installationsprozess zur Installation der Agent-Software verwendet. - Ein Daemon, der beim Erstellen des Namens die Service-ID verwendet.
- Hard und Soft nofile ulimit werden auf 5000 gesetzt.
- Alle Agent-Installationsdateien sind Eigentum des Benutzers
mgmt_agent
. Das Basisverzeichnis der Agent-Installation ist das Verzeichnis, in dem der Agent installiert wird. Das Verzeichnis wird als Teil des Agent-Installationsprozesses unter dem Verzeichnis/opt/oracle/<service-identifier>
erstellt. - Der Daemon-Service
<service-identifier>
ist standardmäßig aktiviert und wird automatisch gestartet, nachdem die Agent-Installation ausgeführt wurde. - Die gesamte Interaktion mit dem Agent-Daemon-Service, wie das Starten oder Stoppen eines Agents, kann mit
<service-identifier>
erfolgen. Beispiel:sudo systemctl start <service-identifier> sudo systemctl stop <service-identifier>
Die Logdateien der Agent-Installation befinden sich im Verzeichnis /opt/oracle/<service-identifier>/installer-logs
.
Die Logdateien des ausgeführten Agents befinden sich im Verzeichnis /opt/oracle/<service-identifier>/agent_inst/log
.
mgmt_agent
an, und führen Sie den folgenden Befehl aus:sudo -u mgmt_agent sh
Management Agent-Installation überprüfen
Agent-Installation mit Benutzeroberfläche überprüfen
So überprüfen Sie die Agent-Installation mit der Benutzeroberfläche:
-
Klicken Sie auf der Hauptseite "Management-Agents" im linken Menü auf Agents.
Die Seite Agents wird mit einer Liste aller installierten Agents und Gateways angezeigt.
Um nur die Agents anzuzeigen, können Sie den Abschnitt
Filter
im linken Menü verwenden:Gehen Sie zu
Filter
, und wählen Sie in der Dropdown-ListeInstallationstyp
den EintragAgent
aus.Alle Agents werden angezeigt.
-
Suchen Sie in der Liste "Agents" in der Spalte Erstellt mit dem Datum der Agent-Installation oder in der Spalte Host mit dem Namen des Hosts, auf dem der Agent installiert wurde, nach dem kürzlich installierten Agent.
Agent-Installation mit Befehlszeilenschnittstelle überprüfen
Agent-Installation mit Befehlszeilenschnittstelle unter Linux überprüfen
-
Melden Sie sich als Benutzer mit
sudo
-Berechtigungen beim Host an. -
Führen Sie den folgenden Befehl aus:
Oracle Linux 6:sudo /sbin/initctl status mgmt_agent
Oracle Linux 7:sudo systemctl status mgmt_agent
Weitere Einzelheiten finden Sie in der Logdatei
/opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log
.
Agent-Installation mit Befehlszeilenschnittstelle unter Windows überprüfen
-
Melden Sie sich mit der Befehlsshell des Accounts
Administrator
beim Host an. -
Führen Sie den folgenden Befehl aus:
sc query mgmt_agent
Weitere Einzelheiten finden Sie in der Logdatei
C:\Oracle\mgmt_agent\agent_inst\log\mgmt_agent.log
.
Agent-Installation mit Befehlszeilenschnittstelle unter Solaris überprüfen
-
Melden Sie sich als Benutzer mit
sudo
-Berechtigungen an, um Befehle als Root-Benutzer auszuführen. -
Führen Sie den folgenden Befehl aus:
sudo /etc/init.d/mgmt_agent status
Weitere Einzelheiten finden Sie in der Logdatei
/opt/oracle/mgmt_agent/agent_inst/log/mgmt_agent.log
.
Probleme bei der Management Agent-Installation beheben
-
Informationen zu Management-Agents-Problemen finden Sie unter Troubleshoot Management Agents Service.
-
Informationen zu Management Gateway-Problemen finden Sie unter Managementgateways beheben.
-
Informationen zu Management-Agents bei Problemen mit Compute-Instanzen finden Sie unter Management-Agents auf Compute-Instanzen beheben.