Effectuer un contrôle de préparation avant la mise à niveau

Pour identifier les problèmes potentiels liés à la mise à niveau, Oracle recommande d'exécuter un contrôle de préparation à l'aide de l'Upgrade Assistant avant de commencer le processus de mise à niveau.
Pour exécuter le contrôle de préparation avant la mise à niveau, reportez-vous à la section Exécution d'un contrôle de préparation avant la mise à niveau dans la mise à niveau avec l'Upgrade Assistant.

Lorsque vous exécutez l'Upgrade Assistant en mode préparation, il effectue un contrôle pré-mise à niveau sur les schémas et les configurations des composants associés à un domaine. Une fois terminé, le contrôle de préparation génère un rapport de préparation formaté et horodaté afin que vous puissiez résoudre les problèmes potentiels avant de tenter la mise à niveau réelle.

Oracle recommande de lire attentivement ce rapport avant d'effectuer une mise à niveau.

Si aucun problème n'est détecté, vous pouvez commencer le processus de mise à niveau.

Note: Soyez conscient que le contrôle de préparation peut ne pas être en mesure de découvrir tous les problèmes potentiels liés à votre mise à niveau. Une mise à niveau peut toujours échouer, même si le contrôle de préparation signale une réussite.

Créer des copies des fichiers modèles d'Oracle Forms

Avant de commencer une mise à niveau vers la dernière version 12c, il est recommandé de créer des copies des fichiers modèles Forms existants.

Cela inclut tous les fichiers dans le répertoire suivant :

DOMAIN_HOME\user_projects\domains\base_domain\config\fmwconfig\components\FORMS\instances<NOM_INSTANCE>\server

Si vous effectuez une mise à niveau à partir d'une version 12c antérieure vers la dernière version, les fichiers se trouvent dans le même répertoire que mentionné dans la ligne précédente.

La copie des fichiers modèles vous aidera à restaurer les personnalisations spécifiques à l'utilisateur dans les nouveaux fichiers modèles Forms.

Après avoir terminé le processus de mise à niveau, vous devrez copier ou fusionner manuellement les personnalisations spécifiques à l'utilisateur créées dans la version précédente vers les nouveaux fichiers modèles Forms.

Mise à niveau vers Oracle Forms 12.2.1.19.0

Mettez à niveau vers Oracle Forms 12.2.1.19.0 en installant le logiciel soit dans le même répertoire Oracle Home, soit dans un nouveau répertoire Oracle Home que vous créez. Après la mise à niveau, complétez les étapes de configuration applicables.

Si vous prévoyez d'utiliser le répertoire Oracle Home existant, suivez les procédures pour une mise à niveau "in-place". Dans ce cas, vous sauvegarderez le répertoire existant, installerez le logiciel dans le répertoire existant, puis copierez tous les fichiers requis depuis le répertoire de sauvegarde. Voir Effectuer une mise à niveau in-place plus bas.

Cette mise à niveau est particulièrement utile pour les environnements multi-nœuds, car vous pouvez arrêter et mettre à niveau un nœud à la fois, assurant un temps d'arrêt minimal voire nul.

Si vous prévoyez de créer un nouveau répertoire pour cette installation, suivez plutôt les procédures "out-of-place". Cela implique d'installer le logiciel comme pour une nouvelle installation, puis d'utiliser l'assistant de reconfiguration WLS et l'assistant de mise à niveau pour compléter la mise à niveau. Voir Effectuer une mise à niveau out-of-place plus bas.

Quel que soit le chemin de mise à niveau que vous choisissez, si le domaine WLS existant était précédemment configuré pour utiliser les Services de Déploiement d'Applications Forms (FADS), vous devez mettre à niveau la version d'Oracle SQL Developer trouvée dans le répertoire Oracle Home vers la version 21.4.3.

Téléchargez cette version d'Oracle SQL Developer depuis la page de téléchargements d'Oracle SQL Developer 21.4.3. Dans le tableau, utilisez le lien pour "Other Platforms".

AVERTISSEMENT : Ne mettez pas à niveau Oracle SQL Developer vers une version plus récente que 21.4.3.

Pour obtenir le logiciel Oracle Fusion Middleware Infrastructure et Oracle Forms and Reports, reportez-vous à la section Obtenir le logiciel Oracle Fusion Middleware.

Une fois l'installation de la version 12.2.1.19 terminée, vous devrez effectuer certaines tâches supplémentaires pour compléter la mise à niveau. Voir Compléter la mise à niveau plus bas.

Cette section inclut les sujets suivants :

• Effectuer une mise à niveau in-place
• Effectuer une mise à niveau out-of-place
• Compléter la mise à niveau

Effectuer une mise à niveau in-place

Pour effectuer une mise à niveau "in-place", vous devez sauvegarder le répertoire Oracle Home existant, installer les dernières versions des logiciels requis dans le répertoire existant, puis copier tous les fichiers nécessaires à partir du répertoire de sauvegarde.

Dans une mise à niveau in-place, vous installez le logiciel 12.2.1.19.0 dans le même chemin Oracle Home que celui utilisé précédemment par 12.2.1.4.0 ou 12.2.1.3.0. Cette mise à niveau est recommandée pour un déploiement Forms avec équilibrage de charge sur plusieurs nœuds.

Cette procédure utilise un environnement à deux nœuds comme exemple : un nœud principal, nommé "node1", avec Admin Server, Forms (serveur géré WLS_FORMS et composant système forms1) et Oracle HTTP Server (OHS) ; et un nœud secondaire, nommé "node2", avec Forms Instance (serveur géré WLS_FORMS et composant système forms1).

Pour les configurations à nœud unique, complétez les étapes 1 à 8. Pour chaque nœud supplémentaire, complétez les étapes 9 à 12.

Pour effectuer une mise à niveau in-place :

1. Arrêtez tous les composants système comme OHS (si utilisé), les serveurs gérés, le serveur Admin, puis le gestionnaire de nœuds sur le nœud 1.
2. Renommez le répertoire parent Oracle Home sur le nœud 1. Par exemple, vous pouvez le renommer en Oracle_Home_Old.
3. Installez Fusion Middleware Infrastructure 12.2.1.4.0 sur le nœud 1 en utilisant le même chemin Oracle Home que celui utilisé précédemment (avant de le renommer à l'étape 2).
4. Installez Oracle Forms 12.2.1.19.0 sur le nœud 1 en utilisant le même chemin Oracle Home.
5. Si le répertoire WLS Domains (user_projects) et ses sous-répertoires se trouvent dans l'ancien Oracle Home, copiez ces répertoires dans le nouveau Oracle Home au même emplacement qu'auparavant.
6. Si vous installez sur Unix/Linux, exécutez les commandes suivantes dans un shell en tant qu'utilisateur propriétaire de cette nouvelle installation :
   1. Définissez la variable d'environnement ORACLE_HOME et pointez-la vers le Forms home, par exemple :

      export ORACLE_HOME=

   2. Exécutez les commandes suivantes :

      cd $ORACLE_HOME/procbuilder/lib
      make -f ins_procbuilder.mk sharedlibs dejvm_install
      cd $ORACLE_HOME/forms/lib
      make -f ins_forms.mk sharedlib
      frmopmn_wrp_install
      frmctrl_install frmweb_install
      frmcmpb_install frmcmp_install
      frmbld_install
      

7. Si nécessaire, mettez à niveau Oracle SQL Developer vers la version 21.4.3. Vous devez passer à la version 21.4.3 si le domaine WLS existant était précédemment configuré pour utiliser les Services de Déploiement d'Applications Forms (FADS). Une version plus ancienne de SQL Developer est installée avec la dernière version de Forms.

   
   AVERTISSEMENT: Ne mettez pas à niveau Oracle SQL Developer vers une version plus récente que 21.4.3.

   1. Téléchargez Oracle SQL Developer 21.4.3 depuis la page de téléchargements SQL Developer 21.4.3 en utilisant le lien Other Platforms dans le tableau. Le fichier de téléchargement est un fichier zip, par exemple : sqldeveloper-21.4.3.063.0100-no-jre.zip.

   2. Renommez le répertoire sqldeveloper situé dans le répertoire $ORACLE_HOME. Par exemple, renommez-le en sqldeveloper_old.

   3. Extrayez le contenu du fichier zip Oracle SQL Developer 21.4.3 dans le répertoire Oracle Home. Cela crée un nouveau répertoire sqldeveloper au niveau supérieur dans Oracle Home.

8. Démarrez le gestionnaire de nœuds, le serveur Admin, les serveurs gérés et tous les autres composants système (comme OHS) sur le nœud 1.

   Cela termine la mise à niveau du nœud 1. Pour les nœuds supplémentaires, effectuez les étapes suivantes.

9. Arrêtez les composants système et les serveurs gérés sur le nœud 2.

10. Répétez les étapes 2 à 8 pour installer Oracle Forms sur le nœud 2.

11. Démarrez les composants système et les serveurs gérés sur le nœud 2.

12. Après avoir terminé l'installation et démarré correctement les serveurs, supprimez les répertoires Oracle_Home_Old des nœuds 1 et 2. Avant de supprimer, assurez-vous de copier tous les fichiers personnalisés nécessaires à partir du répertoire Oracle_Home_Old.

Une fois que vous avez terminé ces étapes, passez à la section Compléter la mise à niveau ci-dessous.

Effectuer une mise à niveau out-of-place

Pour effectuer une mise à niveau "out-of-place", vous devez installer le logiciel comme pour une nouvelle installation, puis utiliser l'assistant de reconfiguration WLS et l'assistant de mise à niveau pour terminer la mise à niveau.

Dans une mise à niveau out-of-place, vous installez le logiciel 12.2.1.19.0 dans un nouveau répertoire Oracle Home plutôt que celui utilisé par l'installation 12.2.1.4.0 ou 12.2.1.3.0.

• Installer le logiciel dans un nouveau répertoire Oracle Home
• Reconfigurer le domaine en utilisant l'assistant de reconfiguration WLS
• Exécuter l'assistant de mise à niveau pour mettre à niveau la configuration des composants
• Démarrer Oracle Forms après une mise à niveau

Installer le logiciel dans un nouveau répertoire Oracle Home

Installez Oracle Fusion Middleware Infrastructure 12.2.1.4 et Forms 12.2.1.19 dans un nouveau répertoire Oracle Home.

Après avoir installé le logiciel, ignorez les étapes supplémentaires et revenez ici pour mettre à jour votre domaine WLS existant. Ne créez pas de nouveaux schémas de référentiel et ne lancez pas l'assistant de configuration.

Référez-vous au chapitre Installer et configurer Oracle Forms en commençant par l'installation d'Oracle Forms dans un nouveau répertoire Oracle Home pour les étapes d'installation du logiciel.

Reconfigurer le domaine en utilisant l'assistant de reconfiguration WLS

Vous devez reconfigurer le domaine en utilisant l'assistant de reconfiguration WLS.

Pour reconfigurer le domaine :

1. Exécutez l'assistant de reconfiguration WLS à partir de l'emplacement suivant dans le nouveau Oracle Home :

   $ORACLE_HOME/oracle_common/common/bin/reconfig.sh

2. Indiquez l'emplacement du domaine FMW 12.2.1.4.0 ou 12.2.1.3.0 à mettre à niveau.
3. Entrez les informations du schéma RCU.
4. Sélectionnez les options Administration Server et Topology dans l'écran de configuration avancée. Ne sélectionnez pas l'option System Components. Ceux-ci seront automatiquement configurés/mis à niveau par l'assistant de mise à niveau.
5. Écran des paramètres du serveur d'administration : si l'environnement précédent était configuré pour utiliser les Services de déploiement d'applications Forms (FADS), assurez-vous que WSMPM-MAN-SVR est sélectionné dans la liste déroulante des groupes de serveurs.
   Remarque : Ne le sélectionnez pas si FADS n'était pas configuré précédemment.
6. Laissez les sélections par défaut sur l'écran du gestionnaire de nœuds. Entrez le nom d'utilisateur et le mot de passe si nécessaire.
7. Cliquez sur Suivant jusqu'à ce que vous atteigniez le dernier écran de l'assistant.

Exécuter l'assistant de mise à niveau pour mettre à niveau la configuration des composants

Pour mettre à niveau la configuration des composants, complétez une série d'étapes en utilisant l'assistant de mise à niveau 12.2.1.19.0.

Pour mettre à niveau la configuration des composants :

1. Exécutez l'assistant de mise à niveau 12.2.1.19.0 à partir de l'emplacement suivant :

   $ORACLE_HOME/oracle_common/upgrade/bin/ua

2. Sélectionnez l'option All Configuration Used by the Domain.
3. Indiquez l'emplacement du domaine 12c reconfiguré.
4. Cochez les cases de prérequis.
5. Cliquez sur Upgrade.

Démarrer Oracle Forms après une mise à niveau

Après avoir installé Oracle Fusion Middleware Infrastructure et le logiciel Oracle Forms, et avoir exécuté à la fois l'assistant de reconfiguration WLS et l'assistant de mise à niveau, vous devrez démarrer Oracle Forms.

Si le domaine WLS existant était précédemment configuré pour utiliser les Services de déploiement d'applications Forms (FADS), vous devrez mettre à niveau Oracle SQL Developer vers la version 21.4.3 avant de démarrer les serveurs. Une version plus ancienne de SQL Developer est installée avec la dernière version de Forms.

1. Si nécessaire, mettez à niveau Oracle SQL Developer vers la version 21.4.3.
   AVERTISSEMENT : Ne mettez pas à niveau Oracle SQL Developer vers une version plus récente que 21.4.3.
   1. Téléchargez Oracle SQL Developer 21.4.3 depuis la page de téléchargements SQL Developer 21.4.3 en utilisant le lien Other Platforms dans le tableau. Le fichier de téléchargement est un fichier zip, par exemple : sqldeveloper-21.4.3.063.0100-no-jre.zip.
2. Renommez le répertoire sqldeveloper situé dans le répertoire $ORACLE_HOME. Par exemple, renommez-le en sqldeveloper_old.
3. Extrayez le contenu du fichier zip Oracle SQL Developer 21.4.3 dans le répertoire Oracle Home. Cela crée un nouveau répertoire sqldeveloper au niveau supérieur dans Oracle Home.
4. Démarrez le gestionnaire de nœuds, le serveur Admin, les serveurs gérés et tous les autres composants système (comme Oracle HTTP Server).

Une fois que vous avez terminé ces étapes, passez à la section Compléter la mise à niveau.

Compléter la mise à niveau

Après avoir mis à niveau Oracle Forms vers la version 12.2.1.19.0, vous devrez peut-être effectuer les étapes supplémentaires suivantes, en fonction de votre configuration.

Configuration des Services d'application Forms (FADS)

Si les Services d'application Forms (FADS) étaient configurés dans le domaine 12.2.1.4.0 ou 12.2.1.3.0, vous devrez exécuter le script de configuration FADS (fads_config.py) avec l'option de mise à niveau :

1. Exécutez la commande suivante :

   ORACLE_HOME/oracle_common/common/bin/wlst.sh fads_config.py upgrade

2. Complétez les invites.

Chiffrement de l'identifiant utilisateur

Si vous effectuez une mise à niveau depuis la version 12.2.1.3.0, activez le chiffrement pour le paramètre userid et accordez l'accès au keystore de l'application Forms.

Remarque: Ces étapes ne sont pas nécessaires si vous effectuez une mise à niveau depuis la version 12.2.1.4.0.

Pour activer le chiffrement pour le paramètre userid :

1. (Mise à niveau "Out-of-place" uniquement) Définissez le paramètre forms.userid.encryption.enabledsur true pour le serveur d'administration et les serveurs gérés Forms. Reportez-vous à la section Personnalisation des paramètres de serveur à l'échelle du domaine dans l'Administration du démarrage et de l'arrêt des serveurs pour Oracle WebLogic Server. Voici un exemple de fichier setUserOverridesLate.sh (utilisez setUserOverridesLate.cmd pour Windows), où le paramètre forms.userid.encryption.enabled est activé.

   echo ""
   echo "*****************************************************"
   echo "** Executing setUserOverridesLate.sh"
   echo "*****************************************************"
   
   # specify additional java command line options for all servers
   
   EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES} -Dforms.userid.encryption.enabled=true"
   export EXTRA_JAVA_PROPERTIES
   
   echo "USER_MEM_ARGS=\"${USER_MEM_ARGS}\""
   echo "EXTRA_JAVA_PROPERTIES=\"${EXTRA_JAVA_PROPERTIES}\""
   echo ""
   echo "*****************************************************"
   echo "** End of setUserOverrideLate.sh"
   echo "*****************************************************"
   echo ""
   

2. Exécutez les commandes suivantes en utilisant WLST (mode en ligne) pour accorder des autorisations à l'application Forms ou aux mbeans pour accéder au keystore de l'application Forms.

   grantPermission(codeBaseURL="file:${common.components.home}/../forms/provision/forms-config-mbeans.jar",
   permClass="oracle.security.jps.service.keystore.KeyStoreAccessPermission",permTarget="stripeName=formsapp,
   keystoreName=formsks,alias=*", permActions="*")
   
   grantPermission(codeBaseURL="file:${domain.home}/servers/${weblogic.Name}/tmp/_WL_user/formsapp_12.2.1/-",
   permClass="oracle.security.jps.service.keystore.KeyStoreAccessPermission", permTarget="stripeName=formsapp,
   keystoreName=formsks,alias=*",permActions="*")

3. Redémarrez le gestionnaire de nœuds, le serveur d'administration et les serveurs gérés Forms.

Étapes post-mise à niveau après la mise à niveau d'Oracle Forms

Après avoir utilisé l'Upgrade Assistant pour mettre à niveau Oracle Forms, vous devrez effectuer plusieurs tâches post-mise à niveau.

Complétez ces tâches :

• Régénérez les fichiers d'application Forms (fmx, mmx et plx) pour qu'ils fonctionnent avec Oracle Forms Services 12.2.1.19.0.
• Si vous avez déployé le fichier d'application J2EE personnalisé Oracle Forms Services (formsapp.ear) pour remplacer le contexte racine ou l'alias de servlet Forms, vous devrez effectuer des étapes similaires dans le domaine Oracle WebLogic Server 12.2.1.19.0. Voir Custom Déploiement personnalisé de l'application Java EE Forms. Pour plus d'informations, consultez le Oracle Forms Configuration Helper Script dans le guide Travailler avec Oracle Forms.
• Copiez manuellement toutes les personnalisations apportées aux scripts shell fournis dans le nouvel environnement si nécessaire.
• Assurez-vous de copier tous les fichiers personnalisés stockés dans l'ancien Oracle Home dans les répertoires correspondants de la nouvelle installation.
  Note: Il peut être nécessaire d'arrêter les serveurs avant de copier les anciens fichiers dans les nouveaux répertoires afin que les nouveaux serveurs prennent conscience de leur existence.