Etapes manuelles de la configuration du basculement Essbase sur le noeud principal (hôte 1)

A savoir : Pour la version 21.5.2 ou supérieure, ignorez ces instructions et utilisez plutôt les instructions de la section Set up an Essbase Failover Environment Using the Failover Setup Script.

Configurez le noeud Essbase principal pour le basculement. Vous allez exécuter l'assistant de configuration Fusion Middleware, modifier les fichiers de script, ajouter des propriétés de configuration Essbase, configurer des serveurs dans la console WebLogic, exécuter l'utilitaire des outils TLS, packager la configuration de domaine et la copier sur le second noeud.

Avant de commencer, reportez-vous à Configuration de TLS pour le basculement Essbase pour savoir comment configurer le fichier de propriétés TLS.

L'hôte 1 est le noeud Essbase principal et tous les services ne sont pas clusterisés (comme AdminServer).

SSH vers l'hôte 1 et arrêt de l'instance Essbase :

Sous Linux :
```
<Domain Home>/esstools/bin/stop.sh
```
Sur Windows, procédez comme suit :
```
<Domain Home>\esstools\bin\stop.cmd
```
Lancez l'assistant de configuration Fusion Middleware et mettez à jour la configuration sur l'hôte 1 :

Sous Linux :
```
<Oracle Home>/oracle_common/common/bin/config.sh
```
Sur Windows, procédez comme suit :
```
<Oracle Home>\oracle_common\common\bin\config.cmd
```
1. Sur l'écran Créer un domaine, sélectionnez Mettre à jour un domaine existant. Assurez-vous que l'emplacement de domaine approprié est spécifié dans le champ Emplacement de domaine, puis cliquez sur Suivant.
2. Dans l'écran Templates, acceptez les valeurs par défaut et cliquez sur Next.
3. Dans l'écran Type de configuration de base de données, remplacez la sélection Données RCU par Configuration manuelle et cliquez sur Suivant.
4. Dans l'écran Origines de données de composant, acceptez les valeurs par défaut et cliquez sur Suivant.
5. Dans l'écran JDBC Test, acceptez les valeurs par défaut et cliquez sur Next.
6. Dans l'écran Configuration avancée, sélectionnez Topologie et cliquez sur Suivant.
7. Sur l'écran Serveurs gérés, cliquez sur Ajouter et entrez les détails de l'hôte 2.
  - Entrez les ports du serveur géré pour essbase_server2.
  - Cochez la case Activer SSL si vous devez mettre à jour le port d'écoute SSL.
  - Pour mettre à jour le port d'écoute SSL, cliquez sur la zone d'entrée Port d'écoute. Sélectionnez les groupes de serveurs en tant que ESSBASE-MAN-SVR et cliquez sur Next.
8. Acceptez les valeurs par défaut et cliquez sur Suivant dans les écrans suivants :
  - Clusters
  - Modèles de serveur
  - Serveurs dynamiques
  - Affecter des serveurs aux clusters
  - Applications de proxy HTTP
  - Clusters Coherence
9. Dans l'écran Machines, cliquez sur Ajouter et ajoutez un nouvel ordinateur, m2. Entrez le nom d'hôte de l'hôte 2 et les valeurs de port du gestionnaire de noeuds. Vous pouvez choisir le port du gestionnaire de noeuds, 9556. Cliquez sur Suivant.
10. Dans l'écran Assign Servers to Machines, sélectionnez m2 dans le panneau de droite. Sélectionnez le nouveau serveur, essbase_server2 dans le panneau de gauche et ajoutez-le à m2. Après l'avoir ajouté, essbase_server2 s'affiche sous m2. Cliquez sur Suivant.
11. Acceptez les valeurs par défaut et cliquez sur Suivant dans les écrans suivants :
  - Cibles virtuelles
  - Partitions
12. Sur l'écran Récapitulatif de la configuration, cliquez sur Mettre à jour.
13. Une fois la mise à jour terminée, cliquez sur Suivant et, dans le dernier écran, cliquez sur Terminer pour terminer les modifications de configuration.
Sur l'hôte 1, modifiez le fichier <Domain Home>/bin/setDomainEnv.sh (sous Linux) ou <Domain Home>\bin\setDomainEnv.cmd (sous Windows).
Attention :

La plate-forme Essbase inclut des scripts dans <DOMAIN HOME>/bin qui peuvent personnaliser l'environnement et les comportements de la fonctionnalité Essbase. Toutefois, toute modification apportée à ces scripts de démarrage ou d'environnement de domaine peut avoir des effets indésirables, comme l'échec du démarrage. Oracle recommande d'effectuer d'abord les modifications dans un environnement de test. Avant de modifier ces scripts, effectuez toujours les opérations suivantes :
1. Arrêtez les serveurs gérés Essbase à l'aide de <DOMAIN HOME>/esstools/bin/stop.sh (sous Linux) ou <DOMAIN HOME>\esstools\bin\stop.cmd (sous Windows).
2. Dans <DOMAIN HOME>/bin, effectuez une copie de sauvegarde du fichier à modifier. Exemple :
  
  Sous Linux
```
cp setStartupEnv.sh setStartupEnv_bak.sh
```
  Sous Windows
```
copy setStartupEnv.cmd setStartupEnv_bak.cmd
```
3. Effectuez les modifications prudemment : suivez uniquement les instructions de la documentation Oracle ou du support technique Oracle.
4. Redémarrez Essbase en utilisant <DOMAIN HOME>/esstools/bin/start.sh (sous Linux) ou <DOMAIN HOME>\esstools\bin\start.cmd (sous Windows). Assurez-vous que le démarrage s'effectue normalement.
1. Recherchez la chaîne EXTRA_JAVA_PROPERTIES.
  
  Important : recherchez EXTRA_JAVA_PROPERTIES, et non JAVA_PROPERTIES.
2. Ajoutez la définition -D suivante après la ligne EXTRA_JAVA_PROPERTIES d'export existante :
  
  Sous Linux :
```
EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES}-Dweblogic.security.SSL.ignoreHostnameVerification=true" export EXTRA_JAVA_PROPERTIES
```
  Sur Windows, procédez comme suit :
```
set EXTRA_JAVA_PROPERTIES=-Dweblogic.security.SSL.ignoreHostnameVerification=true %EXTRA_JAVA_PROPERTIES%
```
  Remarques :
  Cette étape n'est pas requise si tous les certificats TLS sont importés correctement. En cas de certificats auto-signés ou si le serveur géré ne démarre pas par la suite avec des erreurs SSL, cette étape est requise.
Modifiez le fichier <Domain Home>/config/fmwconfig/essconfig/essbase/essbase.cfg et ajoutez les lignes suivantes :

FAILOVERMODE vrai

#Facultatif

DURÉE DE RENOUVELLEMENT DE L'AGENT 10

#Facultatif

AGENTLEASEEXPIRATIONTIME 20

Démarrez AdminServer dans l'hôte 1.

Sous Linux :

<Domain Home>/esstools/bin/start.sh -i AdminServer

Sur Windows, procédez comme suit :

<Domain Home>\esstools\bin\start.cmd -i AdminServer

Recherchez l'adresse IP publique des machines hôte 1 et hôte 2, par exemple, à l'aide de la commande ping de l'autre hôte. Si les deux machines sont derrière le pare-feu, assurez-vous de connaître les adresses IP avec lesquelles l'hôte 1 et l'hôte 2 peuvent communiquer.
Configurez le serveur AdminServer et les serveurs gérés à l'aide de la console WebLogic :
1. Connectez-vous à la console AdminServer WebLogic à l'aide des informations d'identification d'administrateur WebLogic. Le port AdminServer par défaut est le port 7001.
  
  Exemple : http(s)://host:7001/console
2. Cliquez sur Verrouiller & modifier dans le panneau de gauche. Accédez à <Nom de domaine> -> Environnement -> Serveurs -> AdminServer. Dans l'onglet Configuration, cliquez sur Général et développez la section Avancé. Entrez l'adresse IP publique de l'hôte 1 dans la propriété External Listen Address.
  
  Important : entrez l'adresse IP de l'hôte 1 telle qu'elle est visible par l'hôte 2.
3. Cliquez sur Enregistrer.
4. Répétez les étapes a, b et c ci-dessus pour mettre à jour l'adresse d'écoute externe pour essbase_server1 avec l'adresse IP publique de l'hôte 1.
5. Supprimez essbase_cluster de l'appartenance au cluster Coherence par défaut.
  1. Accédez à <Nom de domaine> -> Environnement -> Clusters Coherence.
  2. Cliquez sur defaultCoherenceCluster. Cliquez sur l'onglet Membres. Désélectionnez essbase_cluster.
  3. Cliquez sur Enregistrer.
6. Accédez à <Nom de domaine> -> onglet Sécurité->onglet Modèle imbriqué. Sélectionnez l'option principale et cliquez sur Enregistrer.
7. Accédez à <Nom de domaine> -> Environnement -> Serveurs. Cliquez sur le nouveau serveur essbase_server2.
8. Dans l'onglet Configuration, accédez à l'onglet Général, développez la section Avancé, puis entrez l'adresse IP publique de l'hôte 2 dans le champ Adresse d'écoute externe. Assurez-vous d'obtenir cette adresse IP publique en envoyant une commande ping à l'hôte 2 depuis l'hôte 1. Cliquez sur Enregistrer.
9. Dans l'onglet Configuration, accédez à l'onglet Général, enlevez la valeur du champ Adresse d'écoute et cliquez sur Enregistrer.
10. Accédez à <Nom de domaine> -> Environnement -> Serveurs. Cliquez sur essbase_server1. Dans l'onglet Configuration, accédez à l'onglet Général et enlevez la valeur du champ Adresse d'écoute. Cliquez sur Enregistrer.
11. Dans le panneau de gauche, cliquez sur Activer les modifications.
12. Arrêtez WebLogic dans l'hôte 1 à l'aide de stop.sh (sous Linux) ou stop.cmd (sous Windows).
  
  Sous Linux :
```
<Domain Home>/esstools/bin/stop.sh
```
  Sur Windows, procédez comme suit :
```
<Domain Home>\esstools\bin\stop.cmd
```
Exécutez tlsTools.jar pour mettre à jour les certificats, comme décrit dans Configuration de TLS pour le basculement Essbase.

Dans l'hôte 1, packagez la configuration complète du domaine en exécutant la commande suivante et exportez-la en tant que fichier JAR. Cette opération peut prendre quelques minutes.

Sous Linux :

<Oracle home>/oracle_common/common/bin/pack.sh -domain=<DOMAIN_HOME> -template=<user specified path>/essbase_ha.jar -template_name=essbase_domain -managed=true

Exemple Linux:

./Oracle/Middleware/Oracle_Home/oracle_common/common/bin/pack.sh -domain=./Oracle/Middleware/Oracle_Home/domains/essbase_domain -template=./essbase_ha.jar -template_name=essbase_domain -managed=true

Sur Windows, procédez comme suit :

<Oracle home>\oracle_common\common\bin\pack.cmd -domain=<DOMAIN_HOME> -template=<user specified path>/essbase_ha.jar -template_name=essbase_domain -managed=true

Exemple Windows:

c:\>\Oracle_Home\oracle_common\common\bin\pack.cmd -domain=C:\Oracle_Home\domains\essbase_domain -template=essbase_ha.jar -template_name=essbase_domain -managed=true

Transférez le fichier JAR généré, <user specified path>/essbase_ha.jar, vers un dossier du noeud secondaire.
- Sous Linux, utilisez la copie réseau ou ftp :
```
cp /network path of Host 1/<Host 1 Essbase Installation>/essbase_ha.jar <Host 2>/<some dir>/essbase_ha.jar
```
- Sous Windows, copiez le fichier essbase_ha.jar sur le second noeud en partageant le dossier entre les deux noeuds.