# Oracle Enterprise Manager O Amazon RDS oferece suporte para o Oracle Enterprise Manager (OEM). OEM é a linha de produtos da Oracle para o gerenciamento integrado de tecnologia da informação empresarial. O Amazon RDS é compatível com o OEM em CDBs ou não CDBs do Oracle Database 19c. A tabela a seguir descreve as opções de OEM compatíveis. **** | Opção | ID da opção | Versões do OEM compatíveis | | --- | --- | --- | | [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 Control para 13c | **nota** É possível usar o OEM Database ou o OEM Management Agent, mas não ambos. # Oracle Enterprise Manager Database Express O Amazon RDS comporta o Oracle Enterprise Manager Database Express (EM Express) com o uso da opção OEM. O Amazon RDS é compatível com o EM Express para Oracle Database 19c usando a arquitetura CDB ou não. O EM Express é uma ferramenta de gerenciamento de banco de dados baseada na web incluída em seu banco de dados e só está disponível quando está aberta. Ele comporta as principais funções de gerenciamento de performance e de administração básica de banco de dados. Para ter mais informações, consulte [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), na documentação do Oracle Database. **nota** O EM Express não é compatível com a classe de instância de banco de dados db.t3.small. Para ter mais informações sobre classes de instância de banco de dados, consulte [Classes de instância de banco de dados do RDS para Oracle](Oracle.Concepts.InstanceClasses.md). ## Configurações da opção OEM O Amazon RDS oferece suporte para as seguintes configurações da opção OEM. **** | Configuração da opção | Valores válidos | Descrição | | --- | --- | --- | | **Porta** | Um valor inteiro | A porta na instância de banco de dados do RDS para Oracle que escuta o EM Express. O padrão é 5500. | | **Security Groups (Grupos de segurança** | — | Um grupo de segurança tem acesso à **Port (Porta)**. | ## Etapa 1: Adicionar a opção OEM O processo geral para adicionar as opções do OEM a uma instância de banco de dados é o seguinte: 1. Crie um novo grupo de opções, ou copie ou modifique um existente. 1. Adicione a opção ao grupo de opções. 1. Associe o grupo de opções à instância de banco de dados. Quando você adiciona a opção OEM, uma breve interrupção ocorre enquanto a instância de banco de dados é reiniciada automaticamente. **Para adicionar a opção OEM a uma instância de banco de dados** 1. Determine o grupo de opções que você deseja usar. Você pode criar um novo grupo de opções ou usar um existente. Se você quiser usar um grupo de opções existente, vá para a próxima etapa. Caso contrário, crie um grupo de opções de banco de dados personalizado com as seguintes configurações: 1. Em **Engine (Mecanismo)**, escolha a edição Oracle para sua instância de banco de dados. 1. Para **Major engine version (Versão do mecanismo principal)**, escolha a versão da sua instância de banco de dados. Para obter mais informações, consulte [Criar um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 1. Adicione a opção OEM ao grupo de opções e defina as configurações da opção. Para mais informações sobre a adição de opções, consulte [Adicionar uma opção a um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Para ter mais informações sobre cada configuração, consulte [Configurações da opção OEM](#Appendix.Oracle.Options.OEM_DBControl.Options). **nota** Se você adicionar a opção OEM a um grupo de opções existente que já está anexado a uma ou mais instâncias de banco de dados, uma breve interrupção ocorrerá enquanto todas as instâncias de banco de dados forem reiniciadas automaticamente. 1. Aplique o grupo de opções a uma instância de banco de dados nova ou existente: + Para uma nova instância de banco de dados, aplique o grupo de opções ao executar a instância. Para obter mais informações, consulte [Criar uma instância de banco de dados do Amazon RDS](USER_CreateDBInstance.md). + Para uma instância de banco de dados existente, aplique o grupo de opções modificando a instância e anexando o novo grupo de opções. Quando você adiciona a opção OEM, uma breve interrupção ocorre enquanto a instância de banco de dados é reiniciada automaticamente. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md). **nota** Também é possível usar a AWS CLI para adicionar a opção OEM. Para ver exemplos, consulte [Adicionar uma opção a um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). ## Etapa 2: (Somente CDB) Desbloquear a conta de usuário DBSNMP Se sua instância de banco de dados usa a arquitetura CDB, você deve fazer login no EM Express como `DBSNMP`, em um CDB, `DBSNMP` é um usuário comum. Por padrão, essa conta está bloqueada. Se sua instância de banco de dados não usa a arquitetura CDB, ignore essa etapa. **Como desbloquear a conta de usuário DBSNMP em uma instância de CDB** 1. No SQL\$1Plus ou em outra aplicação Oracle SQL, faça login como usuário principal em sua instância de banco de dados. 1. Execute o seguinte procedimento armazenado para desbloquear a conta `DBSNMP`: ``` 1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password'); ``` Se você receber um erro informando que o procedimento não existe, reinicie sua instância do CDB para instalá-la automaticamente. Para obter mais informações, consulte [Reinicializar uma instância de banco de dados](USER_RebootInstance.md). ## Etapa 3: Acessar o EM Express por meio do navegador Ao acessar o EM Express pelo navegador da web, é exibida uma janela de login que solicita um nome de usuário e uma senha. **Para acessar o EM Express por meio do navegador** 1. Identifique o endpoint e a porta do EM Express para sua instância de banco de dados do Amazon RDS. Para obter informações sobre como localizar o endpoint de sua instância de banco de dados do Amazon RDS, consulte [Encontrar o endpoint da instância de banco de dados do RDS para Oracle](USER_Endpoint.md). 1. Insira um URL na barra de localização do navegador usando o formato a seguir. ``` https://endpoint.rds.amazonaws.com:port/em ``` Por exemplo, se o endpoint da sua instância de banco de dados do Amazon RDS for `mydb.a1bcde234fgh.us-east-1.rds.amazonaws.com`, e a porta do EM Express for `1158`, use o URL a seguir para acessar o EM Express. ``` 1. https://mydb.f9rbfa893tft.us-east-1.rds.amazonaws.com:1158/em ``` 1. Quando os detalhes de login forem solicitados, realize uma das seguintes ações, dependendo da arquitetura do banco de dados: **O banco de dados não é CDB.** Digite o nome de usuário mestre e a senha mestre da sua instância de banco de dados. **O banco de dados é CDB.** Digite `DBSNMP` para o usuário e a senha do `DBSNMP`. Deixe o campo `Container` vazio. ## Modificar configurações do banco de dados OEM Depois de habilitar o banco de dados OEM, você pode modificar a configuração Security Groups para essa opção. Você não pode modificar o número da porta OEM depois de ter associado o grupo de opções uma instância de banco de dados. Para alterar o número da porta OEM para uma instância de banco de dados, faça o seguinte: 1. Crie um novo grupo de opções. 1. Adicione a opção OEM com o novo número de porta ao novo grupo de opções. 1. Remova o grupo de opções existente da instância de banco de dados. 1. Adicione o novo grupo de opções à instância de banco de dados. Para mais informações sobre como modificar as configurações da opção, consulte [Modificar uma configuração de opção](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.ModifyOption). Para ter mais informações sobre cada configuração, consulte [Configurações da opção OEM](#Appendix.Oracle.Options.OEM_DBControl.Options). ## Executar tarefas do OEM Database Express É possível usar os procedimentos do Amazon RDS para executar determinadas tarefas do OEM Database Express. Executando esses procedimentos, você pode executar as tarefas listadas a seguir. **nota** As tarefas do OEM Database Express são executadas de forma assíncrona. **Topics** + [Mudar o front-end do site do OEM Database Express para Adobe Flash](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash) + [Mudar o front-end do site do OEM Database Express para Oracle JET](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET) ### Mudar o front-end do site do OEM Database Express para Adobe Flash **nota** Essa tarefa está disponível somente para não CDBs do Oracle Database 19c. A partir do Oracle Database 19c, a Oracle descontinuou a interface de usuário anterior do OEM Database Express, que é baseada no Adobe Flash. Em vez disso, o OEM Database Express agora usa uma interface criada com o Oracle JET. Se você tiver dificuldades com a nova interface, é possível mudar para a interface defasada baseada em Flash. As dificuldades que você pode ter com a nova interface incluem ficar preso em uma tela `Loading` após fazer o login no OEM Database Express. Você também pode sentir falta de alguns recursos que estavam presentes na versão baseada em Flash do OEM Database Express. Para mudar o front-end do site do OEM Database Express para o Adobe Flash, execute o procedimento do Amazon RDS `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash`. Este procedimento é equivalente ao comando SQL `execemx emx`. As práticas recomendadas não recomendam o uso do Adobe Flash. Embora você possa reverter para o OEM Database Express baseado em Flash, recomendamos o uso de sites do OEM Database Express baseados em JET, se possível. Se você reverter para o uso do Adobe Flash e quiser mudar novamente para o Oracle JET, use o procedimento `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Após uma atualização do banco de dados Oracle, uma versão mais recente do Oracle JET pode resolver problemas relacionados ao JET no OEM Database Express. Para obter mais informações sobre como mudar para o Oracle JET, consulte [Mudar o front-end do site do OEM Database Express para Oracle JET](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToOracleJET). **nota** Executar essa tarefa na instância de banco de dados de origem para uma réplica de leitura também faz com que a réplica de leitura mude os front-ends do site do OEM Database Express para o Adobe Flash. A chamada do procedimento a seguir cria uma tarefa para mudar o site do OEM Database Express para Adobe Flash e retorna o ID da tarefa. ``` SELECT rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash() as TASK_ID from DUAL; ``` Você pode visualizar o resultado exibindo o arquivo de saída da tarefa. ``` SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-task-id.log')); ``` Substitua *`task-id`* pelo ID da tarefa retornado pelo procedimento. Para obter mais informações sobre o procedimento `rdsadmin.rds_file_util.read_text_file` do Amazon RDS, consulte [Leitura de arquivos no diretório de uma instância de banco de dados](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) Também é possível visualizar o conteúdo do arquivo de saída da tarefa no Console de gerenciamento da AWS ao pesquisar o `task-id` nas entradas do log na seção **Logs & events (Logs e eventos)**. ### Mudar o front-end do site do OEM Database Express para Oracle JET **nota** Essa tarefa está disponível somente para não CDBs do Oracle Database 19c. Para mudar o front-end do site do OEM Database Express para o Oracle JET, execute o Amazon RDS procedimento `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Este procedimento é equivalente ao comando SQL `execemx omx`. Por padrão, os sites do OEM Database Express para instâncias de banco de dados Oracle que executam a versão 19c ou posterior usam o Oracle JET. Caso tenha usado o procedimento `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_flash` para mudar o front-end do site do OEM Database Express para o Adobe Flash, você pode revertê-lo para o Oracle JET. Para fazer isso, use o procedimento `rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet`. Para obter mais informações sobre como mudar para o Adobe Flash, consulte [Mudar o front-end do site do OEM Database Express para Adobe Flash](#Appendix.Oracle.Options.OEM_DBControl.DBTasks.FrontEndToFlash). **nota** Executar esta tarefa a partir da instância de banco de dados de origem para uma réplica de leitura também faz com que a réplica de leitura mude seus front-ends do site do OEM Database Express para o Oracle JET. A chamada do procedimento a seguir cria uma tarefa para mudar o site do OEM Database Express para Oracle JET e retorna o ID da tarefa. ``` SELECT rdsadmin.rdsadmin_oem_tasks.em_express_frontend_to_jet() as TASK_ID from DUAL; ``` Você pode visualizar o resultado exibindo o arquivo de saída da tarefa. ``` SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-task-id.log')); ``` Substitua *`task-id`* pelo ID da tarefa retornado pelo procedimento. Para obter mais informações sobre o procedimento `rdsadmin.rds_file_util.read_text_file` do Amazon RDS, consulte [Leitura de arquivos no diretório de uma instância de banco de dados](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles) Também é possível visualizar o conteúdo do arquivo de saída da tarefa no Console de gerenciamento da AWS ao pesquisar o `task-id` nas entradas do log na seção **Logs & events (Logs e eventos)**. ## Remover a opção de banco de dados OEM Você pode remover a opção OEM de uma instância de banco de dados. Quando você remove a opção OEM, ocorre uma breve interrupção enquanto a instância de banco de dados é reiniciada automaticamente. Assim, depois de remover a opção OEM, você não precisará reiniciar sua instância de banco de dados. Para remover a opção OEM de uma instância de banco de dados, siga um destes procedimentos: + Remova a opção OEM do grupo de opções ao qual ela pertence. Essa alteração afeta todas as instâncias de bancos de dados que usam o grupo de opções. Para obter mais informações, consulte [Remover uma opção de um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). + Modifique a instância de banco de dados e especifique um grupo de opções diferente que não inclua a opção OEM. Essa alteração afeta uma única instância de banco de dados. Você pode especificar um grupo de opções padrão (vazio) ou criar um grupo de opções personalizado diferente. Para ter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md). # Oracle Management Agent para Enterprise Manager Cloud Control O Management Agent Oracle Enterprise Manager (OEM) é um componente de software que monitora destinos em execução em hosts e que comunica essas informações ao Oracle Management Service (OMS) na camada intermediária. O Amazon RDS suporta o Management Agent pelo uso da opção `OEM_AGENT`. Para obter mais informações, consulte [Visão geral do Oracle Enterprise Manager Cloud Control 12c](http://docs.oracle.com/cd/E24628_01/doc.121/e25353/overview.htm) e [Visão geral do Oracle Enterprise Manager Cloud Control 13c](http://docs.oracle.com/cd/E63000_01/EMCON/overview.htm#EMCON109) na documentação da Oracle. **Topics** + [Requisitos para o Management Agent](#Oracle.Options.OEMAgent.PreReqs) + [Pré-requisitos de comunicação do host OMS](#Oracle.Options.OEMAgent.PreReqs.host) + [Limitações para o Management Agent](#Oracle.Options.OEMAgent.limitations) + [Configurações de opção do Management Agent](#Oracle.Options.OEMAgent.Options) + [Habilitar a opção Management Agent para uma instância de banco de dados](#Oracle.Options.OEMAgent.Enable) + [Remover a opção Management Agent](#Oracle.Options.OEMAgent.Remove) + [Como executar tarefas de banco de dados com o Management Agent](#Oracle.Options.OEMAgent.DBTasks) ## Requisitos para o Management Agent Veja a seguir os requisitos gerais para usar o Management Agent: + A instância de banco de dados deve executar o Oracle Database 19c (19.0.0.0). É possível usar a arquitetura CDB ou não CDB. + É necessário usar um Oracle Management Service (OMS) configurado para estabelecer conexão com a instância de banco de dados. Observe os seguintes requisitos de OMS: + As versões 13.5.0.0.v2 e 13.5.0.0.v3 do Management Agent requerem o OMS versão 13.5.0.23 ou 24.1. + A versão 13.5.0.0.v1 do Management Agent requer o OMS versão 13.5.0.0 ou 24.1. + As versões 13.4.0.9.v1 e 13.4.0.9.v2 do Management Agent requerem a versão 13.4.0.9 ou posterior do OMS e o patch 32198287. + Na maioria dos casos, você precisa configurar sua VPC para permitir conexões do OMS com a sua instância de banco de dados. Se não tiver familiaridade com a Amazon Virtual Private Cloud (Amazon VPC), recomendamos que você conclua as etapas em [Tutorial: Criar uma VPC para usar com uma instância de banco de dados (somente IPv4)](CHAP_Tutorials.WebServerDB.CreateVPC.md) antes de continuar. + É possível usar o Management Agent com o Oracle Enterprise Manager Cloud Control para 12c e 13c. Certifique-se de que você tenha espaço de armazenamento suficiente para sua versão do OEM: + Pelo menos 8,5 GiB para OEM 13c versão 5 + Pelo menos 8,5 GiB para OEM 13c versão 4 + Pelo menos 8,5 GiB para OEM 13c versão 3 + Pelo menos 5,5 GiB para OEM 13c versão 2 + Pelo menos 4,5 GiB para o OEM 13c versão 1 + Pelo menos 2,5 GiB para OEM 12c + Se você estiver usando as versões do Management Agent `OEM_AGENT 13.2.0.0.v3` e `13.3.0.0.v2` e deseja usar a conectividade TCPS, siga as instruções no tópico [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) na documentação da Oracle. Além disso, atualize o JDK em seu OMS seguindo as instruções no documento da Oracle com o Oracle Doc ID 2241358.1. Isso garante que o OMS ofereça suporte para todos os pacotes de criptografia compatíveis com o banco de dados. **nota** A conectividade TCPS entre o Management Agent e a instância de banco de dados é compatível com o Management Agent `OEM_AGENT 13.2.0.0.v3`, `13.3.0.0.v2`, `13.4.0.9.v1` e versões posteriores. ## Pré-requisitos de comunicação do host OMS Certifique-se de que seu host OMS e sua instância de banco de dados do Amazon RDS podem se comunicar. Faça o seguinte: + Para se conectar do Management Agent com o host do OMS, se o host do OMS estiver atrás de um firewall, adicione os endereços IP das suas instâncias de banco de dados ao firewall. Certifique-se de que o firewall do OMS permita o seguinte tráfego de rede: Do host do OMS à sua instância de banco de dados Configure uma regra de firewall unidirecional que permita tráfego do host do OMS para a porta do receptor do banco de dados (padrão 1521) e para a porta do OEM Agent (padrão 3872). Da sua instância de banco de dados para o host do OMS Configure uma regra de firewall unidirecional que permita tráfego do da instância de banco de dados para a porta HTTP do OMS (padrão 4903). + Para se conectar do OMS ao Management Agent, se o OMS tiver um nome de host que possa ser publicamente resolvido, você deverá adicionar o endereço do OMS a um grupo de segurança. O grupo de segurança deve ter regras de entrada que permitam o acesso à porta do listener de banco de dados e à porta do Management Agent. Para obter um exemplo de como criar regras de segurança e adicionar regras de entrada, consulte [Tutorial: Criar uma VPC para usar com uma instância de banco de dados (somente IPv4)](CHAP_Tutorials.WebServerDB.CreateVPC.md). + Para se conectar do OMS ao Management Agent, se o OMS não tiver um nome de host que possa ser publicamente resolvido, use um dos seguintes: + Se o OMS estiver hospedado em uma instância do Amazon Elastic Compute Cloud (Amazon EC2) em uma VPC privada, você poderá configurar o emparelhamento de VPCs para se conectar do OMS ao Management Agent. Para obter mais informações, consulte [Uma instância de banco de dados em uma VPC acessada por uma instância do EC2 em uma VPC diferente](USER_VPC.Scenarios.md#USER_VPC.Scenario3). + Se o OMS estiver hospedado no local, você poderá configurar uma conexão VPN para permitir o acesso do OMS ao Management Agent. Para obter mais informações, consulte [Uma instância de banco de dados em uma VPC acessada por uma aplicação cliente pela internet](USER_VPC.Scenarios.md#USER_VPC.Scenario4) ou [Conexões VPN](https://docs.aws.amazon.com/vpc/latest/userguide/vpn-connections.html). + Para conectar o OEM Management Agent versão 13.5.0.0 (v1-v3) a um host do OMS 24.1, defina `MINIMUM_TLS_VERSION` para usar o protocolo `TLSv1.2` do TLS 1.2 em suas opções de configuração. ## Limitações para o Management Agent Veja a seguir algumas limitações do uso do Management Agent: + Não é possível fornecer imagens personalizadas do Oracle Management Agent. + Tarefas administrativas, como a execução do trabalhos e aplicação de patch de banco de dados, que exigem credenciais de host, não são compatíveis. + Não há garantias de que as métricas de host e a lista de processos reflitam o estado do sistema atual. Por isso, você não deve usar o OEM para monitorar o sistema de arquivos raiz ou o sistema de arquivos do ponto de montagem. Para obter mais informações sobre como monitorar o sistema operacional, consulte [Monitorar métricas do SO com o monitoramento avançado](USER_Monitoring.OS.md). + A descoberta automática não é aceita. Você deve adicionar destinos de banco de dados manualmente. + A disponibilidade do módulo OMS depende de sua edição do banco de dados. Por exemplo, o módulo de ajuste e diagnóstico de performance do banco de dados só está disponível para o Oracle Database Enterprise Edition. + O Management Agent consome memória adicional e recursos de computação. Se você tiver problemas de performance depois de habilitar a opção `OEM_AGENT`, recomendamos que você dimensione para uma classe de instância de banco de dados maior. Para obter mais informações, consulte [Classes de instâncias de banco de dados do ](Concepts.DBInstanceClass.md) e [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md). + O usuário que executa o `OEM_AGENT` no host do Amazon RDS não tem acesso ao log de alertas pelo sistema operacional. Assim, você não pode coletar métricas para `DB Alert Log` e `DB Alert Log Error Status` no OEM. ## Configurações de opção do Management Agent O Amazon RDS oferece suporte para as seguintes configurações da opção Management Agent. | Configuração da opção | Obrigatório | Valores válidos | Descrição | | --- | --- | --- | --- | | **Version (Versão** (`AGENT_VERSION`) | Sim | `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` | A versão do software Management Agent. A versão mínima compatível é `13.1.0.0.v1`. O nome da opção da AWS CLI é `OptionVersion`. Nas regiões AWS GovCloud (US), as versões 13.1 não estão disponíveis. | | **Port (Porta** (`AGENT_PORT`) | Sim | Um valor inteiro | A porta na instância de banco de dados que escuta o host do OMS. O padrão é 3872. Seu host OMS deve pertencer a um grupo de segurança que tenha acesso a essa porta. O nome da opção da AWS CLI é `Port`. | | **Grupos de segurança** | Sim | Grupos de segurança existentes | Um grupo de segurança tem acesso à **Port (Porta)**. Seu host OMS deve pertencer a esse grupo de segurança. O nome da opção da AWS CLI é `VpcSecurityGroupMemberships` ou `DBSecurityGroupMemberships`. | | **OMS\$1HOST** | Sim | Um valor de string, por exemplo, *my.example.oms* | O nome do host ou endereço IP publicamente acessível do OMS. O nome da opção da AWS CLI é `OMS_HOST`. | | **OMS\$1PORT** | Sim | Um valor inteiro | A porta de upload HTTPS no host do OMS que escuta o Management Agent. Para determinar a porta de upload HTTPS, conecte-se ao host do OMS e execute o seguinte comando (que requer a senha `SYSMAN`): emctl status oms -details O nome da opção da AWS CLI é `OMS_PORT`. | | **AGENT\$1REGISTRATION\$1PASSWORD** | Sim | Um valor de string | A senha usada pelo Management Agent para autenticar-se no OMS. Recomendamos criar uma senha persistente no OMS antes de habilitar a opção `OEM_AGENT`. Com uma senha persistente, você pode compartilhar um único grupo de opções do Management Agent entre vários bancos de dados do Amazon RDS. O nome da opção da AWS CLI é `AGENT_REGISTRATION_PASSWORD`. | | **ALLOW\$1TLS\$1ONLY** | Não | `true`, `false` (padrão) | Um valor que configura o OEM Agent para oferecer suporte apenas ao protocolo `TLSv1` enquanto o agente escuta como um servidor. Essa configuração não é mais compatível. Por padrão, as versões do Management Agent 13.1.0.0.v1 e posterior são compatíveis com Transport Layer Security (TLS). | | **MINIMUM\$1TLS\$1VERSION** | Não | `TLSv1` (padrão), `TLSv1.2` | Um valor que especifica a versão mínima do TLS compatível com o OEM Agent enquanto o agente escuta como um servidor. Versões sem suporte do agente são compatíveis apenas com a definição de `TLSv1`. Para conectar a versão 13.5.0.0 (v1-v3) a um host do OMS 24.1, defina essa configuração como `TLSv1.2`. | | **TLS\$1CIPHER\$1SUITE** | Não | Consulte [Configurações de opção do Management Agent](#Oracle.Options.OEMAgent.Options). | Um valor que especifica o conjunto de cifras TLS usado pelo OEM Agent enquanto o agente escuta como um servidor. | A tabela a seguir lista os conjuntos de cifras TLS compatíveis com a opção Management Agent. | Pacote de cifras | Versão do Agent compatível | Conformidade com FedRAMP | | --- | --- | --- | | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | Todos | Não | | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 | 13.1.0.0.v1 e posterior | Não | | TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 e posterior | Não | | TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA256 | 13.2.0.0.v3 e posterior | Não | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA | 13.2.0.0.v3 e posterior | Sim | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA | 13.2.0.0.v3 e posterior | Sim | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 | 13.2.0.0.v3 e posterior | Sim | | TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | 13.2.0.0.v3 e posterior | Sim | | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1SHA384 | 13.4.0.9.v1 e posterior | Sim | | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | 13.4.0.9.v1 e posterior | Sim | ### Compatibilidade de certificados com pacotes de criptografia O RDS para Oracle comporta os certificados RSA e Elliptic Curve Digital Signature Algorithm (ECDSA). Ao configurar a opção Agente OEM para sua instância de banco de dados, você deve garantir que os pacotes de criptografia especificados na configuração da opção `TLS_CIPHER_SUITE` aceitem o tipo de certificado usado pela sua instância de banco de dados. A tabela a seguir mostra a compatibilidade entre os tipos de certificado e pacotes de criptografia: | Tipo de certificado | Pacotes de criptografia compatíveis | Pacotes de criptografia incompatíveis | | --- | --- | --- | | Pacotes de RSA (rds-ca-2019, rds-ca-rsa2048-g1, rds-ca-rsa4096-g1) | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1SHA384 TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | | Certificados ECDSA (rds-ca-ecc384-g1) | TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1GCM\$1SHA384 TLS\$1ECDHE\$1ECDSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1128\$1CBC\$1SHA256 TLS\$1ECDHE\$1RSA\$1WITH\$1AES\$1256\$1CBC\$1SHA384 | Ao especificar um pacote de criptografia na configuração da opção `TLS_CIPHER_SUITE`, verifique se é compatível com o tipo de certificado usado por sua instância de banco de dados. Se você tentar associar um grupo de opções a uma opção do Agente OEM que contenha um pacote de criptografia incompatível com o tipo de certificado de uma instância de banco de dados, a operação falhará com uma mensagem de erro indicando a incompatibilidade. ## Habilitar a opção Management Agent para uma instância de banco de dados Para habilitar a opção Management Agent, use as seguintes etapas: **Topics** + [Etapa 1: adicionar a opção Management Agent a uma instância de banco de dados](#Oracle.Options.OEMAgent.Add) + [Etapa 2: Desbloquear a conta de usuário DBSNMP](#Oracle.Options.OEMAgent.DBSNMP) + [Etapa 3: Adicionar seus destinos ao console do Agente de gerenciamento](#Oracle.Options.OEMAgent.Using) ### Etapa 1: adicionar a opção Management Agent a uma instância de banco de dados Para adicionar a opção Agente de gerenciamento à instância de banco de dados, faça o seguinte: 1. Crie um novo grupo de opções, ou copie ou modifique um existente. 1. Adicione a opção ao grupo de opções. 1. Associe o grupo de opções à instância de banco de dados. Se você encontrar erros, poderá verificar os documentos no [My Oracle Support](https://support.oracle.com/) para obter informações sobre como resolver problemas específicos. Depois de adicionar a opção Management Agent, você não precisará reiniciar sua instância de banco de dados. Assim que o grupo de opções estiver ativo, o OEM Agent estará ativo. Se o host OMS estiver usando um certificado de terceiros não confiáveis, o Amazon RDS retorna o erro a seguir. ``` 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. ``` Se o erro for retornado, a opção do Management Agent não estará habilitada até que o problema seja corrigido. Para obter informações sobre como corrigir o problema, consulte o documento My Oracle Support [2202569.1](https://support.oracle.com/epmos/faces/DocContentDisplay?id=2202569.1). #### Console **Como adicionar a opção Agente de gerenciamento a uma instância de banco de dados** 1. Determine o grupo de opções que você deseja usar. Você pode criar um novo grupo de opções ou usar um existente. Se você quiser usar um grupo de opções existente, vá para a próxima etapa. Caso contrário, crie um grupo de opções de banco de dados personalizado com as seguintes configurações: 1. Em **Engine (Mecanismo)**, escolha a edição Oracle para sua instância de banco de dados. 1. Para **Major engine version (Versão do mecanismo principal)**, escolha a versão da sua instância de banco de dados. Para obter mais informações, consulte [Criar um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.Create). 1. Adicione a opção **OEM\$1AGENT** ao grupo de opções e defina as configurações da opção. Para obter mais informações sobre a adição de opções, consulte [Adicionar uma opção a um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.AddOption). Para obter mais informações sobre cada configuração, consulte [Configurações de opção do Management Agent](#Oracle.Options.OEMAgent.Options). 1. Aplique o grupo de opções a uma instância de banco de dados nova ou existente: + Para uma nova instância de banco de dados, você aplica o grupo de opções ao executar a instância. Para ter mais informações, consulte [Criar uma instância de banco de dados do Amazon RDS](USER_CreateDBInstance.md). + Para uma instância de banco de dados existente, você aplica o grupo de opções modificando a instância e anexando o novo grupo de opções. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md). #### AWS CLI O exemplo a seguir usa o comando da AWS CLI [add-option-to-option-group](https://docs.aws.amazon.com/cli/latest/reference/rds/add-option-to-option-group.html) para adicionar a opção `OEM_AGENT` a um grupo de opções chamado `myoptiongroup`. Para Linux, macOS ou 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 ``` Para 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 ``` ### Etapa 2: Desbloquear a conta de usuário DBSNMP O Agente de Gerenciamento usa a conta do usuário `DBSNMP` para se conectar ao banco de dados e relatar problemas ao Oracle Enterprise Manager. Em um CDB, `DBSNMP` é um usuário comum. Essa conta de usuário é necessária tanto para o Agente de gerenciamento quanto para o OEM Database Express. Por padrão, essa conta está bloqueada. O procedimento para desbloquear essa conta difere dependendo se seu banco de dados usa a arquitetura não CDB ou CDB. **Como desbloquear a conta de usuário DBSNMP** 1. No SQL\$1Plus ou em outra aplicação Oracle SQL, faça login como usuário principal em sua instância de banco de dados. 1. Realize uma das seguintes ações, dependendo da arquitetura do banco de dados: **O banco de dados não é CDB.** Execute a seguinte declaração SQL: ``` 1. ALTER USER dbsnmp IDENTIFIED BY new_password ACCOUNT UNLOCK; ``` **O banco de dados é CDB.** Execute o seguinte procedimento armazenado para desbloquear a conta `DBSNMP`: ``` 1. EXEC rdsadmin.rdsadmin_util.reset_oem_agent_password('new_password'); ``` Se você receber um erro informando que o procedimento não existe, reinicie sua instância do CDB para instalá-la automaticamente. Para obter mais informações, consulte [Reinicializar uma instância de banco de dados](USER_RebootInstance.md). ### Etapa 3: Adicionar seus destinos ao console do Agente de gerenciamento Para adicionar uma instância de banco de dados como destino, você deve conhecer o endpoint e a porta. Para obter informações sobre como localizar o endpoint de sua instância de banco de dados do Amazon RDS, consulte [Encontrar o endpoint da instância de banco de dados do RDS para Oracle](USER_Endpoint.md). Se o banco de dados usa a arquitetura CDB, adicione o contêiner `CDB$ROOT` separadamente como destino. **Como adicionar destinos ao console do Agente de gerenciamento** 1. No seu console do OMS, escolha **Setup (Configurar)**, **Add Target (Adicionar destino)**, **Add Targets Manually (Adicionar destinos manualmente)**. 1. Escolha **Add Targets Declaratively by Specifying Target Monitoring Properties (Adicionar destinos de forma declarativa especificando as propriedades de monitoramento do destino)**. 1. Para **Target Type (Tipo de destino)**, escolha **Database Instance (Instância de banco de dados)**. 1. Em **Monitoring Agent (Agente de monitoramento)**, escolha o agente com o identificador igual ao identificador de instância de banco de dados do RDS. 1. Escolha **Add Manually (Adicionar manualmente)**. 1. Insira o endpoint da instância de banco de dados do Amazon RDS ou escolha-o na lista de nomes de host. Verifique se o nome de host especificado corresponde ao endpoint da instância de banco de dados do Amazon RDS. 1. Especifique as seguintes propriedades do banco de dados: + Em **Target Name (Nome do destino)**, insira um nome. + Em **Database system name (Nome do sistema de banco de dados)**, insira um nome. + Em **Monitor username (Nome de usuário do monitor)**, insira **dbsnmp**. + Em **Senha do monitor**, insira a senha de [Etapa 2: Desbloquear a conta de usuário DBSNMP](#Oracle.Options.OEMAgent.DBSNMP). + Em **Role (Função)**, insira **normal**. + Em **Oracle home path (Caminho de início Oracle)**, insira **/oracle**. + Para **Listener Machine name (Nome da máquina ouvinte)**, o identificador do agente já é exibido. + Em **Port (Porta)**, insira a porta do banco de dados. A porta padrão do RDS é 1521. + Em **Database name (Nome do banco de dados)**, insira o nome do banco de dados. Se o banco de dados for um CDB, esse nome será `RDSCDB`. 1. Escolha **Test Connection (Testar conexão)**. 1. Escolha **Next (Próximo)**. O banco de dados de destino aparece na sua lista de recursos monitorados. ## Remover a opção Management Agent Você pode remover o OEM Agent de uma instância de banco de dados. Depois de remover a opção OEM Agent, você não precisará reiniciar sua instância de banco de dados. Para remover o OEM Agent de uma instância de banco de dados, siga um destes procedimentos: + Remova a opção OEM Agent do grupo de opções ao qual ela pertence. Essa alteração afeta todas as instâncias de bancos de dados que usam o grupo de opções. Para obter mais informações, consulte [Remover uma opção de um grupo de opções](USER_WorkingWithOptionGroups.md#USER_WorkingWithOptionGroups.RemoveOption). + Modifique a instância de banco de dados e especifique um grupo de opções diferente que não inclua a opção OEM Agent. Essa alteração afeta uma única instância de banco de dados. Você pode especificar um grupo de opções padrão (vazio) ou criar um grupo de opções personalizado diferente. Para obter mais informações, consulte [Modificar uma instância de banco de dados do Amazon RDS](Overview.DBInstance.Modifying.md). ## Como executar tarefas de banco de dados com o Management Agent Você pode usar os procedimentos do Amazon RDS para executar determinados comandos EMCTL no Management Agent. Executando esses procedimentos, você pode executar as tarefas listadas a seguir. **nota** As tarefas são executadas de forma assíncrona. **Topics** + [Proteger o Management Agent](#Oracle.Options.OEMAgent.DBTasks.SecureAgent) + [Obter o status do Management Agent](#Oracle.Options.OEMAgent.DBTasks.GetAgentStatus) + [Como reiniciar o Management Agent](#Oracle.Options.OEMAgent.DBTasks.RestartAgent) + [Como listar os destinos monitorados pelo Management Agent](#Oracle.Options.OEMAgent.DBTasks.ListTargets) + [Listar os threads de coleta monitorados pelo Management Agent](#Oracle.Options.OEMAgent.DBTasks.ListCollectionThreads) + [Como limpar o estado do Management Agent](#Oracle.Options.OEMAgent.DBTasks.ClearState) + [Como fazer o Management Agent carregar o OMS](#Oracle.Options.OEMAgent.DBTasks.ForceUploadOMS) + [Como executar ping no OMS](#Oracle.Options.OEMAgent.DBTasks.PingOMS) + [Como visualizar o status de uma tarefa em andamento](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus) ### Proteger o Management Agent Para proteger o Management Agent, execute o procedimento `rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent` do Amazon RDS. Este procedimento é equivalente à execução do comando `emctl secure agent`. O seguinte procedimento cria uma tarefa para proteger o Management Agent e exibe o ID da tarefa: ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.secure_oem_agent as TASK_ID from DUAL; ``` Para exibir a saída referente à tarefa e visualizar o resultado, consulte [Como visualizar o status de uma tarefa em andamento](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Obter o status do Management Agent Para obter o status do Management Agent, execute o procedimento do Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent`. Este procedimento é equivalente ao comando `emctl status agent`. O procedimento a seguir cria uma tarefa para obter o status do Management Agent e retorna o ID da tarefa. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.get_status_oem_agent() as TASK_ID from DUAL; ``` Para exibir a saída referente à tarefa e visualizar o resultado, consulte [Como visualizar o status de uma tarefa em andamento](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Como reiniciar o Management Agent Para reiniciar o Management Agent, execute o procedimento do Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent`. Este procedimento é equivalente à execução dos comandos `emctl stop agent` e `emctl start agent`. O procedimento a seguir cria uma tarefa para reiniciar o Management Agent e retorna o ID da tarefa. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.restart_oem_agent as TASK_ID from DUAL; ``` Para exibir a saída referente à tarefa e visualizar o resultado, consulte [Como visualizar o status de uma tarefa em andamento](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Como listar os destinos monitorados pelo Management Agent Para listar os destinos monitorados pelo Management Agent, execute o procedimento do Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent`. Este procedimento é equivalente à execução do comando `emctl config agent listtargets`. O procedimento a seguir cria uma tarefa para listar os destinos monitorados pelo Management Agent e retorna o ID da tarefa. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_targets_oem_agent as TASK_ID from DUAL; ``` Para exibir a saída referente à tarefa e visualizar o resultado, consulte [Como visualizar o status de uma tarefa em andamento](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Listar os threads de coleta monitorados pelo Management Agent Para listar todos os threads de coleta em execução, prontos e programados que são monitorados pelo Management Agent, execute o procedimento do Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent`. Este procedimento é equivalente ao comando `emctl status agent scheduler`. O procedimento a seguir cria uma tarefa para listar os threads de coleta e retorna o ID da tarefa. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.list_clxn_threads_oem_agent() as TASK_ID from DUAL; ``` Para exibir a saída referente à tarefa e visualizar o resultado, consulte [Como visualizar o status de uma tarefa em andamento](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Como limpar o estado do Management Agent Para limpar o estado do Management Agent, execute o procedimento do Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent`. Este procedimento é equivalente à execução do comando `emctl clearstate agent`. O procedimento a seguir cria uma tarefa que limpa o estado do Management Agent e retorna o ID da tarefa. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.clearstate_oem_agent() as TASK_ID from DUAL; ``` Para exibir a saída referente à tarefa e visualizar o resultado, consulte [Como visualizar o status de uma tarefa em andamento](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Como fazer o Management Agent carregar o OMS Para que o Management Agent carregue o Oracle Management Server (OMS) associado a ele, execute o procedimento do Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent`. Este procedimento é equivalente à execução do comando `emclt upload agent`. O procedimento a seguir cria uma tarefa que faz com que o Management Agent faça upload do OMS associado e retorne o ID da tarefa. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.upload_oem_agent() as TASK_ID from DUAL; ``` Para exibir a saída referente à tarefa e visualizar o resultado, consulte [Como visualizar o status de uma tarefa em andamento](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Como executar ping no OMS Para executar ping no OMS do Management Agent, execute o procedimento do Amazon RDS `rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent`. Este procedimento é equivalente à execução do comando `emctl pingOMS`. O procedimento a seguir cria uma tarefa que executa ping no OMS do Management Agent e retorna o ID da tarefa. ``` SELECT rdsadmin.rdsadmin_oem_agent_tasks.ping_oms_oem_agent() as TASK_ID from DUAL; ``` Para exibir a saída referente à tarefa e visualizar o resultado, consulte [Como visualizar o status de uma tarefa em andamento](#Oracle.Options.OEMAgent.DBTasks.ViewTaskStatus). ### Como visualizar o status de uma tarefa em andamento Você pode visualizar o status de uma tarefa em andamento em um arquivo bdump. Os arquivos bdump estão localizados no diretório `/rdsdbdata/log/trace`. Cada nome de arquivo bdump está no seguinte formato. ``` dbtask-task-id.log ``` Quando quiser monitorar uma tarefa, substitua `task-id` pelo ID da tarefa que deseja monitorar. Para visualizar o conteúdo dos arquivos bdump, execute o procedimento do Amazon RDS `rdsadmin.rds_file_util.read_text_file`. A consulta a seguir retorna o conteúdo do arquivo bdump `dbtask-1546988886389-2444.log`. ``` SELECT text FROM table(rdsadmin.rds_file_util.read_text_file('BDUMP','dbtask-1546988886389-2444.log')); ``` Para obter mais informações sobre o procedimento `rdsadmin.rds_file_util.read_text_file` do Amazon RDS, consulte [Leitura de arquivos no diretório de uma instância de banco de dados](Appendix.Oracle.CommonDBATasks.Misc.md#Appendix.Oracle.CommonDBATasks.ReadingFiles).