Como atualizar o Oracle Enterprise Manager do RU 13.5.0.9 para o RU 13.5.0.16 

Olá pessoal,

Espero que estejam bem!

Um cliente entrou em contato solicitando para que atualizássemos o ambiente dele de Oracle Enterprise Manager (e seus agents também) da versão 13.5.0.9 para a última Release Update disponível.

Em primeiro lugar, precisamos entender em qual nota de suporte podemos encontrar o último RU disponível. Vamos lá:

Enterprise Manager 13.5 Main Release Update List (Includes Plug-ins) (Doc ID 2760230.2)

Nós temos muitas informações nessa nota, eu vou mostrar abaixo apenas duas seções de onde obtive o último RU disponível para o OEM e para os Agents do OEM:

Abaixo nós temos a informação do último RU disponível para o OMS (Oracle Management Service), o servidor do OEM propriamente dito:

Abaixo temos a informação do último RU disponível para o OEM Agent:

OK, então nós temos pelo menos dois patches:

• 35437906: RU 16 para o OMS
• 35437910: RU 16 para o OEM Agent

Mas, tenha em mente que antes de aplicar um patch/atualizar o OMS and OEM Agent, a gente precisa também atualizar a ferramenta que realiza esse update. Se você é um DBA, você sabe muito bem sobre o OPatch. OK, para o OEM/OEM Agent, as ferramentas são um pouco diferentes:

• omspatcher: para aplicar patches no OMS
• agentpatcher: para aplicar patches no OEM Agent

Ótimo, então nós também temos que atualizar o omspatcher e o agentpatcher, você precisará seguir as duas notas abaixo:

13.5: How To Upgrade Enterprise Manager 13.5 Cloud Control OMSPatcher Utility to the Latest Version (Doc ID 2809842.1)

13.5: How to Upgrade AgentPatcher to the Latest Version (Doc ID 2810322.1)

Então, resumindo, para poder atualizar o omspatcher e o agentpatcher para as versões mais recentes:

Patch 19999993: OMSPatcher patch of version 13.9.5.14.0 for Enterprise Manager Cloud Control 13.5.0.0.0

Patch 33355570: AgentPatcher release of version 13.9.5.5.0 for Enterprise Manager Cloud Control Agent 13.5.0.0.0

Ótimo, então temos que fazer o download de quatro arquivos no total:

• ————————————————–
• 35437906: RU 16 para o OMS
• 19999993: OMSPatcher version 13.9.5.14.0
• ————————————————–
• 35437910: RU 16 para o OEM Agent
• 33355570: AgentPatcher version 13.9.5.5.0
• ————————————————–

Vamos iniciar atualizando o OMSPatcher.

O ORACLE_HOME para o OEM é: /u04/app/oracle/product/OEM_135.

A variável de ambiente PATH está definida como:

$ORACLE_HOME/bin:$ORACLE_HOME/OMSPatcher:/usr/local/bin:/bin:/usr/bin:/usr/local/sbin:/usr/sbin:

Basicamente a gente precisa:

• Fazer um backup do diretório atual do omspatcher;
• Realizar o unzip do patch 19999993 no $ORACLE_HOME para “instalar” o novo omspatcher;
• Testar se o omspatcher foi atualizado.

Com o usuário que é o owner do OEM no Linux:

OK, então antes de iniciarmos realmente aplicando o patch, é bom salvar algumas informações sobre o nosso ambiente, pois parte dessas informações serão usadas em alguns passos durante o patch. Vamos pegar o status do OMS com a flag details. Com o usuário oraoem (no meu ambiente o usuário é oraoem):

Preste atenção na seguinte linha:

Admin Server HTTPS Port: 7102

Essa é a porta do Weblogic Server. Nós precisaremos dessa porta para criar um property file antes de aplicarmos o patch.

Mas… o que é um property file?

Durante o patch do OEM, será necessário informar/realizar o input das credenciais do Weblogic. Para evitar realizar o input das credenciais mais de uma vez, você pode criar um property file, portanto, a atividade de patching vai ler as credenciais do property file e você não precisará realizar o input das credenciais do Weblogic durante a operação de patch.

O primeiro passo é criar as “chaves”. Você precisará realizar o input do usuário administrador do Weblogic e também a senha desse usuário. Como referência, geralmente esse usuário se chama weblogic.

Da saída/output acima, nós precisaremos obter/copiar a URL para se conectar ao Weblogic usando o protocolo t3s, que no nosso caso é:

t3s://OEM-01.domain.com:7102

Os arquivos de config e de chave (key) foram criados:

• /home/oraoem/config
• /home/oraoem/key

Agora, vamos criar o property file, no diretório /home/oraoem (ou em qualquer outro que tenha acesso), crie um arquivo chamado property_file com o seguinte conteúdo:

AdminServerURL=t3s://OEM-01.domain.com:7102
AdminConfigFile=/home/oraoem/config
AdminKeyFile=/home/oraoem/key

Próximo passo é realizar o analyze para verificar se tudo está em ordem antes de aplicar o patch. Mas, antes de executar o analyze, nós precisamos realizar o unzip do arquivo de patch.

Agora, vamos rodar o analyze:

Você precisará realizar o input de um usuário de banco de dados e senha, vamos usar o usuário SYS:

A saída abaixo está truncada para facilitar a leitura:

A sessão de analyze finalizou com sucesso, vamos agora aplicar o patch. Mas, antes de aplicar o patch, precisamos parar, realizar o stop, do OMS:

Você precisará novamente realizar o input de um usuário de banco de dados e senha, vamos usar o usuário SYS:

A saída abaixo está truncada para facilitar a leitura:

O patch foi aplicado, vamos verificar agora no OEM.

Na página principal do OEM, clique em SYSMAN / About Enterprise Manager:

A próxima página será exibida:

Perfeito! Agora o oEM está rodando no 13.5 Release Update 16.

Próximo passo é aplicar o patch nos OEM Agents, o primeiro passo é atualizar o utilitário AgentPatcher e, todos os servidores onde temos o agent rodando. Para identificar todos os servidores onde temos agentes rodando, você pode realizar as seguintes tarefas no servidor do OEM. Primeiro, você precisa logar com o usuário SYSMAN, e então listar os targets onde o tipo seja oracle_emd (agents):

Agora que temos a lista de todos os servidores onde o agente está rodando, você precisará realizar os seguintes passos com o usuário que é o dono da instalação do agente em cada servidor:

AgentPatcher foi atualizado, o próximo passo é realizar o upload do patch 35437910 (Oracle Enterprise Manager 13c Release 5 Update 16 (13.5.0.16) for Oracle Management Agent) no OEM, como esse ambiente do OEM não está conectado na Internet, nós precisamos usar a abordagem de patching Offline. Antes de realizar o upload do patch para o OEM, é necessário realizar o download de dois arquivos antes:

• O arquivo de patch propriamente dito: p35437910_135000_Generic.zip
• O arquivo de metadados (metadata) do patch: p35437910_135000_American English_M.xml

Você pode baixar ambos os arquivos da mesma janela de download do patch no Metalink / My Oracle Support:

Vamos fazer o upload do patch, clique em Enterprise / Provisioning and Patching / Saved Patches:

Clique agora em Upload:

Agora escolha os arquivos de patch (arquivo zip) e o arquivo de metadados, que foram baixados no passo anterior:

Depois de algum tempo, o upload do patch para o OEM será finalizado:

Agora estamos prontos para aplicar o patch nos Agents. Para isso, primeiro clique em Enterprise / Provisioning and Patching / Patches & Updates:

Infelizmente não tenho os próximos screenshots, mas, eu vou colocar abaixo todos os passos necessários para aplicar o patch nos agents. Eu recomendo que você primeiro aplique o patch em um único agente, e após o término nesse agente, você poderá repetir os passos baixos para todos os outros servidores:

• Procure pelo patch de número: 35437910 (esse é o patch que fizemos upload anteriormente)
• Selecione o patch e clique em Create a Patch Plan
• Adicione o(s) host(s) onde deseja aplicar o patch
• Clique em Analyze, uma vez que o Analyze terminou com sucesso, clique em Deploy

Notas úteis que usei para essa atividade:

OMS:

Enterprise Manager 13.5 Main Release Update List (Includes Plug-ins) (Doc ID 2760230.2)
13.5.0 Enterprise Manager Cloud Control Base Platform Monthly Release Update (RU) 16 (Doc ID 2959173.1)
13.5: How To Upgrade Enterprise Manager 13.5 Cloud Control OMSPatcher Utility to the Latest Version (Doc ID 2809842.1)
Patch 19999993: OMSPatcher patch of version 13.9.5.14.0 for Enterprise Manager Cloud Control 13.5.0.0.0
Patch 35437906: Oracle Enterprise Manager 13c Release 5 Update 16 (13.5.0.16) for Oracle Management Service

Agent:

13.5: How to Upgrade AgentPatcher to the Latest Version (Doc ID 2810322.1)
Patch 35437910: Oracle Enterprise Manager 13c Release 5 Update 16 (13.5.0.16) for Oracle Management Agent
Patch 33355570: AgentPatcher release of version 13.9.5.5.0 for Enterprise Manager Cloud Control Agent 13.5.0.0.0

Espero que seja útil!

Um abraço!

Vinicius

PS: como bônus, vou criar m outro post com um playbook simples em Ansible para realizar o update do AgentPatcher em todos os servidores onde você tem o agente rodando.