Résumé : Procédure d'upgrade d'Oracle Enterprise Manager 13c Release 5 vers Oracle Enterprise Manager 24ai Release 1, en mode "Software Only with Plug-ins" suivi d'une configuration.

Environnement : OEM 13cR5 (13.5.0.22), Oracle Database 19c (≥ 19.22), Linux

Référence : Oracle EM Cloud Control Upgrade Guide 24.1

Contexte

OEM 24ai remplace la branche 13c Release 5. L'upgrade est possible directement depuis la version 13.5.0.22 (RU22 minimum). L'installation se déroule en deux phases : déploiement des binaires ("Software Only"), puis configuration.

Prérequis

Prérequis système

Ressource Minimum
RAM 7 Go
vCPU 2
Disque 147 Go

Référence : Oracle EM Deployment Prerequisites

Prérequis OMS

Vérifier que l'OMS est en version 13.5.0.22 :

export ORACLE_HOME=/u01/app/oracle/product/13.5.0/em13c
$ORACLE_HOME/OMSPatcher/omspatcher version
# OMSPatcher Version: 13.9.5.21.0

Prérequis base de données repository

La version de la base doit être au minimum 19.22 :

$ORACLE_HOME/OPatch/opatch lspatches
# 35943157;Database Release Update : 19.22.0.0.240116

Appliquer le paramètre d'initialisation requis :

SYS@EMREP> alter system set "_allow_insert_with_update_check=true";

Supprimer le plugin CSA avant l'upgrade

emcli login -username=sysman
emcli undeploy_plugin_from_agent \
    -plugin="oracle.sysman.csa" \
    -agent_names="em13cr5.lan:3872"

Vérifier que le déploiement est terminé :

emcli get_plugin_deployment_status -plugin=oracle.sysman.csa

Attendre le statut Success avant de continuer.

Procédure

1. Télécharger et extraire les fichiers d'installation

Télécharger les 5 fichiers depuis My Oracle Support (environ 8 Go au total) :

# Vérifier les checksums avant décompression
# V1046951-01.zip : 9C7BA38AD8957CE1E09F2B25D12EDC19851BD31CF35F84E7426011FF3C403B9F
# V1046952-01.zip : A8CE8BFF6F445D8FB319954A584D1E7967564868255CD8835D41223685E38174
# V1046953-01.zip : 63CA438F36C25DE94EEA5A540F7E50AE6879E240E56F59A8B2DDAE7E3427121B
# V1046954-01.zip : 20B173200E04F1EDE08C91B6DDABF567545B58A5EAF3B220E504F2CC6625E5F0
# V1046955-01.zip : D711266FB11A8EBFF77C92A1286AD4DB5F35B3CCE07745DF52F5A68BCA1D2A23

for f in V104695*zip; do unzip $f; done

2. Lancer l'assistant d'installation (Software Only)

Exécuter l'installeur Oracle Universal Installer extrait des archives. Les étapes principales de l'assistant graphique :

  1. Sélectionner "Upgrade an existing Enterprise Manager System"
  2. Choisir "Software Only" (les binaires sont copiés sans configuration immédiate)
  3. Sélectionner les plug-ins à inclure dans l'upgrade
  4. Valider les chemins ORACLE_BASE, ORACLE_HOME (ex. /u01/app/oracle/product/em24/middleware/oms_home)
  5. L'assistant signale des warnings à traiter avant de continuer :
    • L'agent local surveille le service OMS — normal, à ignorer
    • Vérifier que les patches DB obligatoires sont appliqués (répondre OK si c'est le cas)
    • Les JVMD Engines doivent être arrêtés : emctl extended oms jvmd stop -all

Note : Si l'écran "Check Again" ne répond pas après correction d'un warning, revenir à l'écran précédent puis re-valider.

3. Exécuter allroot.sh (en tant que root)

À l'invite de l'installeur, exécuter en tant que root :

/u01/app/oracle/product/em24/middleware/oms_home/allroot.sh

Résultat attendu :

Starting to execute /u01/app/oracle/product/em24/middleware/oms_home/root.sh ...
Finished execution of .../root.sh

Starting to execute /u01/app/oracle/product/em24/agent/agent_24.1.0.0.0/root.sh ...
Finished product-specific root actions.
Finished execution of .../agent_24.1.0.0.0/root.sh

4. Arrêter l'ancien OMS

[oracle@em13cr5 OMS ~]$ ./emctl_oms stop oms -all
# Oracle Management Server Successfully Stopped
# AdminServer Successfully Stopped

5. Configurer OEM 24ai (ConfigureGC.sh)

/u01/app/oracle/product/em24/middleware/oms_home/sysman/install/ConfigureGC.sh

Suivre l'assistant graphique de configuration. À l'issue de la configuration, remettre le paramètre d'enqueue de la base repository à sa valeur initiale si nécessaire.

6. Sécuriser les agents (resecure)

Après la configuration, identifier les autorités de certification actives :

emcli login -username=sysman
emcli get_ca_info -details

Resécuriser les agents encore en ligne :

emcli secure_agents \
    -agt_names="em13cr5.lan:3872" \
    -username=sysman

Note : Les agents arrêtés au moment du resecure seront filtrés automatiquement. Les resécuriser individuellement après leur redémarrage.

Vérification

# Vérifier la version de l'OMS
./emctl status oms -details

# Vérifier l'état des agents
emcli get_agents_status

Notes

Yacine Oumghar · DBA Oracle depuis 1998 Retour au blog