Close Menu
Oracle Oracle RAC RAC

OPATCHAUTO-72083 — Bootstrap Operations Failed ao Aplicar Patch no Grid Infrastructure

HenriqueBy 5 Mins Read

This post is also available in: English (Inglês)

Ao executar o opatchauto para aplicar um Release Update no Grid Infrastructure, o processo pode falhar imediatamente com:

OPATCHAUTO-72083: Performing bootstrap operations failed.
OPATCHAUTO-72083: The bootstrap execution failed because null.
OPATCHAUTO-72083: Fix the reported problem and re-run opatchauto.
  In case of standalone SIDB installation and Grid is not installed
  re-run with -sidb option.

opatchauto bootstrapping failed with error code 255.

O erro acontece antes mesmo de aplicar o patch — o opatchauto falha na fase de inicialização (bootstrap), onde identifica o ambiente, os homes e o tipo de instalação. A mensagem “failed because null” é frustrante porque não diz a causa — mas a pista está nas mensagens que acompanham o erro.

Neste artigo, vou explicar as causas mais comuns do OPATCHAUTO-72083, como diagnosticar qual delas se aplica ao seu cenário e como corrigir.

💡 Na prática: Encontrei esse erro ao aplicar o RU 19.26 no Grid 19.25. A causa era o atributo CRS="true" no inventory.xml apontando para um Grid Home antigo (19.0.0.0) em vez do home ativo (19.25). O opatchauto não conseguia identificar a instalação do Grid e falhava no bootstrap.

O Que o Bootstrap do opatchauto Faz

Antes de aplicar qualquer patch, o opatchauto executa uma fase de bootstrap que:

  1. Lê o inventory.xml para identificar os Oracle Homes instalados
  2. Procura qual home tem o atributo CRS="true" — esse é o Grid Home ativo
  3. Verifica o tipo de instalação (RAC, Standalone HA, SIDB)
  4. Valida permissões, espaço e pré-requisitos
  5. Só então inicia a aplicação do patch

Se qualquer uma dessas etapas falhar, o bootstrap aborta com OPATCHAUTO-72083.

Causas Comuns e Como Diagnosticar

O OPATCHAUTO-72083 é um erro guarda-chuva — a causa real varia. Preste atenção nas mensagens que acompanham o erro para identificar qual cenário se aplica.

Causa 1: Atributo CRS=”true” no Home Errado (Mais Comum)

Essa foi a causa no meu ambiente. O inventory.xml tinha CRS="true" em um Grid Home antigo que não era mais o home ativo.

Pista no erro:

In case of standalone SIDB installation and Grid is not installed
re-run with -sidb option.

Isso indica que o opatchauto não encontrou um Grid Home ativo.

Diagnóstico:

grep -i 'CRS=' /u01/app/oraInventory/ContentsXML/inventory.xml

Resultado problemático:

<HOME NAME="OraGI19Home1" LOC="/u01/app/19.0.0.0/grid" TYPE="O" IDX="1" CRS="true"/>
<HOME NAME="Orasiha19c_home1_6835" LOC="/u01/app/19.25.0.0/grid" TYPE="O" IDX="13"/>

O CRS="true" está no home 19.0.0.0 (antigo), mas o Grid ativo é o 19.25.0.0.

Correção:

$GRID_HOME/oui/bin/runInstaller -updateNodeList \
  ORACLE_HOME=/u01/app/19.25.0.0/grid CRS=true

$GRID_HOME/oui/bin/runInstaller -updateNodeList \
  ORACLE_HOME=/u01/app/19.0.0.0/grid CRS=false

Validar:

grep -i 'CRS=' /u01/app/oraInventory/ContentsXML/inventory.xml

O CRS="true" deve estar apenas no home ativo.

Causa 2: OPatch Desatualizado

O opatchauto depende do OPatch para funcionar. Se a versão do OPatch é muito antiga para o RU que você está aplicando, o bootstrap falha.

Diagnóstico:

$GRID_HOME/OPatch/opatch version

Correção:

mv $GRID_HOME/OPatch $GRID_HOME/OPatch.bkp

unzip p6880880_190000_Linux-x86-64.zip -d $GRID_HOME/

$GRID_HOME/OPatch/opatch version

Causa 3: /etc/oracle/olr.loc Apontando para Home Errado

O arquivo /etc/oracle/olr.loc indica onde está o OLR (Oracle Local Registry). Se aponta para um Grid Home antigo, o opatchauto não encontra o Grid ativo.

Diagnóstico:

cat /etc/oracle/olr.loc

Resultado esperado:

olrconfig_loc=/u01/app/19.25.0.0/grid/cdata/hostname.olr
crs_home=/u01/app/19.25.0.0/grid

Se crs_home aponta para um home antigo, atualize manualmente.

Causa 4: Permissões Incorretas

O opatchauto deve ser executado como root. Além disso, o owner do Grid Home e do inventário devem estar corretos.

Diagnóstico:

ls -la /u01/app/19.25.0.0/ | grep grid

ls -la /u01/app/oraInventory/ContentsXML/inventory.xml

whoami

Causa 5: Espaço Insuficiente em /tmp

O opatchauto usa /tmp para operações de bootstrap. Se o filesystem está cheio, falha silenciosamente.

Diagnóstico:

df -h /tmp

Se estiver acima de 90%, libere espaço antes de tentar novamente.

Causa 6: Múltiplas Instalações de Grid no Inventário

Ambientes que passaram por múltiplos upgrades podem ter vários Grid Homes no inventário — incluindo homes removidos (REMOVED="T"). Em casos raros, isso confunde o bootstrap.

Diagnóstico:

grep -i "grid" /u01/app/oraInventory/ContentsXML/inventory.xml

Se houver muitos homes de Grid (ativos e removidos), considere limpar o inventário removendo as entradas antigas que não são mais necessárias.

Entendendo o inventory.xml

Para quem não está familiarizado, o inventory.xml é o arquivo que registra todos os Oracle Homes instalados no servidor. Fica em:

cat /etc/oraInst.loc

Atributos importantes no inventory.xml:

AtributoSignificado
LOCCaminho do Oracle Home
CRS="true"Identifica o Grid Home ativo — o opatchauto usa esse atributo
REMOVED="T"Home que foi desinstalada (ignorada pelo opatchauto)
IDXÍndice sequencial da instalação

Regra fundamental: Apenas um home deve ter CRS="true" — o Grid Home ativo atual.

Checklist Rápido de Diagnóstico

grep -i 'CRS=' /u01/app/oraInventory/ContentsXML/inventory.xml

$GRID_HOME/OPatch/opatch version

cat /etc/oracle/olr.loc

whoami

df -h /tmp

ls -la $(dirname $GRID_HOME) | grep grid

Conclusão

O erro OPATCHAUTO-72083 é um erro guarda-chuva que abrange várias causas possíveis durante a fase de bootstrap do opatchauto. A mensagem “failed because null” não ajuda, mas as mensagens que acompanham o erro indicam a direção.

O diagnóstico segue esta ordem de probabilidade:

  1. CRS="true" no home errado — verificar inventory.xml (causa mais comum)
  2. OPatch desatualizado — atualizar para a versão mais recente
  3. olr.loc apontando para home antigo — verificar /etc/oracle/olr.loc
  4. Permissões — executar como root, verificar owner dos homes
  5. Espaço em /tmp — liberar se necessário
  6. Inventário poluído — limpar homes antigos

O ponto mais importante: leia as mensagens que acompanham o erro. O OPATCHAUTO-72083 sozinho não diz nada — a causa está nos detalhes.

Referências:

Share.

Related Posts

Add A Comment
Leave A Reply