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

Olá pessoal,

Espero que estejam bem!

Um cliente nos contatou solicitando que atualizássemos o seu ambiente de Oracle Enterprise Manager e os agentes do 13.5.0.16 para a última release disponível.

Primeiro de tudo, nós precisamos entender de qual nota de suporte nós podemos encontrar o último RU disponível para o RU. Vamos lá:

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

Temos muitas informações nessa nota, eu vou mostrar abaixo as duas seções onde podemos obter o último RU para o OEM e o último RU para o OEM Agent.

Abaixo temos a informação para o último RU para o OMS (Oracle Management Service), o servidor de OEM propriamente dito:

Abaixo temos a informação para o último RU para o OEM Agent:

OK, então por enquanto, sabemos que temos que aplicar pelo menos dois patches:

• 36005341: RU 20 para o OMS
• 36005346: RU 20 para o OEM Agent

Agora, temos que checar a nota para o patch:

13.5.0 Enterprise Manager Cloud Control Base Platform Monthly Release Update (RU) 20 (Doc ID 3006198.1)

Nessa nota, podemos encontrar algumas informações úteis:

Então, basicamente, temos três instruções principais aqui:

• Passos obrigatórios a serem executados depois de aplicarmos o RU;
• Patches obrigatórios a serem aplicados antes de aplicarmos o RU;
• Se o seu DB repositório está rodando no RU 19.18, também há patch(es) mandatório(s). No nosso caso, nós não temos que aplicar o patch porque o repositório está rodando no RU 19.21.

Por favor, tenham em mente que antes de iniciarmos com a aplicação do patch no OEM e nos OEM Agents, nós também temos que atualizar as ferramentas que usaremos para esse update. Mas, como temos que também aplicar alguns “one-off” patches no OEM antes do RU, também precisamos atualizar a tool que será usada para aplicar os “one-off” patches no OEM.

Se você é um DBA, você provavelmente já conhece bem sobre o OPatch. OK, para o OEM/OEM Agent, as tools são um pouco diferentes:

• omspatcher: para aplicar patches no OMS
• opatch: para aplicar os one-off patches no OMS
• agentpatcher: para aplicar patches no OEM Agent

Perfeito, então temos que atualizar o omspatcher, opatch and agentpatcher, você precisa seguir três notas para isso:

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)

PATCH 28186730 – OPATCH 13.9.4.2.14 FOR EM 13.4, 13.5 and FMW/WLS 12.2.1.3.0, 12.2.1.4.0 AND 14.1.1.0.0

Então, para resumir, para que consigamos atualizar o omspatcher, opatch e agentpatcher, os seguintes patches precisam ser aplicados:

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

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

Patch 28186730: OPatch 13.9.4.2.14 for EM 13.4, EM 13.5 and FMW/WLS 12.2.1.3.0, 12.2.1.4.0 and 14.1.1.0.0

Perfeito, então precisamos fazer o download de 8 arquivos no total:

• ————————————————–
• Servidor OEM:
  • 36005341: RU 16 para o OMS
  • 19999993: OMSPatcher version 13.9.5.18.0
  • 35430934: MERGE REQUEST ON TOP OF 12.2.1.4.0 FOR BUGS 32720458 33607709
  • 34153238: HTTPS PROXY CONFIGURATION IS NOT USED WHEN PROTOCOL IS CONFIGURED TO TCP
  • 31657681: THREADS CONTEND FOR LOCK IN LOADFILEBASEDKEYSTORE WHEN OPENING TLS/SSL ENABLED JDBC CONNECTIONS
  • 28186730: OPatch 13.9.4.2.14 for EM 13.4, EM 13.5 and FMW/WLS 12.2.1.3.0, 12.2.1.4.0 and 14.1.1.0.0
• ————————————————–
• OEM Agent:
  • 36005346: RU 20 for OEM Agent
  • 33355570: AgentPatcher version 13.9.5.6.0
• ————————————————–

Perfeito!

Vamos então realizar o update do OMSPatcher e OPatch.

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

O usuário no sistema operacional que é o owner do OEM é o: oraoem.

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, precisamos fazer o seguinte:

• Fazer um backup do diretório atual do omspatcher;
• Descompactar/extrair o patch 19999993 no $ORACLE_HOME para “instalar” o novo omspatcher;
• Checar se o omspatcher foi atualizado.
• Descompactar/extrair o patch 28186730 (para atualizar o OPatch);
• Aplicar o patch 28186730;
• Checar se o OPatch foi atualizado.

Com o usuário que é o dono do OEM no sistema operacional (Linux):

Agora, vamos atualizar o OPatch:

OK, antes de aplicarmos os patches, é bom salvarmos algumas informações do nosso ambiente. Vamos checar o status do OMS com a flag details. Com o usuário oraoem:

Agora, precisamos aplicar os one-off patches, já que eles estão listados como requisitos para serem aplicados ANTES de aplicarmos o OEM 13.5 RU 20.

Os patches a serem aplicados agora estão listados abaixo:

• 35430934: MERGE REQUEST ON TOP OF 12.2.1.4.0 FOR BUGS 32720458 33607709
• 34153238: HTTPS PROXY CONFIGURATION IS NOT USED WHEN PROTOCOL IS CONFIGURED TO TCP
• 31657681: THREADS CONTEND FOR LOCK IN LOADFILEBASEDKEYSTORE WHEN OPENING TLS/SSL ENABLED JDBC CONNECTIONS

Todos os três patches listados acima possuem basicamente as mesmas instruções de Pré-Instalação:

Se você observar o Step 2 está bem claro: faça o Stop de todos os Servers (Admin Server e Managed Server(s)).

Para isso, precisamos parar o OEM. Tenha em mente que o comando para parar o OEM geralmente para somente o OEM, mas não o Admin Server. Para parar tudo, inclusive o Admin Server, você precisa usar a flag “-all”. Vamos fazer isso:

O próximo passo é aplicar os patches. Eu não vou mostrar todos os outputs/saídas porque o blog post ficaria imenso. Vou focar nos seguintes passos:

Então, eu vou executar os seguintes passos:

• Ir para o diretório stage onde eu tenho os arquivos de patch;
• Descompactar todos os arquivos de patch;
• Aplicar os patches um por um.

Quando o opatch perguntar por sua confirmação, simplesmente pressione “y” para seguir adiante.

Como um exemplo do opatch apply, vamos checar o output para um patch apenas:

Excelente! Os três patches mandatórios agora estão aplicados no OEM. Agora, para que possamos aplicar o RU 20, nós precisamos que o OEM continue em shutdown, mas que o Admin Server esteja iniciado, portanto, vamos iniciar o Admin Server. Moleza!

Você pode encontrar as sintaxes do emctl aqui:

Oracle Enterprise Manager – Cloud Control Administrator’s Guide – 13c Release 5 – EMCTL Commands for OMS

Vamos lá:

O próximo passo é rodar o analyze para checar se o patch está OK e se não temos nenhum conflito antes de aplicarmos o patch de fato. Primeiro temos que extrair o arquivo de patch:

Agora, vamos rodar o analyze:

Você terá que entrar com algumas informações, como o usuário do Weblogic, a senha desse usuário, um usuário para o BD e a sua senha:

O output foi truncado para facilitar a leitura:

A sessão de analyze terminou com sucesso. Agora podemos proceder com o patch:

Você terá que entrar com algumas informações, como o usuário do Weblogic, a senha desse usuário, um usuário para o BD e a sua senha:

O output foi truncado para facilitar a leitura:

Patch aplicado, vamos checar no OEM:

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

A tela abaixo será exibida:

Perfeito! Agora o OEM está rodando no 13.5 Release Update 20

OK, se você se lembra, nós temos alguns passos para rodar DEPOIS de aplicar o RU:

Vamos para a nota recomendada:

Release of Fixes to Support OAuth move from OAM to IDCS (Doc ID 2998693.1)

Esse cliente não está usando a abordagem “Online mode” de aplicação de patches através do OEM, essa abordagem é usada quando o OEM consegue conectar no My Oracle Support (Metalink). Portanto, como você pode ver abaixo, os passos mencionados na nota acima não são obrigatórios no nosso caso:

Perfeito, então nós concluímos a parte de update do OMS para o RU 20.

O 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:

O AgentPatcher foi atualizado, o próximo passo é realizar o upload do patch 36005346 (Oracle Enterprise Manager 13c Release 5 Update 20 (20) 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: p36005346_135000_Generic.zip
• O arquivo de metadados (metadata) do patch: p36005346_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:

O próximo passo é buscar pelo patch 36005346 e assim que o patch for exibido, clique em Create a Plan. Isso permitirá que criemos um Patch Plan.

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:

Na próxima tela, você pode definir um nome para o seu Patch Plan e então clicar em Add para adicionar os Targets (Hosts) onde você quer aplicar o patch:

Com os hosts especificados (como eu disse, nesse exemplo eu usei somente um host para validar o procedimento – e também note que o hostname real foi alterado por questões de segurança), clique agora no botão Create Plan:

Agora que o Patch Plan foi criado. Clique em cima do Patch Plan:

Na primeira tela do Patch Plan, nós temos algumas poucas informações. Simplesmente clique em Next:

Na próxima tela, nós temos todos os patches que serão aplicados nesse patch plan. No nosso caso, nós temos apenas o patch 36005346, que é o o OEM 13c RU 20 para o Agent. Clique em Next novamente:

Na próxima tela, nós temos listadas as opções de deployment, além do Oracle Home, Host e Agente onde o patch será aplicado. Clique em Next:

Na próxima tela, recebemos a informação que uma Validação é obrigatória para esse patch. Isso é para garantir que não há conflitos ao aplicar o patch. Clique em Analyze:

A Validação/Análise começará. Se você quiser, pode ver mais detalhes clicando em Show Detailed Results:

Uma vez que você clicou em Show Detailed Results, uma nova aba será aberta no seu browser. Meu conselho é mudar o Auto Refresh para 15 segundos. Assim você pode monitorar o Status para a tarefa:

Nós podemos ver na tela acima que a Análise foi concluída com sucesso. Agora, nosso plano está na fase Ready for Deployment. Clique em Next:

Uma vez que estamos na tela de Ready for Deployment, simplesmente clique no botão Deploy:

Você pode escolher entre fazer o Deploy imediatamente ou agendar para um momento posterior. No meu caso, escolhi a opção para fazer o Deploy imediatamente:

Uma vez que você clicou em Submit, o deployment do patch vai começar. Se você quiser, você também pode checar os detalhes (eu vou colocar abaixo ambas as telas, mas como você pode ver, o deploy foi implementado com sucesso):

Perfeito! Agora o agente nesse servidor específico foi atualizado para o Oracle Enterprise Manager 13c Release 5 Update 20 (13.5.0.20).

Agora, você pode criar um novo Patch Plan e adicionar o restante dos seus servidores (sim, você pode adicionar todos os outros servidores para fazer a aplicação do patch em todos ao mesmo tempo, em paralelo). Uma vez que você adicionar todos os servidores restantes e seguir os mesmos passos acima listados, o Oracle Enterprise Manager 13c Release 5 Update 20 (13.5.0.20) será aplicado em todos os OEM Agents.

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) 20 (Doc ID 3006198.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.18.0 for Enterprise Manager Cloud Control 13.5.0.0.0
Patch 36005341: Oracle Enterprise Manager 13c Release 5 Update 20 (13.5.0.20) for Oracle Management Service
PATCH 28186730 – OPATCH 13.9.4.2.14 FOR EM 13.4, 13.5 and FMW/WLS 12.2.1.3.0, 12.2.1.4.0 AND 14.1.1.0.0
Patch 35430934: MERGE REQUEST ON TOP OF 12.2.1.4.0 FOR BUGS 32720458 33607709
Patch 34153238: HTTPS PROXY CONFIGURATION IS NOT USED WHEN PROTOCOL IS CONFIGURED TO TCP
Patch 31657681: THREADS CONTEND FOR LOCK IN LOADFILEBASEDKEYSTORE WHEN OPENING TLS/SSL ENABLED JDBC CONNECTIONS

Agente:

13.5: How to Upgrade AgentPatcher to the Latest Version (Doc ID 2810322.1)
Patch 36005346: Oracle Enterprise Manager 13c Release 5 Update 20 (13.5.0.20) 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: No último ano, eu criei um post para mostrar um playbookAnsible bem simples para atualizar o AgentPatcher em todos os servidores onde temos o OEM Agent rodando. Dessa vez, eu vou criar um post em breve para mostrar como exibir a versão de RU do OEM Agent usando um playbook Ansible. Isso será útil para validar a versão do OEM Agent após o patch.

Você pode ver os posts do último ano aqui:

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

Ansible Playbook para atualizar o AgentPatcher dos Agentes do OEM