Configurer un environnement de basculement Essbase à l'aide du script de configuration du basculement

Configuration d'un environnement de basculement Essbase à l'aide du script de configuration du basculement

A partir de la version 21.5.2, vous pouvez utiliser le script de configuration du basculement Essbase pour automatiser les workflows suivants qui, dans les versions précédentes, devaient être effectués manuellement :

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

Au lieu de suivre les étapes manuelles, utilisez le workflow suivant pour automatiser la configuration du basculement dans la version 21.5.2 et les versions ultérieures.

Introduction au produit

Suivez les étapes décrites dans Prérequis pour le basculement Essbase.
Connectez-vous au noeud principal, ouvrez une invite ou un terminal de commande, puis exécutez une commande ping sur le noeud secondaire (de basculement). Notez son adresse IP publique.
Exemple
```
ping secondaryhost.example.com
```
Connectez-vous au noeud secondaire (de basculement), ouvrez une invite de commande ou un terminal, puis exécutez une commande ping sur le noeud principal. Notez son adresse IP publique.
Exemple
```
ping primaryhost.example.com
```

Configuration du noeud principal (hôte 1)

Sur le noeud principal (hôte 1), ouvrez le fichier de configuration du serveur Essbase et ajoutez la propriété de configuration : FAILOVERMODE TRUE. Voir la section Set Server-Level Configuration Properties.
Sur le noeud principal (hôte 1), accédez au script de configuration du basculement Essbase dans <Essbase Product Home>/modules/oracle.essbase.sysman/scripts/failover.
Si vous ne savez pas où se trouve <Essbase Product Home>, reportez-vous à Emplacements d'environnement dans la plate-forme Essbase pour plus de détails.

Exemple Linux
```
cd /scratch/user/oracle_home/essbase/modules/oracle.essbase.sysman/scripts/failover
```
Exemple Windows
```
chdir C:\Oracle\Middleware\Oracle_Home\essbase\modules\oracle.essbase.sysman\scripts\failover
```
Requis pour Linux uniquement : sur le noeud principal (hôte 1), modifiez les autorisations d'accès pour rendre le script de configuration du basculement Essbase exécutable.
Exemple
```
chmod +x essbaseFailoverSetup.sh
```
Sur le noeud principal (hôte 1), exécutez le script de configuration du basculement Essbase pour configurer la configuration principale. La syntaxe d'utilisation du script est la suivante :
```
essbaseFailoverSetup.sh [-primaryconfig] [-failoverconfig] [-listnodes] [-deletenode]
-primaryconfig  - For  primary node configuration
-failoverconfig - For failover node configuration
-listnodes - For listing failover nodes  
-deletenode - For removing the failover node from the cluster
```
Exemple de session de script
1. Exécutez le script avec l'option -primaryconfig.
  Exemple Linux
```
./essbaseFailoverSetup.sh –primaryconfig
```
  Exemple Windows
```
.\essbaseFailoverSetup.cmd –primaryconfig
```
2. Si plusieurs domaines sont configurés dans le système WebLogic, le script affiche tous les répertoires de base du domaine et vous êtes invité à choisir le répertoire de base du domaine. S'il existe un répertoire de base de domaine unique, le système utilise ce domaine sans invite.
  
  Par exemple :
```
Identified multiple domains, listed as below: 
Choose the Essbase domain home path(<DOMAIN_HOME>) from the list:  
../domains/esscs
../domains/esscs2
```
  A l'invite, entrez le chemin réseau partagé pour Essbase <Application Directory>. Il doit correspondre au chemin réseau saisi à l'étape 1 des prérequis de basculement Essbase.
  Exemple Linux
```
/u01/essbase_data
```
  Exemple Windows
```
z:\essbase_mount
```
  Remarques :
  Dans un environnement configuré pour le basculement, le répertoire d'application doit être un montage réseau partagé accessible par les deux hôtes.
3. A l'invite, entrez le nom du noeud de basculement. Si TLS a été activé, entrez le port sécurisé du serveur géré. Si TLS n'a pas été activé, entrez le port du serveur géré. Entrez le port du gestionnaire de noeuds.
  Exemples
```
essbase_domain2 
9001 
9555
```
  Si vous avez entré un port sécurisé, vous devez également terminer la configuration de TLS pour le basculement Essbase.
4. Dans les invites, entrez les adresses IP publiques des noeuds principaux et de basculement que vous avez obtenues lors des étapes précédentes.
  Exemples
```
100.x.x.01 
100.x.x.02
```
  Une fois que vous avez fourni toutes les entrées au script, la configuration du basculement pour le noeud principal est terminée. Vous pouvez maintenant passer à la configuration de noeud secondaire.

Configurer le noeud secondaire (hôte 2)

Connectez-vous via SSH au noeud secondaire, hôte 2.
Accédez au script de configuration du basculement Essbase dans <Essbase Product Home>/modules/oracle.essbase.sysman/scripts/failover.
Si vous ne savez pas où se trouve <Essbase Product Home>, reportez-vous à Emplacements d'environnement dans la plate-forme Essbase pour plus de détails.
Exemple Linux
```
cd /scratch/user/oracle_home/essbase/modules/oracle.essbase.sysman/scripts/failover
```
Exemple Windows
```
chdir C:\Oracle\Middleware\Oracle_Home\essbase\modules\oracle.essbase.sysman\scripts\failover
```
Requis pour Linux uniquement : sur le noeud secondaire/de basculement (hôte 2), modifiez les autorisations d'accès pour rendre le script de configuration de basculement Essbase exécutable.
Exemple
```
chmod +x essbaseFailoverSetup.sh
```
Sur le noeud secondaire/de basculement (hôte 2), exécutez le script de configuration du basculement Essbase pour configurer le noeud de basculement.
La syntaxe d'utilisation du script est la suivante :
```
essbaseFailoverSetup.sh [-primaryconfig] [-failoverconfig] [-listnodes] [-deletenode]
-primaryconfig  - For  primary node configuration
-failoverconfig - For failover node configuration
-listnodes - For listing failover nodes  
-deletenode - For removing the failover node from the cluster
```
Exemple de session de script
1. Exécutez le script avec l'option -failoverconfig.
  Exemple Linux
```
./essbaseFailoverSetup.sh –failoverconfig
```
  Exemple Windows
```
.\essbaseFailoverSetup.cmd –failoverconfig
```
2. A l'invite, entrez le chemin réseau partagé pour Essbase <Application Directory>. Si vous ne savez pas où se trouve <Application Directory>, reportez-vous à Emplacements d'environnement dans la plate-forme Essbase pour plus de détails.
  Exemple Linux
```
/u01/essbase_data
```
  Exemple Windows
```
z:\essbase_mount
```
  Remarques :
  Dans un environnement configuré pour le basculement, le répertoire d'application doit être un montage réseau partagé accessible par les deux hôtes.
3. A l'invite, saisissez le nom de domaine du noeud principal. Cela doit correspondre aux valeurs que vous avez fournies lors de la configuration.
  Exemple
```
/scratch/user/oracle_home/domains/essbase_domain
```
  Une fois que vous avez fourni toutes les entrées au script, la configuration du basculement pour le noeud secondaire est terminée.

Configurations supplémentaires

Sur les deux noeuds, mettez à jour les propriétés de démarrage du serveur géré pour référencer le nom d'hôte et le port de l'équilibreur de charge Oracle HTTP Server (OHS).
1. Configurez les entrées OHS pour les noeuds principaux et secondaires en suivant les étapes décrites dans Configuration d'un équilibreur de charge pour la prise en charge du basculement.
2. Sur les noeuds principal et de basculement :
  Sous Linux, modifiez <Domain Home>\bin\setStartupEnv.sh
  
  Sous Windows, modifiez <Domain Home>\bin\setStartupEnv.cmd
  - Recherchez la chaîne DISCOVERY_URL pour le groupe de démarrage ESSBASE-MAN-SVR, puis remplacez le nom d'hôte et le port par l'URL Oracle HTTP Server.
    Exemple
```
-DDISCOVERY_URL=http(s)://OHS_HOST:OHS_PORT/essbase/agent
```
Démarrez et validez la configuration de basculement Essbase en suivant les étapes de la section Démarrer et valider la configuration de basculement Essbase.