Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich. # Oracle Enterprise Manager Amazon RDS unterstützt Oracle Enterprise Manager (OEM). OEM ist die Oracle-Produktlinie für die integrierte Verwaltung von Informationstechnologie in Unternehmen. Amazon RDS unterstützt OEM auf Nicht-CDBs oder CDBs von Oracle Database 19c. In der folgenden Tabelle werden die unterstützten OEM-Optionen beschrieben. **** | Option | Options-ID | Unterstützte OEM-Versionen | | --- | --- | --- | | [OEM Database Express](Appendix.Oracle.Options.OEM_DBControl.md) | `OEM` | OEM Database Express 19c | | [OEM Management Agent](Oracle.Options.OEMAgent.md) | `OEM_AGENT` | OEM Cloud-Kontrolle für 13c | **Anmerkung** Sie können OEM Database oder OEM Management Agent verwenden, aber nicht beides. # Oracle Enterprise Manager Database Express Amazon RDS unterstützt Oracle Enterprise Manager (EM Express) über die OEM-Option. Amazon RDS unterstützt EM Express für Oracle Database 19c durch die Verwendung der CDB- oder Nicht-CDB-Architektur. EM Express ist ein webbasiertes Datenbankverwaltungstool, das in Ihrer Datenbank enthalten und nur verfügbar ist, wenn es geöffnet ist. Es unterstützt wichtige Leistungsmanagement- und grundlegende Datenbankverwaltungsfunktionen. Weitere Informationen finden Sie unter [Introduction to Oracle Enterprise Manager Database Express](https://docs.oracle.com/en/database/oracle/oracle-database/19/admqs/getting-started-with-database-administration.html#GUID-BA75AD46-D22E-4914-A31E-C395CD6A2BBA) in der Dokumentation zu Oracle Database. **Anmerkung** EM Express wird in er Instance-Klasse db.t3.small nicht unterstützt. Weitere Informationen zu DB-Instance-Klassen finden Sie unter [DB-Instance-Klassen von RDS für Oracle](Oracle.Concepts.InstanceClasses.md). ## OEM-Optionseinstellungen Amazon RDS unterstützt die folgenden Einstellungen für die OEM-Option. **** | Optionseinstellung | Zulässige Werte | Beschreibung | | --- | --- | --- | | **Port** | Ein Ganzzahlwert | Der Port auf der DB-Instance von RDS für Oracle, der EM Express überwacht. Die Standardeinstellung ist 5500. | | **Sicherheitsgruppen** | — | Eine Sicherheitsgruppe, die Zugriff auf den **Port** hat. | ## Schritt 1: Hinzufügen der OEM-Option Im Allgemeinen wird die OEM-Option wie folgt zu einer DB-Instance hinzugefügt: 1. Erstellen Sie eine neue Optionsgruppe oder kopieren oder ändern Sie eine bestehende Optionsgruppe. 1. Fügen Sie die Option zur Optionsgruppe hinzu. 1. Ordnen Sie der DB-Instance die Optionsgruppe zu. Wenn Sie die OEM-Option hinzufügen, kommt es während des automatischen Neustarts der DB-Instance zu einem kurzen Nutzungsausfall. **So fügen Sie die OEM-Option zu einer DB-Instance hinzu** 1. Bestimmen Sie die zu verwendende Optionsgruppe. Sie können eine Optionsgruppe erstellen oder eine bestehende Optionsgruppe verwenden. Wenn Sie eine bestehende Optionsgruppe verwenden möchten, fahren Sie mit dem nächsten Schritt fort. Erstellen Sie andernfalls eine benutzerdefinierte DB-Optionsgruppe mit folgenden Einstellungen: 1. Wählen Sie für **Engine** die Oracle Edition für Ihre DB-Instance aus. 1. Wählen Sie für **Engine-Hauptversion** die Version Ihrer DB-Instance aus. Weitere Informationen finden Sie unter [Erstellen einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 1. Fügen Sie die OEM-Option zur Optionsgruppe hinzu und konfigurieren Sie die Optionseinstellungen. Weitere Informationen über das Hinzufügen von Optionen finden Sie unter [Hinzufügen einer Option zu einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Weitere Informationen zu den einzelnen Einstellungen finden Sie unter [OEM-Optionseinstellungen](#Appendix.Oracle.Options.OEM_DBControl.Options). **Anmerkung** Wenn Sie einer vorhandenen Optionsgruppe, die bereits mit einer oder mehreren DB-Instances verknüpft ist, die OEM-Option hinzufügen, werden alle DB-Instances neu gestartet und es entsteht ein kurzzeitiger Nutzungsausfall. 1. Ordnen Sie die Optionsgruppe einer neuen oder bestehenden DB-Instance zu: + Weisen Sie bei einer neuen DB-Instance die Optionsgruppe beim Starten der Instance zu. Weitere Informationen finden Sie unter [Erstellen einer Amazon-RDS-DB-Instance](USER_CreateDBInstance.md). + Weisen Sie bei einer bestehenden DB-Instance die Optionsgruppe zu, indem Sie die Instance ändern und die neue Optionsgruppe anhängen. Wenn Sie die OEM-Option hinzufügen, kommt es während des automatischen Neustarts der DB-Instance zu einem kurzen Nutzungsausfall. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md). **Anmerkung** Sie können auch die Option verwenden AWS CLI , um die OEM-Option hinzuzufügen. Beispiele finden Sie unter [Hinzufügen einer Option zu einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). ## Schritt 2: (Nur CDB) Entsperren des DBSNMP-Benutzerkontos Wenn Ihre DB-Instance die CDB-Architektur verwendet, müssen Sie sich bei EM Express als `DBSNMP` anmelden. In einer CDB ist `DBSNMP` ein üblicher Benutzer. Dieses Konto ist standardmäßig gesperrt. Wenn Ihre DB-Instance die CDB-Architektur nicht verwendet, überspringen Sie diesen Schritt. **So entsperren Sie das DBSNMP-Benutzerkonto in einer CDB-Instance** 1. Melden Sie sich in SQL\$1Plus oder einer anderen Oracle-SQL-Anwendung als Masterbenutzer bei Ihrer DB-Instance an. 1. Führen Sie die folgende gespeicherte Prozedur aus, um das Konto `DBSNMP` zu entsperren: ``` 1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password'); ``` Wenn eine Fehlermeldung angezeigt wird, dass die Prozedur nicht vorhanden ist, starten Sie die CDB-Instance neu, um sie automatisch zu installieren. Weitere Informationen finden Sie unter [Eine DB-Instance DB-Cluster neu starten](USER_RebootInstance.md). ## Schritt 3: Zugreifen auf EM Express über Ihren Browser Wenn Sie mithilfe des Webbrowsers auf EM Express zugreifen, werden Sie über ein Anmeldefenster zur Eingabe von Benutzername und Passwort aufgefordert. **So greifen Sie über Ihren Browser auf EM Express zu** 1. Identifizieren Sie den Endpunkt und den EM-Express-Port für Ihre Amazon-RDS-DB-Instance. Informationen zum Ermitteln des Endpunkts der Amazon-RDS-DB-Instance finden Sie unter [Ermitteln des Endpunkts Ihrer DB-Instance von RDS für Oracle](USER_Endpoint.md). 1. Geben Sie in der Locator-Leiste Ihres Browsers eine URL im folgenden Format ein. ``` https://endpoint.rds.amazonaws.com:port/em ``` Verwenden Sie die folgende URL für den Zugriff auf EM Express, wenn beispielsweise der Endpunkt für die Amazon-RDS-DB-Instance `mydb.a1bcde234fgh.us-east-1.rds.amazonaws.com` und Ihr EM-Express-Port `1158` lautet. ``` 1. https://mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com:1158/em ``` 1. Wenn Sie zur Eingabe Ihrer Anmeldeinformationen aufgefordert werden, führen Sie je nach Datenbankarchitektur eine der folgenden Aktionen aus: **Ihre Datenbank ist keine Nicht-CDB.** Geben Sie den Hauptbenutzernamen und das Hauptpasswort für die DB-Instance ein. **Ihre Datenbank ist eine CDB.** Geben Sie `DBSNMP` als Benutzer und das `DBSNMP`-Passwort ein. Lassen Sie das Feld `Container` leer. ## Ändern von OEM Database-Einstellungen Nachdem Sie OEM Database aktiviert haben, können Sie die Einstellung der Sicherheitsgruppe für diese Option ändern. Wenn Sie die Optionsgruppe einer DB-Instance zugeordnet haben, können Sie die OEM-Port-Nummer nicht mehr ändern. Gehen Sie wie folgt vor, um die OEM-Portnummer für eine DB-Instance zu ändern: 1. Erstellen Sie eine neue Optionsgruppe. 1. Fügen Sie die OEM-Option mit der neuen Portnummer zur neuen Optionsgruppe hinzu. 1. Entfernen Sie die bestehende Optionsgruppe aus der DB-Instance. 1. Fügen Sie die neue Optionsgruppe zur DB-Instance hinzu. Weitere Informationen über das Ändern von Optionseinstellungen finden Sie unter [Ändern einer Optionseinstellung](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.ModifyOption). Weitere Informationen zu den einzelnen Einstellungen finden Sie unter [OEM-Optionseinstellungen](#Appendix.Oracle.Options.OEM_DBControl.Options). ## Ausführen von OEM Database Express-Aufgaben Sie können Amazon-RDS-Verfahren verwenden, um bestimmte OEM Database Express-Aufgaben auszuführen. Durch die Ausführung dieser Verfahren können Sie die nachfolgend aufgeführten Aufgaben ausführen. **Anmerkung** OEM Database Express-Aufgaben werden asynchron ausgeführt. **Topics** + [Wechseln des Website-Front-End für OEM Database Express zu Adobe Flash](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash) + [Wechseln des Website-Front-End für OEM Database Express zu Oracle JET](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET) ### Wechseln des Website-Front-End für OEM Database Express zu Adobe Flash **Anmerkung** Diese Aufgabe ist nur für Oracle Database 19c non- CDBs verfügbar. Ab Oracle Database 19c hat Oracle die frühere OEM Database Express-Benutzeroberfläche eingestellt, die auf Adobe Flash basiert. Stattdessen verwendet OEM Database Express jetzt eine Oberfläche, die mit Oracle JET erstellt wurde. Wenn Sie Schwierigkeiten mit der neuen Oberfläche haben, können Sie zurück zur veralteten Flash-basierten Oberfläche wechseln. Schwierigkeiten, die mit der neuen Oberfläche auftreten können, beinhalten, dass Sie nach der Anmeldung bei OEM Database Express auf einem `Loading`-Bildschirm hängen bleiben. Möglicherweise verpassen Sie auch bestimmte Funktionen, die in der Flash-basierten Version von OEM Database Express vorhanden waren. Führen Sie das Amazon-RDS-Verfahren aus, um das Front-End der OEM Database Express-Website zu Adobe Flash zu wechsel `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash`. Diese Vorgehensweise entspricht dem SQL-Befehl `execemx emx`. Bewährte Methoden für die Sicherheit raten von der Verwendung von Adobe Flash ab. Obwohl Sie auf das Flash-basierte OEM Database Express zurückkehren können, empfehlen wir, wenn möglich, die Jet-basierten OEM Database Express-Websites zu verwenden. Wenn Sie auf Adobe Flash zurückgreifen und wieder zu Oracle JET wechseln möchten, verwenden Sie das Verfahren `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Nach einem Oracle-Datenbank-Upgrade löst eine neuere Version von Oracle JET möglicherweise Jet-bezogene Probleme in OEM Database Express. Weitere Hinweise zum Wechseln zu Oracle JET finden Sie unter [Wechseln des Website-Front-End für OEM Database Express zu Oracle JET](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET). **Anmerkung** Das Ausführen dieser Aufgabe aus der Quell-DB-Instance für ein Lesereplikat bewirkt auch, dass das Lesereplikat seine Front-Ends der OEM Database Express-Website auf Adobe Flash umstellt. Mit dem folgenden Prozeduraufruf wird eine Aufgabe erstellt, um die OEM Database Express-Website auf Adobe Flash umzustellen, und die ID der Aufgabe zurückgegeben. ``` SELECT rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash() as TASK_ID from DUAL; ``` Sie können das Ergebnis anzeigen, indem Sie die Ausgabedatei der Aufgabe anzeigen. ``` SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-task-id.log')); ``` Ersetzen Sie *`task-id`* durch die von der Prozedur zurückgegebene Aufgaben-ID. Weitere Informationen über die Amazon-RDS-Prozedur `rdsadmin.rds_file_util.read_text_file` finden Sie unter [Lesen von Dateien in einem DB-Instance-Verzeichnis](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles). Sie können den Inhalt der Ausgabedatei der Aufgabe auch in der anzeigen, AWS-Managementkonsole indem Sie in den Protokolleinträgen im Abschnitt **Logs & Events** nach dem `task-id` suchen. ### Wechseln des Website-Front-End für OEM Database Express zu Oracle JET **Anmerkung** Diese Aufgabe ist nur für Oracle Database 19c non- CDBs verfügbar. Führen Sie die Amazon-RDS-Prozedur aus, um das Front-End der OEM Database Express-Website zu Oracle JET zu wechsel `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Diese Vorgehensweise entspricht dem SQL-Befehl `execemx omx`. Standardmäßig verwenden die OEM Database Express-Websites für Oracle-DB-Instances, auf denen 19c oder höher ausgeführt wird, Oracle JET. Wenn Sie das Verfahren `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash` verwendet haben, um das Front-End der OEM Database Express-Website zu Adobe Flash zu wechseln, können Sie zurück zu Oracle JET wechseln. Verwenden Sie dazu das Verfahren `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Weitere Hinweise zum Wechseln zu Adobe Flash finden Sie unter [Wechseln des Website-Front-End für OEM Database Express zu Adobe Flash](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash). **Anmerkung** Das Ausführen dieser Aufgabe aus der Quell-DB-Instance für ein Lesereplikat bewirkt auch, dass das Lesereplikat seine Front-Ends der OEM Database Express-Website auf Oracle JET umstellt. Mit dem folgenden Prozeduraufruf wird eine Aufgabe erstellt, um die OEM Database Express-Website auf Oracle JET umzustellen, und die ID der Aufgabe zurückgegeben. ``` SELECT rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet() as TASK_ID from DUAL; ``` Sie können das Ergebnis anzeigen, indem Sie die Ausgabedatei der Aufgabe anzeigen. ``` SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-task-id.log')); ``` Ersetzen Sie *`task-id`* durch die von der Prozedur zurückgegebene Aufgaben-ID. Weitere Informationen über die Amazon-RDS-Prozedur `rdsadmin.rds_file_util.read_text_file` finden Sie unter [Lesen von Dateien in einem DB-Instance-Verzeichnis](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles). Sie können den Inhalt der Ausgabedatei der Aufgabe auch in der anzeigen, AWS-Managementkonsole indem Sie in den Protokolleinträgen im Abschnitt **Logs & Events** nach dem `task-id` suchen. ## Entfernen der OEM Database-Option Sie können die OEM-Option aus einer DB-Instance entfernen. Wenn Sie die OEM-Option entfernen, kommt es während des automatischen Neustarts der DB-Instance zu einem kurzen Nutzungsausfall. Nachdem Sie die OEM-Option entfernt haben, müssen Sie daher Ihre DB-Instance nicht neu starten. Führen Sie einen der folgenden Schritte aus, um die OEM-Funktion aus einer DB-Instance zu entfernen: + Entfernen Sie die OEM-Option wie folgt aus der zugehörigen Optionsgruppe: Diese Änderung wirkt sich auf alle DB-Instances aus, die die betreffende Optionsgruppe verwenden. Weitere Informationen finden Sie unter [Entfernen einer Option aus einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). + Ändern Sie die DB-Instance und geben Sie eine andere Optionsgruppe an, in der die OEM-Option nicht enthalten ist. Diese Änderung betrifft eine einzelne DB-Instance. Sie können die (leere) Standardoptionsgruppe oder eine andere benutzerdefinierte Optionsgruppe angeben. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md). # Oracle Management Agent für Enterprise Cloud Control Oracle Enterprise Manager (OEM) Management Agent ist eine Softwarekomponente, die Ziele in Hosts überwacht und diese Informationen an den Oracle Management Service (OMS) mittlerer Stufe übermittelt. Amazon RDS unterstützt Management Agent durch die Verwendung der `OEM_AGENT`-Option. Weitere Informationen finden Sie unter [Overview of Oracle Enterprise Manager Cloud Control 12c](http://docs.oracle.com/cd/E24628_01/doc.121/e25353/overview.htm) und [Overview of Oracle Enterprise Manager Cloud Control 13c](http://docs.oracle.com/cd/E63000_01/EMCON/overview.htm#EMCON109) in der Oracle-Dokumentation. **Topics** + [Anforderungen für Management Agent](#Oracle.Options.OEMAgent.PreReqs) + [Voraussetzungen für die OMS-Host-Kommunikation](#Oracle.Options.OEMAgent.PreReqs.host) + [Einschränkungen für Management Agent](#Oracle.Options.OEMAgent.limitations) + [Optionseinstellungen für den Management-Agenten](#Oracle.Options.OEMAgent.Options) + [Aktivieren der Management-Agent-Option für die DB-Instance](#Oracle.Options.OEMAgent.Enable) + [Entfernen der Management-Agent-Option](#Oracle.Options.OEMAgent.Remove) + [Ausführen von Datenbankaufgaben mit dem Management Agent](#Oracle.Options.OEMAgent.DBTasks) ## Anforderungen für Management Agent Nachfolgend finden Sie die allgemeinen Anforderungen für die Verwendung von Management Agent: + Auf Ihrer DB-Instance muss Oracle Database 19c (19.0.0.0) ausgeführt werden. Sie können entweder die CDB- oder die Nicht-CDB-Architektur verwenden. + Sie müssen einen Oracle Management Service (OMS) verwenden, der für die Verbindung mit Ihrer DB-Instance konfiguriert ist. Beachten Sie die folgenden OMS-Anforderungen: + Management-Agent-Versionen 13.5.0.0.v2 und 13.5.0.0.v3 erfordern OMS-Version 13.5.0.23 oder 24.1. + Management-Agent-Version 13.5.0.0.v1 erfordert OMS-Version 13.5.0.0 oder 24.1. + Management-Agent-Versionen 13.4.0.9.v1 und 13.4.0.9.v2 erfordern OMS-Version 13.4.0.9 oder höher und Patch 32198287. + In den meisten Fällen muss die VPC konfiguriert werden, damit Verbindungen von OMS zur DB-Instance zulässig sind. Falls Sie mit Amazon Virtual Private Cloud (Amazon VPC) nicht vertraut sind, sollten Sie die Schritte unter [Tutorial: Eine VPC zur Verwendung mit einem erstellen (IPv4 nur)](CHAP_Tutorials.WebServerDB.CreateVPC.md) ausführen, bevor Sie fortfahren. + Sie können Management Agent zusammen mit Oracle Enterprise Manager Cloud Control für 12c und 13c verwenden. Stellen Sie sicher, dass Sie über ausreichend Speicherplatz für Ihr OEM-Version verfügen: + Mindestens 8,5 GiB für OEM 13c Version 5 + Mindestens 8,5 GiB für OEM 13c Version 4 + Mindestens 8,5 GiB für OEM 13c Version 3 + Mindestens 5,5 GiB für OEM 13c Version 2 + Mindestens 4,5 GiB für OEM 13c Version 1 + Mindestens 2,5 GiB für OEM 12c + Wenn Sie die Management-Agent-Versionen `OEM_AGENT 13.2.0.0.v3` und `13.3.0.0.v2` verwenden und TCPS-Konnektivität nutzen möchten, befolgen Sie die Anleitung unter [Configuring third party CA certificates for communication with target databases](https://docs.oracle.com/cd/E73210_01/EMSEC/GUID-8337AD48-1A32-4CD5-84F3-256FAE93D043.htm#EMSEC15996) in der Oracle-Dokumentation. Aktualisieren Sie auch das JDK auf Ihrem OMS anhand der Anleitung im Oracle-Dokument mit der Oracle-Dokument-ID 2241358.1. Dieser Schritt stellt sicher, dass Ihr OMS alle Cipher Suites unterstützt, die von der Datenbank unterstützt werden. **Anmerkung** Die TCPS-Konnektivität zwischen dem Management-Agenten und der DB-Instance wird nur für die Management-Agent-Versionen `OEM_AGENT 13.2.0.0.v3`, `13.3.0.0.v2`, `13.4.0.9.v1` und höher unterstützt. ## Voraussetzungen für die OMS-Host-Kommunikation Stellen Sie sicher, dass Ihr OMS-Host und Ihre Amazon-RDS-DB-Instance kommunizieren können. Gehen Sie wie folgt vor: + Wenn sich der OMS-Host hinter einer Firewall befindet, fügen Sie die IP-Adressen der DB-Instances zur Firewall hinzu, um eine Verbindung von Management Agent mit dem OMS-Host herzustellen. Überprüfen Sie, ob die Firewall des OMS den folgenden Netzwerkverkehr zulässt: Vom OMS-Host zu Ihrer DB-Instance Konfigurieren Sie eine unidirektionale Firewallregel, die den Datenverkehr vom OMS-Host zum Datenbank-Listener-Port (Standard 1521) und zum OEM-Agent-Port (Standard 3872) zulässt. Von Ihrer DB-Instance zum OMS-Host Konfigurieren Sie eine unidirektionale Firewallregel, die den Datenverkehr von der DB-Instance zum OMS-HTTP-Port zulässt (Standard 4903). + Wenn OMS einen öffentlich auflösbaren Hostnamen besitzt, fügen Sie die OMS-Adresse zu einer Sicherheitsgruppe hinzu, um die Verbindung von OMS zu Management Agent herzustellen. Ihre Sicherheitsgruppe muss über Eingangsregeln verfügen, die den Zugriff auf den DB-Listener-Port und den Management Agent-Port erlauben. Ein Beispiel zum Erstellen einer Sicherheitsgruppe und zum Hinzufügen von Regeln für eingehenden Datenverkehr finden Sie unter [Tutorial: Eine VPC zur Verwendung mit einem erstellen (IPv4 nur)](CHAP_Tutorials.WebServerDB.CreateVPC.md). + Wenn OMS keinen öffentlich auflösbaren Hostnamen besitzt, stellen Sie die Verbindung von OMS zu Management Agent mit einer der folgenden Methoden her: + Sofern OMS auf einer Amazon Elastic Compute Cloud (Amazon EC2)-Instance in einer privaten VPC gehostet wird, können Sie VPC-Peering einrichten, um die Verbindung von OMS zu Management Agent herzustellen. Weitere Informationen finden Sie unter [Ein DB-Instance in einer VPC, auf den eine EC2-Instance in einer anderen VPC zugreift](USER_VPC.Scenarios.md#USER_VPC.Scenario3). + Falls OMS lokal gehostet wird, können Sie eine VPN-Verbindung einrichten, über die OMS auf Management Agent zugreifen kann. Weitere Informationen finden Sie unter [Zugriff auf eine DB-Instance in einer VPC durch eine Client-Anwendung über das Internet](USER_VPC.Scenarios.md#USER_VPC.Scenario4) oder [VPN-Verbindungen](https://docs.aws.amazon.com/vpc/latest/userguide/vpn-connections.html). + Um OEM Management Agent Version 13.5.0.0 (v1-v3) mit einem OMS-Host der Version 24.1 zu verbinden, legen Sie `MINIMUM_TLS_VERSION` in Ihren Konfigurationsoptionen so fest, dass das TLS 1.2-Protokoll `TLSv1.2` verwendet wird. ## Einschränkungen für Management Agent Nachfolgend finden Sie einige Einschränkungen bei der Verwendung von Management Agent: + Sie können keine benutzerdefinierten Images von Oracle Management Agent bereitstellen. + Administrative Aufgaben, wie die Ausführung eines Jobs und Datenbank-Patching, die Anmeldeinformationen des Hosts benötigen, werden nicht unterstützt. + Host-Metriken und die Liste mit den Prozessen gewährleisten nicht die akkurate Wiedergabe des aktuellen Systemzustands. Daher sollten Sie OEM nicht verwenden, um das Root-Dateisystem oder Mount-Point-Dateisystem zu überwachen. Weitere Informationen zum Überwachen des Betriebssystems finden Sie unter [Überwachen von Betriebssystem-Metriken mithilfe von „Enhanced Monitoring“·(Erweiterte·Überwachung)](USER_Monitoring.OS.md). + Autodiscovery wird nicht unterstützt. Sie müssen Datenbankziele manuell hinzufügen. + Die Verfügbarkeit von OMS-Modulen ist von der Datenbank-Edition abhängig. Das Diagnose- und Optimierungsmodul für die Datenbankleistung ist beispielsweise nur für Oracle Database Enterprise Edition verfügbar. + Management Agent benötigt zusätzlichen Speicher und Rechenressourcen. Sollten nach der Aktivierung der `OEM_AGENT`-Option Leistungsprobleme auftreten, wird empfohlen, auf eine größere DB-Instance-Klasse zu skalieren. Weitere Informationen erhalten Sie unter [](Concepts.DBInstanceClass.md) und [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md). + Der Benutzer, der `OEM_AGENT` auf Host Amazon RDS ausführt, hat keinen Betriebssystemzugriff auf das Warnungsprotokoll. Daher können Sie keine Metriken für `DB Alert Log` und `DB Alert Log Error Status` im OEM sammeln. ## Optionseinstellungen für den Management-Agenten Amazon RDS unterstützt die folgenden Einstellungen für die Management Agent-Option. | Optionseinstellung | Erforderlich | Zulässige Werte | Beschreibung | | --- | --- | --- | --- | | **Version** (`AGENT_VERSION`) | Ja | `13.5.0.0.v3` `13.5.0.0.v2` `13.5.0.0.v1` `13.4.0.9.v2` `13.4.0.9.v1` `13.3.0.0.v2` `13.3.0.0.v1` `13.2.0.0.v3` `13.2.0.0.v2` `13.2.0.0.v1` `13.1.0.0.v1` | Die Version der Management Agent-Software. Die unterstützte Mindestversion ist `13.1.0.0.v1`. Der AWS CLI Optionsname ist`OptionVersion`. In den AWS GovCloud (US) Regionen sind 13.1-Versionen nicht verfügbar. | | **Port** (`AGENT_PORT`) | Ja | Ein Ganzzahlwert | Der Port auf der DB-Instance, der den OMS-Host überwacht. Der Standardwert ist 3872. Ihr OMS-Host muss einer Sicherheitsgruppe angehören, die Zugriff auf diesen Port hat. Der AWS CLI Optionsname lautet`Port`. | | **Sicherheitsgruppen** | Ja | Bestehende Sicherheitsgruppen | Eine Sicherheitsgruppe, die Zugriff auf den **Port** hat. Ihr OMS-Host muss dieser Sicherheitsgruppe angehören. Der AWS CLI Optionsname ist `VpcSecurityGroupMemberships` oder`DBSecurityGroupMemberships`. | | **OMS\$1HOST** | Ja | Ein Zeichenkettenwert, zum Beispiel *my.example.oms* | Der öffentlich zugängliche Hostname oder die IP-Adresse von OMS. Der AWS CLI Optionsname lautet`OMS_HOST`. | | **OMS\$1PORT** | Ja | Ein Ganzzahlwert | Der HTTPS-Upload-Port auf dem OMS-Host, der den Management Agent überwacht. Um den HTTPS-Upload-Port zu ermitteln, verbinden Sie sich mit dem OMS-Host und führen den folgenden Befehl aus (für den das `SYSMAN`-Passwort erforderlich ist): emctl status oms -details Der AWS CLI Optionsname ist`OMS_PORT`. | | **AGENT\$1REGISTRATION\$1PASSWORD** | Ja | Ein Zeichenfolgenwert | Das von Management Agent verwendete Passwort zur Authentifizierung bei OMS. Es wird empfohlen, vor der Aktivierung der `OEM_AGENT`-Option ein persistentes Passwort in OMS festzulegen. Mit einem persistenten Passwort können Sie eine einzelne Management Agent-Optionsgruppe für mehrere Amazon-RDS-Datenbanken freigeben. Der AWS CLI Optionsname ist`AGENT_REGISTRATION_PASSWORD`. | | **ALLOW\$1TLS\$1ONLY** | Nein | `true`, `false` (Standard) | Ein Wert, der den OEM Agent so konfiguriert, dass er nur das `TLSv1`-Protokoll unterstützt, während der Agent als Server überwacht. Diese Einstellung wird nicht mehr unterstützt. Management-Agent-Versionen 13.1.0.0.v1 und höher unterstützen standardmäßig TLS (Transport Layer Security). | | **MINIMUM\$1TLS\$1VERSION** | Nein | `TLSv1` (Standard), `TLSv1.2` | Ein Wert, der die minimale TLS-Version angibt, die vom OEM Agent unterstützt wird, während der Agent als Server überwacht. Nicht mehr unterstützte Agenten-Versionen unterstützen nur die Einstellung `TLSv1`. Um Version 13.5.0.0 (v1-v3) mit einem OMS-Host der Version 24.1 zu verbinden, legen Sie diese Einstellung auf `TLSv1.2` fest. | | **TLS\$1CIPHER\$1SUITE** | Nein | Siehe [Optionseinstellungen für den Management-Agenten](#Oracle.Options.OEMAgent.Options). | Ein Wert, der die TLS-Verschlüsselungssammlung angibt, die vom OEM Agent verwendet wird, während der Agent als Server überwacht. | In der folgenden Tabelle sind die TLS-Verschlüsselungssuiten aufgeführt, die von der Management-Agent-Option unterstützt werden. | Verschlüsselungssuite | Unterstützte Agent-Version | FedRAMP-konform | | --- | --- | --- | | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | Alle | Nein | | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 | 13.1.0.0.v1 und höher | Nein | | TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 und höher | Nein | | TLS\$1RSA\$1MIT\$1AES\$1256\$1CBC\$1 SHA256 | 13.2.0.0.v3 und höher | Nein | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | 13.2.0.0.v3 und höher | Ja | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 und höher | Ja | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 | 13.2.0.0.v3 und höher | Ja | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | 13.2.0.0.v3 und höher | Ja | | TLS\$1ECDHE\$1ECDSA\$1MIT\$1AES\$1256\$1GCM\$1 SHA384 | 13.4.0.9.v1 und höher | Ja | | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | 13.4.0.9.v1 und höher | Ja | ### Kompatibilität von Zertifikaten mit Verschlüsselungs-Suiten RDS für Oracle unterstützt sowohl RSA- als auch ECDSA-Zertifikate (Elliptic Curve Digital Signature Algorithm, Elliptischer-Kurven-Digital-Signatur-Algorithmus). Wenn Sie die OEM-Agent-Option für Ihre DB-Instance konfigurieren, müssen Sie sich vergewissern, dass die in der Optionseinstellung `TLS_CIPHER_SUITE` angegebenen Verschlüsselungs-Suiten mit dem von Ihrer DB-Instance verwendeten Zertifikatstyp kompatibel sind. In der folgenden Tabelle wird die Kompatibilität zwischen Zertifikatstypen und Verschlüsselungs-Suiten verdeutlicht: | Zertifikatstyp | Kompatible Verschlüsselungs-Suiten | Inkompatible Verschlüsselungs-Suiten | | --- | --- | --- | | RSA-Zertifikate (rds-ca-2019, 2048-g1, 4096-g1) rds-ca-rsa rds-ca-rsa | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1MIT\$1AES\$1256\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | TLS\$1ECDHE\$1ECDSA\$1MIT\$1AES\$1256\$1GCM\$1 SHA384 TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | | ECDSA-Zertifikate (384-g1) rds-ca-ecc | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1 SHA384 TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1MIT\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1MIT\$1AES\$1256\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1 SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1 SHA384 | Wenn Sie in der Optionseinstellung `TLS_CIPHER_SUITE` eine Verschlüsselungs-Suite angeben, vergewissern Sie sich, dass diese mit dem von Ihrer DB-Instance verwendeten Zertifikatstyp kompatibel ist. Wenn Sie versuchen, eine Optionsgruppe zu einer OEM-Agent-Option zuzuordnen, die eine mit dem Zertifikatstyp einer DB-Instance inkompatible Verschlüsselungs-Suite enthält, schlägt der Vorgang fehl und es wird eine Fehlermeldung angezeigt, in der auf die Inkompatibilität hingewiesen wird. ## Aktivieren der Management-Agent-Option für die DB-Instance Führen Sie die folgenden Schritte aus, um die Management-Agent-Option zu aktivieren: **Topics** + [Schritt 1: Hinzufügen der Management-Agent-Option zu einer DB-Instance](#Oracle.Options.OEMAgent.Add) + [Schritt 2: Entsperren des DBSNMP-Benutzerkontos](#Oracle.Options.OEMAgent.DBSNMP) + [Schritt 3: Hinzufügen der Ziele zur Management-Agent-Konsole](#Oracle.Options.OEMAgent.Using) ### Schritt 1: Hinzufügen der Management-Agent-Option zu einer DB-Instance Gehen Sie wie folgt vor, um die Management-Agent-Option zu Ihrer DB-Instance hinzuzufügen: 1. Erstellen Sie eine neue Optionsgruppe oder kopieren oder ändern Sie eine bestehende Optionsgruppe. 1. Hinzufügen der Option zur Optionsgruppe. 1. Ordnen Sie die Optionsgruppe der DB-Instance zu. Wenn Sie auf Fehler stoßen, durchsuchen Sie die [My Oracle Support](https://support.oracle.com/)-Dokumente nach Informationen zur Lösung bestimmter Probleme. Nachdem Sie die Management Agent-Option hinzugefügt haben, ist kein Neustart der DB-Instance erforderlich. Sobald die Optionsgruppe aktiv ist, ist auch der OEM Agent aktiv. Wenn Ihr OMS-Host ein nicht vertrauenswürdiges Drittanbieterzertifikat verwendet, gibt Amazon RDS den folgenden Fehler zurück. ``` You successfully installed the OEM_AGENT option. Your OMS host is using an untrusted third party certificate. Configure your OMS host with the trusted certificates from your third party. ``` Wenn dieser Fehler zurückgegeben wird, wird die Option „Management Agent (Verwaltungsagent)“ erst aktiviert, wenn das Problem behoben wurde. Informationen zum Beheben des Problems finden Sie im My Oracle-Supportdokument [2202569.1](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2202569.1). #### Konsole **So fügen Sie die Management-Agent-Option zu Ihrer DB-Instance hinzu** 1. Bestimmen Sie die zu verwendende Optionsgruppe. Sie können eine Optionsgruppe erstellen oder eine bestehende Optionsgruppe verwenden. Wenn Sie eine bestehende Optionsgruppe verwenden möchten, fahren Sie mit dem nächsten Schritt fort. Erstellen Sie andernfalls eine benutzerdefinierte DB-Optionsgruppe mit folgenden Einstellungen: 1. Wählen Sie für **Engine** die Oracle Edition für Ihre DB-Instance aus. 1. Wählen Sie für **Engine-Hauptversion** die Version Ihrer DB-Instance aus. Weitere Informationen finden Sie unter [Erstellen einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 1. Fügen Sie die Option **OEM\$1AGENT** zur Optionsgruppe hinzu und konfigurieren Sie die Optionseinstellungen. Weitere Informationen über das Hinzufügen von Optionen finden Sie unter [Hinzufügen einer Option zu einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Weitere Informationen zu den einzelnen Einstellungen finden Sie unter [Optionseinstellungen für den Management-Agenten](#Oracle.Options.OEMAgent.Options). 1. Ordnen Sie die Optionsgruppe einer neuen oder bestehenden DB-Instance zu: + Einer neuen DB-Instance wird die Optionsgruppe beim Starten der Instance zugewiesen. Weitere Informationen finden Sie unter [Erstellen einer Amazon-RDS-DB-Instance](USER_CreateDBInstance.md). + Bei einer bestehenden DB-Instance weisen Sie die Optionsgruppe zu, indem Sie die Instance ändern und die neue Optionsgruppe anhängen. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md). #### AWS CLI [Im folgenden Beispiel wird der Befehl -group verwendet, um die Option einer Optionsgruppe namens hinzuzufügen. AWS CLI add-option-to-option](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) `OEM_AGENT` `myoptiongroup` Für Linux, macOS oder Unix: ``` aws rds add-option-to-option-group \ --option-group-name "myoptiongroup" \ --options OptionName=OEM_AGENT,OptionVersion=13.1.0.0.v1,Port=3872,VpcSecurityGroupMemberships=sg-1234567890,OptionSettings=[{Name=OMS_HOST,Value=my.example.oms},{Name=OMS_PORT,Value=4903},{Name=AGENT_REGISTRATION_PASSWORD,Value=password}] \ --apply-immediately ``` Für Windows: ``` aws rds add-option-to-option-group ^ --option-group-name "myoptiongroup" ^ --options OptionName=OEM_AGENT,OptionVersion=13.1.0.0.v1,Port=3872,VpcSecurityGroupMemberships=sg-1234567890,OptionSettings=[{Name=OMS_HOST,Value=my.example.oms},{Name=OMS_PORT,Value=4903},{Name=AGENT_REGISTRATION_PASSWORD,Value=password}] ^ --apply-immediately ``` ### Schritt 2: Entsperren des DBSNMP-Benutzerkontos Der Management Agent verwendet das Benutzerkonto `DBSNMP`, um eine Verbindung mit der Datenbank herzustellen und Probleme an Oracle Enterprise Manager zu melden. In einer CDB ist `DBSNMP` ein herkömmlicher Benutzer. Dieses Benutzerkonto ist sowohl für den Management Agent als auch für OEM Database Express erforderlich. Dieses Konto ist standardmäßig gesperrt. Das Verfahren zum Entsperren dieses Kontos unterscheidet sich je nachdem, ob Ihre Datenbank die Nicht-CDB- oder die CDB-Architektur verwendet. **So entsperren Sie das DBSNMP-Benutzerkonto** 1. Melden Sie sich in SQL\$1Plus oder einer anderen Oracle-SQL-Anwendung als Masterbenutzer bei Ihrer DB-Instance an. 1. Führen Sie je nach Datenbankarchitektur eine der folgenden Aktionen aus: **Ihre Datenbank ist keine CDB.** Führen Sie die folgende SQL-Anweisung aus: ``` 1. ALTER USER dbsnmp IDENTIFIED BY new_password ACCOUNT UNLOCK; ``` **Ihre Datenbank ist eine CDB.** Führen Sie die folgende gespeicherte Prozedur aus, um das Konto `DBSNMP` zu entsperren: ``` 1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password'); ``` Wenn eine Fehlermeldung angezeigt wird, dass die Prozedur nicht vorhanden ist, starten Sie die CDB-Instance neu, um sie automatisch zu installieren. Weitere Informationen finden Sie unter [Eine DB-Instance DB-Cluster neu starten](USER_RebootInstance.md). ### Schritt 3: Hinzufügen der Ziele zur Management-Agent-Konsole Um eine DB-Instance als Ziel hinzuzufügen, vergewissern Sie sich, dass Sie den Endpunkt und den Port kennen. Informationen zum Ermitteln des Endpunkts der Amazon-RDS-DB-Instance finden Sie unter [Ermitteln des Endpunkts Ihrer DB-Instance von RDS für Oracle](USER_Endpoint.md). Wenn die Datenbank die CDB-Architektur verwendet, fügen Sie den Container `CDB$ROOT` separat als Ziel hinzu. **So fügen Sie Ziele zur Management-Agent-Konsole hinzu** 1. Wählen Sie in Ihrer OMS-Konsole **Setup** (Einrichten), **Add Target** (Ziel hinzufügen) und anschließend **Add Targets Manually** (Ziele manuell hinzufügen) aus. 1. Wählen Sie **Add Targets Declaratively by Specifying Target Monitoring Properties** (Ziele deklarativ durch Angabe von Zielüberwachungseigenschaften hinzufügen) aus. 1. Wählen Sie für **Zieltyp** die Option **Database Instance** (DB-Instance) aus. 1. Wählen Sie für **Monitoring-Agent** den Agent mit der ID, die mit der Ihrer RDS DB-Instance identisch ist. 1. Wählen Sie **Add Manually** (Manuell hinzufügen) aus. 1. Geben Sie den Endpunkt für die Amazon-RDS-DB-Instance ein oder wählen Sie ihn aus der Liste der Hostnamen aus. Stellen Sie sicher, dass der angegebene Hostname mit dem Endpunkt der Amazon RDS DB-Instance übereinstimmt. 1. Legen Sie die folgenden Datenbankeigenschaften fest: + Geben Sie für **Target name (Zielname)** einen Namen ein. + Geben Sie für **Database system name (Datenbanksystemname)** einen Namen ein. + Geben Sie für **Monitor username (Überwachungs-Benutzername)** **dbsnmp** ein. + Geben Sie unter **Überwachungspasswort** das Passwort aus [Schritt 2: Entsperren des DBSNMP-Benutzerkontos](#Oracle.Options.OEMAgent.DBSNMP) ein. + Geben Sie für **Role (Rolle)** **normal** ein. + Geben Sie für **Oracle home path (Oracle-Startpfad)** **/oracle** ein. + Für **Listener Machine name** (Listener-Maschinenname) wird die Agent-Kennung bereits angezeigt. + Geben Sie für **Port** den Datenbank-Port ein. Der RDS-Standard-Port ist 1521. + Geben Sie unter **Database name (Datenbankname)** den Namen Ihrer Datenbank ein. Wenn es sich bei Ihrer Datenbank um eine CDB handelt, lautet dieser Name `RDSCDB`. 1. Wählen Sie **Test Connection** (Verbindung testen) aus. 1. Wählen Sie **Weiter** aus. Die Zieldatenbank wird in der Liste überwachter Ressourcen angezeigt. ## Entfernen der Management-Agent-Option Sie können OEM Agent aus einer DB-Instance entfernen. Nachdem Sie OEM Agent entfernt haben, ist kein Neustart der DB-Instance erforderlich. Führen Sie die folgenden Schritte aus, um OEM Agent aus einer DB-Instance zu entfernen: + Entfernen Sie die OEM Agent-Option aus der zugehörigen Optionsgruppe. Diese Änderung wirkt sich auf alle DB-Instances aus, die die betreffende Optionsgruppe verwenden. Weitere Informationen finden Sie unter [Entfernen einer Option aus einer Optionsgruppe](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). + Ändern Sie die DB-Instance und geben Sie eine andere Optionsgruppe an, in der OEM Agent nicht enthalten ist. Diese Änderung betrifft eine einzelne DB-Instance. Sie können die (leere) Standardoptionsgruppe oder eine andere benutzerdefinierte Optionsgruppe angeben. Weitere Informationen finden Sie unter [Ändern einer Amazon-RDS-DB-Instance](Overview.DBInstance.Modifying.md). ## Ausführen von Datenbankaufgaben mit dem Management Agent Sie können Amazon-RDS-Prozeduren verwenden, um bestimmte EMCTL-Befehle auf dem Management-Agent auszuführen. Durch die Ausführung dieser Verfahren können Sie die nachfolgend aufgeführten Aufgaben ausführen. **Anmerkung** Die Aufgaben werden asynchron ausgeführt. **Topics** + [Schützen des Management Agent](#Oracle.Options.OEMAgent.DBTasks.SecureAgent) + [Abrufen des Status des Management Agents](#Oracle.Options.OEMAgent.DBTasks.GetAgentStatus) + [Neustart des Management-Agents](#Oracle.Options.OEMAgent.DBTasks.RestartAgent) + [Auflistung der vom Management Agent überwachten Ziele](#Oracle.Options.OEMAgent.DBTasks.ListTargets) + [Auflistung der vom Management Agent überwachten Sammlungs-Threads](#Oracle.Options.OEMAgent.DBTasks.ListCollectionThreads) + [Löschen des Status des Management Agents](#Oracle.Options.OEMAgent.DBTasks.ClearState) + [Der Management-Agent muss sein OMS hochladen.](#Oracle.Options.OEMAgent.DBTasks.ForceUploadOMS) + [Ping des OMS](#Oracle.Options.OEMAgent.DBTasks.PingOMS) + [Anzeigen des Status einer laufenden Aufgabe](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) ### Schützen des Management Agent Um den Management Agent zu schützen, führen Sie die Amazon-RDS-Prozedur `rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent` aus. Diese Vorgehensweise entspricht der Ausführung des Befehls `emctl secure agent`. Mit der folgenden Prozedur wird eine Aufgabe zum Schützen des Management Agent erstellt und die ID der Aufgabe zurückgegeben. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent as TASK_ID from DUAL; ``` Informationen zum Anzeigen der Ausgabedatei für die Aufgabe und des Ergebnisses finden Sie unter [Anzeigen des Status einer laufenden Aufgabe](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Abrufen des Status des Management Agents Führen Sie die Amazon-RDS-Prozedur aus, um den Status des Management Agents abzurufe `rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent`. Diese Vorgehensweise entspricht dem `emctl status agent`-Befehl. Die folgende Prozedur erstellt eine Aufgabe, um den Status des Verwaltungsagenten zu erhalten, und gibt die ID der Aufgabe zurück. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent() as TASK_ID from DUAL; ``` Informationen zum Anzeigen der Ausgabedatei für die Aufgabe und des Ergebnisses finden Sie unter [Anzeigen des Status einer laufenden Aufgabe](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Neustart des Management-Agents Um den Management-Agent neu zu starten, führen Sie die Amazon-RDS-Prozedur au `rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent`. Diese Vorgehensweise entspricht der Ausführung der Befehle `emctl stop agent` und `emctl start agent`. Die folgende Prozedur erstellt eine Aufgabe, um den Management-Agent neu zu starten, und gibt die ID der Aufgabe zurück. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent as TASK_ID from DUAL; ``` Informationen zum Anzeigen der Ausgabedatei für die Aufgabe und des Ergebnisses finden Sie unter [Anzeigen des Status einer laufenden Aufgabe](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Auflistung der vom Management Agent überwachten Ziele Um die vom Management-Agent überwachten Ziele aufzulisten, führen Sie die Amazon-RDS-Prozedur au `rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent`. Diese Vorgehensweise entspricht der Ausführung des Befehls `emctl config agent listtargets`. Die folgende Prozedur erstellt eine Aufgabe, um die vom Management-Agent überwachten Ziele aufzulisten, und gibt die ID der Aufgabe zurück. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL; ``` Informationen zum Anzeigen der Ausgabedatei für die Aufgabe und des Ergebnisses finden Sie unter [Anzeigen des Status einer laufenden Aufgabe](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Auflistung der vom Management Agent überwachten Sammlungs-Threads Führen Sie die Amazon-RDS-Prozedur aus, um alle laufenden, fertigen und geplanten Sammlungs-Threads aufzulisten, die vom Management-Agent überwacht werde `rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent`. Diese Vorgehensweise entspricht dem `emctl status agent scheduler`-Befehl. Die folgende Prozedur erstellt eine Aufgabe zum Auflisten der Sammlungs-Threads und gibt die ID der Aufgabe zurück. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent() as TASK_ID from DUAL; ``` Informationen zum Anzeigen der Ausgabedatei für die Aufgabe und des Ergebnisses finden Sie unter [Anzeigen des Status einer laufenden Aufgabe](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Löschen des Status des Management Agents Um den Status des Management-Agents zu löschen, führen Sie die Amazon-RDS-Prozedur au `rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent`. Diese Vorgehensweise entspricht der Ausführung des Befehls `emctl clearstate agent`. Die folgende Prozedur erstellt eine Aufgabe, die den Status des Management-Agents löscht, und gibt die ID der Aufgabe zurück. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent() as TASK_ID from DUAL; ``` Informationen zum Anzeigen der Ausgabedatei für die Aufgabe und des Ergebnisses finden Sie unter [Anzeigen des Status einer laufenden Aufgabe](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Der Management-Agent muss sein OMS hochladen. Damit der Management-Agent den ihm zugeordneten Oracle Management Server (OMS) hochladen kann, führen Sie die Amazon-RDS-Prozedur au `rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent`. Diese Vorgehensweise entspricht der Ausführung des Befehls `emclt upload agent`. Die folgende Prozedur erstellt eine Aufgabe, bei der der Management-Agent seinen zugeordneten OMS hochlädt, und gibt die ID der Aufgabe zurück. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent() as TASK_ID from DUAL; ``` Informationen zum Anzeigen der Ausgabedatei für die Aufgabe und des Ergebnisses finden Sie unter [Anzeigen des Status einer laufenden Aufgabe](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Ping des OMS Um den OMS des Management-Agents anzurufen, führen Sie die Amazon-RDS-Prozedur au `rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent`. Diese Vorgehensweise entspricht der Ausführung des Befehls `emctl pingOMS`. Die folgende Prozedur erstellt eine Aufgabe, die den OMS des Management-Agents anpingt, und gibt die ID der Aufgabe zurück. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent() as TASK_ID from DUAL; ``` Informationen zum Anzeigen der Ausgabedatei für die Aufgabe und des Ergebnisses finden Sie unter [Anzeigen des Status einer laufenden Aufgabe](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Anzeigen des Status einer laufenden Aufgabe Sie können den Status einer laufenden Aufgabe in einer bdump-Datei einsehen. Die bdump-Dateien befinden sich im Verzeichnis `/rdsdbdata/log/trace`. Jeder bdump-Dateiname weist das folgende Format auf. ``` dbtask-task-id.log ``` Wenn Sie eine Aufgabe überwachen möchten, ersetzen Sie `task-id` durch die ID der Aufgabe, die Sie überwachen möchten. Um den Inhalt von bdump-Dateien anzuzeigen, führen Sie die Amazon-RDS-Prozedur au `rdsadmin.rds_file_util.read_text_file`. Die folgende Abfrage gibt den Inhalt der bdump-Datei `dbtask-1546988886389-2444.log` zurück. ``` SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-1546988886389-2444.log')); ``` Weitere Informationen über die Amazon-RDS-Prozedur `rdsadmin.rds_file_util.read_text_file` finden Sie unter [Lesen von Dateien in einem DB-Instance-Verzeichnis](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles).