Vos systèmes Oracle. MODERNISÉS.

Gestion de bases de données

Appliquer Oracle Enterprise Manager Fusion Middleware Control et JRF à un domaine WebLogic

Patrick Hamou 7 min de lecture

Introduction

Un domaine WebLogic Fusion Middleware créé avec l'assistant de configuration standard de WebLogic (Configuration Wizard) n'inclut ni Fusion Middleware Control ni les Java Required Files (JRF).

Sachez en outre que même si le modèle JRF a été appliqué à un domaine WebLogic, il peut encore manquer le déploiement JRF sur les serveurs gérés de ce domaine. Par exemple, les cas suivants n'entraînent pas l'application automatique de JRF :

  • Les nouveaux serveurs gérés et/ou clusters créés avec la console d'administration WebLogic (les serveurs gérés et clusters créés avec Fusion Middleware (EM) Control auront JRF déployé).
  • Les serveurs gérés ou clusters créés avec l'Oracle Common Configuration Wizard

Pour plus de détails, consultez :
Oracle Fusion Middleware Administrator's Guide 11g Release 1 (11.1.1)
19 Scaling Your Environment
19.3.1 Applying Oracle JRF Template to a Managed Server or Cluster

Appliquer les modèles JRF et EM (FMW Control) à un domaine WebLogic

Le répertoire Oracle Common

JRF et Enterprise Manager s'appliquent à un domaine WebLogic au moyen du Configuration Wizard. Celui-ci est lancé de façon autonome ou, pour certains produits, par le programme d'installation (lorsque l'option "Install and Configure" est proposée). Il existe deux types de Configuration Wizard :

  • Le Configuration Wizard standard de WebLogic, lancé depuis MW_HOME\wlserver_10.3\common\bin
  • L'Oracle Fusion Middleware 11g Configuration Wizard, qui peut être lancé depuis :
    • l'ORACLE_HOME d'un produit Fusion Middleware (MW_HOME\ORACLE_HOME\common\bin)
    • le répertoire "oracle_common" (MW_HOME\oracle_common\common\bin)

Oracle JRF et/ou Enterprise Manager s'appliquent à un domaine WebLogic au moyen de l'Oracle Fusion Middleware 11g Configuration Wizard. Celui-ci propose d'appliquer les modèles JRF et Enterprise Manager lorsque vous

1. Créez un nouveau domaine

OU

2. Étendez un domaine existant

Les produits Oracle Fusion Middleware, comme SOA, WebCenter, IDM et Portal/Forms/Reports/Discoverer, appliquent JRF par défaut lors de la création du domaine.

Les modèles des composants Oracle Enterprise Manager et JRF sont fournis dans le répertoire "MW_HOME/oracle_common". Toutefois, ce répertoire et son contenu ne sont pas mis en place par l'installation d'Oracle Weblogic Server. Le répertoire "oracle_common" ne peut être créé qu'en installant l'un des autres types de supports Oracle Middleware 11g, par exemple :

  • SOA Suite
  • WebCenter
  • Portal/Forms/Reports/Discoverer
  • Identity Management
  • etc.

Si vous ne souhaitez pas ou n'avez pas besoin d'installer les binaires de ces types d'installation, vous pouvez créer le répertoire "oracle_common" et son contenu au moyen du programme d'installation d'Oracle Middleware 11g "Application Developer", aussi appelé Oracle Application Development Framework ( ADF ). L'ORACLE_HOME créé par une installation d'ADF est "MW_HOME/oracle_common"

Référence documentaire :
Oracle Fusion Middleware Installation Guide for Application Developer 11g Release 1 (11.1.1)

Télécharger le logiciel

Téléchargez l'un des types d'installation d'Oracle Fusion Middleware 11g Release 1 qui fournissent "oracle_common".

a) Allez à la page Web

Download, Installation, and Configuration Readme Files

b) Choisissez le readme 11g Release 1 (11.1.1.x) qui correspond à la version d'Oracle WebLogic Server du Middleware Home.

  • 10.3.5 ou 10.3.6 => 11..1.1.6
  • 10.3.4 => 11.1.1.4

c) Repérez les liens de téléchargement dans la section intitulée "Downloading Oracle Fusion Middleware Products for a New Installation"

Astuce :

Si vous voulez seulement installer et configurer Enterprise Manager Fusion Middleware Control, téléchargez "Oracle Application Developer", aussi appelé Oracle Application Development Framework ( ADF ). Consultez la référence du guide d'installation dans la section "Le répertoire Oracle Common" ci-dessus.

Référence utile :
Note 1541370.1 Enterprise Manager Fusion Middleware Control 11g (fmwc) - Basic ADF Installation To Include FMWC Application

Installer "Oracle Common"

Lancez le programme d'installation d'Oracle Fusion Middleware 11g du support choisi, par ex.

Unix: /Disk1/runInstaller
MS Windows: \Disk1\setup.exe


Choisissez "Install Software Only" (ne pas configurer). Cela crée l'ORACLE_HOME du produit et le répertoire Oracle Common.

Remarque :

Oracle Application Development Framework ( ADF ) ne met en place que le répertoire oracle_common. Le répertoire oracle_common est l'ORACLE_HOME d'ADF.

Exécuter le Configuration Wizard

Une fois que le répertoire "oracle_common" existe sous le Middleware Home, vous pouvez exécuter l'assistant de configuration depuis ce répertoire et effectuer l'une des opérations suivantes :

  • Créer un nouveau domaine Weblogic qui inclut Enterprise Manager et Oracle JRF

OU

  • Étendre un domaine WebLogic existant en lui appliquant les modèles Enterprise Manager et Oracle JRF

En résumé :

1. Exécutez l'Oracle Fusion Middleware 11g Configuration Wizard depuis MW_HOME/oracle_common/common/bin, par ex.

Unix: MW_HOME/oracle_common/common/bin/config.sh
MS Windows: MW_HOME\oracle_common\common/bin/config.cmd

2. Si vous n'avez pas encore créé de domaine WebLogic, choisissez "Create a New Domain". Si vous avez déjà créé un domaine WebLogic avec l'assistant de configuration standard de WebLogic, choisissez "Extend an Existing Domain"

3. Le Configuration Wizard vous propose ensuite des options sur le contenu du domaine; voir par exemple les captures d'écran ci-dessous.

Figure 1 : création d'un nouveau domaine WebLogic (prise depuis un MW_HOME contenant uniquement WebLogic Server et Application Developer)
Capture d’écran de l’assistant de configuration, Select Domain Source : seuls Oracle Enterprise Manager et Oracle JRF sont cochés

Figure 2 : extension d'un domaine WebLogic existant (prise depuis un MW_HOME contenant les Oracle Homes WebLogic Server, SOA, IDM, Web Tier et PFRD)

Capture d’écran de l’assistant de configuration, Select Extension Source : étendre le domaine avec Enterprise Manager et JRF seulement

Sélectionnez UNIQUEMENT ces options

  • Oracle Enterprise Manager - 11.1.1.0 [oracle common]
  • Oracle JRF - 11.1.1.0 [oracle common]

4. Parcourez les écrans de configuration et créez ou étendez le domaine.

5. Ouvrez le fichier de configuration du NodeManager : MW_HOME/wlserver_10.3/common/nodemanager/nodemanager.properties

Le fichier doit contenir le paramètre StartScriptEnabled=true. Si StartScriptEnabled n'est pas activé ("Yes"), des applications et fonctionnalités Java risquent de ne pas fonctionner.

Référence :
Oracle Fusion Middleware Administrator's Guide 11g Release 1 (11.1.1)
Chapter 4 Starting and Stopping Oracle Fusion Middleware
Configuring Node Manager to Start Managed Servers

Remarque :

Si vous ne sélectionnez que JRF et Enterprise Manager dans le Configuration Wizard, il n'est pas nécessaire d'exécuter le Repository Creation Utility (RCU) sur une base de données Oracle pour créer les schémas des produits Middleware.

6. Le démarrage des serveurs du domaine après sa création ou son extension initialise et déploie les composants Enterprise Manager et/ou JRF choisis. L'application Enterprise Manager n'est déployée que sur l'Admin Server du domaine. JRF est aussi déployé sur l'Admin Server du domaine mais, selon la démarche suivie, il peut être nécessaire d'appliquer JRF aux serveurs gérés. Voir la section suivante pour plus d'informations.

Appliquer JRF aux serveurs gérés nouveaux ou existants

Une fois qu'un domaine WebLogic a été créé ou étendu pour inclure JRF, JRF est automatiquement appliqué et déployé sur l'Admin Server. Pour vous assurer que JRF est appliqué aux serveurs gérés nouveaux ou existants, consultez les recommandations de

Oracle Fusion Middleware Administrator's Guide 11g Release 1 (11.1.1)
19 Scaling Your Environment
19.3.1 Applying Oracle JRF Template to a Managed Server or Cluster

Astuces :

A) Pour vérifier si JRF a été appliqué

Consultez le fichier DOMAIN_HOME/config/config.xml
Recherchez ces lignes :


    DMS Application#11.1.1.1.0
    AdminServer,MyManagedServer
    war
    D:/product/FMW11g/oracle_common/modules/oracle.dms_11.1.1/dms.war
    5
    CustomRoles
    nostage


    wsil-wls
    AdminServer,MyManagedServer
    ear
    D:/product/FMW11g/oracle_common/modules/oracle.webservices_11.1.1/wsil-wls.ear
    5
    DDOnly
    nostage
  
 ....

Si les applications DMS Application et WSIL-WLS ne sont pas déployées, JRF n'a pas été appliqué à ce serveur géré.

Vérifiez les déploiements d'applications dans Oracle Fusion Middleware (EM) Control. Si les applications DMS Application et WSIL-WLS ne sont pas déployées, JRF n'a pas été appliqué à ce serveur géré.

Figure 3 : Fusion Middleware (EM) Control - JRF est-il appliqué?
Capture d’écran d’EM Fusion Middleware Control : DMS Application et wsil-wls déployés sur MyManagedServer, donc JRF est appliqué

B) Si le modèle Enterprise Manager a été appliqué au domaine WebLogic, vous pouvez utiliser Oracle Fusion Middleware (EM) Control pour

Appliquer le modèle JRF à un serveur géré existant

Figure 4 : Fusion Middleware (EM) Control - application de JRF

Capture d’écran d’EM Fusion Middleware Control signalant que JRF n’est pas appliqué à MyManagedServer, avec Apply JRF Template

Créer un nouveau serveur géré ou cluster, auquel JRF sera appliqué par défaut

Figure 5 : Fusion Middleware (EM) Control - création d'un nouveau serveur géré

Capture d’écran d’EM Fusion Middleware Control : menu Farm > Create/Delete Components pour créer un serveur géré

Si Oracle Fusion Middleware (EM) Control n'est pas accessible, vous pouvez quand même appliquer JRF à un serveur géré avec WLST. Pour plus de détails, consultez

Note:1313166.1 How to Create a JRF Enabled WLS 10.3.X Domain using WLST and get it Ready for Oracle Fusion Middleware 11g Configurations

Corriger / "mettre à niveau" JRF

La "mise à niveau" de JRF (upgrade) est une étape documentée à effectuer après l'application d'un patch set. Consultez :

Oracle Fusion Middleware Patching Guide 11g Release 1
3 Applying the Latest Oracle Fusion Middleware Patch Set
3.9.6 Post-Patching Tasks for Your WebLogic Server Domain

Astuces :

  • 1.Les fichiers du modèle JRF dans oracle_common doivent être mis à jour à la dernière version avant que la commande WLST "upgradeJRF" puisse fonctionner. Ils sont mis à jour lorsque l'Oracle Fusion Middleware Patch Set Installer est exécuté sur l'Oracle Home d'un produit (p. ex. SOA, Web Tier, WebCenter, IDM, etc.). Si le patch set n'est pas appliqué à l'ORACLE_HOME avant "upgradeJRF", vous rencontrerez le problème décrit dans l'article cité ci-dessous. Note 1502030.1 FMW 11g - Running WLST upgradeJRF Fails - Traceback (innermost last): File "<console>", line 1, in ? NameError: upgradeJRF
  • 2. Oracle JRF comprend les applications et le code qui activent le Fusion Middleware Diagnostic Framework et son référentiel (ADR). L'Oracle WebLogic Server 10.3.6 Upgrade Installer combiné à l'Oracle Fusion Middleware Patch Set (11.1.1.6 ou supérieur) fait passer la version d'ADR à 11.2.0.2. Cette version d'ADR permet d'inclure la sortie du Remote Diagnostic Agent (RDA) dans un package d'incident.

Mise à niveau d'AS 10.1.3 J2EE vers WebLogic Server

Si vous mettez à niveau OracleAS 10g J2EE (sans SOA ni WebCenter) vers WebLogic Server, il peut être souhaitable d'inclure JRF et Enterprise Manager dans votre solution 11g. Consultez les recommandations de

Oracle Fusion Middleware Upgrade Guide for Java EE 11g Release 1 (11.1.1)

Ces chapitres sont particulièrement utiles pour comprendre les étapes d'installation et de mise à niveau de la pile technologique de base.

Tous les articles