Impostare un ambiente di failover Essbase utilizzando lo script di impostazione del failover

A partire dalla release 21.5.2, è possibile utilizzare lo script di impostazione del failover di Essbase per automatizzare i seguenti flussi di lavoro che, nelle release precedenti, dovevano essere eseguiti manualmente:

Passi manuali per la configurazione del failover Essbase sul nodo primario (host 1)
Passi manuali per la configurazione del failover sul nodo secondario (host 2)

Invece di seguire i passi manuali, utilizzare il flusso di lavoro seguente per automatizzare l'impostazione del failover nella Release 21.5.2 e successive.

Introduzione

Seguire la procedura descritta in Prerequisiti di failover di Essbase.
Eseguire l'accesso al nodo principale, aprire un prompt o un terminale dei comandi e eseguire il ping del nodo secondario (di failover). Annotare il relativo IP pubblico.
Esempio
```
ping secondaryhost.example.com
```
Eseguire l'accesso al nodo secondario (di failover), aprire un prompt dei comandi o un terminale ed eseguire l'esecuzione del ping del nodo principale. Annotare il relativo IP pubblico.
Esempio
```
ping primaryhost.example.com
```

Impostazione del nodo principale (host 1)

Nel nodo primario (host 1), aprire il file di configurazione del server Essbase e aggiungere la proprietà di configurazione: FAILOVERMODE TRUE. Vedere Impostazione delle proprietà di configurazione a livello di server.
Sul nodo primario (host 1), accedere allo script di impostazione del failover di Essbase in <Essbase Product Home>/modules/oracle.essbase.sysman/scripts/failover.
Se non si conosce la posizione di <Essbase Product Home>, vedere Posizioni degli ambienti nella piattaforma Essbase per i dettagli.

Esempio per l'ambiente Linux
```
cd /scratch/user/oracle_home/essbase/modules/oracle.essbase.sysman/scripts/failover
```
Esempio per Windows
```
chdir C:\Oracle\Middleware\Oracle_Home\essbase\modules\oracle.essbase.sysman\scripts\failover
```
Obbligatorio solo per Linux: nel nodo primario (host 1), modificare le autorizzazioni di accesso per rendere eseguibile lo script di impostazione del failover di Essbase.
Esempio
```
chmod +x essbaseFailoverSetup.sh
```
Nel nodo primario (host 1), eseguire lo script di impostazione del failover di Essbase per impostare la configurazione principale. La sintassi d'uso dello script è la seguente:
```
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
```
Esempio di sessione script
1. Eseguire lo script con l'opzione -primaryconfig.
  Esempio per l'ambiente Linux
```
./essbaseFailoverSetup.sh –primaryconfig
```
  Esempio per Windows
```
.\essbaseFailoverSetup.cmd –primaryconfig
```
2. Se nel sistema WebLogic sono configurati più domini, nello script verranno visualizzate tutte le home del dominio e verrà richiesto di scegliere la home del dominio. Se è presente una singola home del dominio, il sistema la utilizza senza prompt.
  
  Esempio:
```
Identified multiple domains, listed as below: 
Choose the Essbase domain home path(<DOMAIN_HOME>) from the list:  
../domains/esscs
../domains/esscs2
```
  Al prompt, immettere il percorso di rete condiviso per Essbase <Application Directory>. Deve essere lo stesso percorso di rete immesso nel passo 1 dei prerequisiti di failover di Essbase.
  Esempio per l'ambiente Linux
```
/u01/essbase_data
```
  Esempio per Windows
```
z:\essbase_mount
```
  Nota
  In un ambiente configurato per il failover, la directory dell'applicazione deve essere un mount di rete condiviso accessibile da entrambi gli host.
3. Al prompt, immettere il nome del nodo di failover. Se TLS è stato abilitato, immettere la porta sicura del server gestito. Se TLS non è abilitato, immettere la porta del server gestito. Immettere la porta Node Manager.
  Esempi
```
essbase_domain2 
9001 
9555
```
  Se è stata immessa una porta sicura, è necessario anche completare la configurazione di TLS per il failover di Essbase.
4. Alle richieste, immettere gli indirizzi IP pubblici dei nodi di failover e primari ottenuti nei passi precedenti.
  Esempi
```
100.x.x.01 
100.x.x.02
```
  Dopo aver fornito tutti gli input allo script, termina la configurazione del failover per il nodo primario. Ora puoi passare alla configurazione del nodo secondario.

Impostare il nodo secondario (host 2)

SSH al nodo secondario, host 2.
Passare allo script di impostazione del failover di Essbase in <Essbase Product Home>/modules/oracle.essbase.sysman/scripts/failover.
Se non si conosce la posizione di <Essbase Product Home>, vedere Posizioni degli ambienti nella piattaforma Essbase per i dettagli.
Esempio per l'ambiente Linux
```
cd /scratch/user/oracle_home/essbase/modules/oracle.essbase.sysman/scripts/failover
```
Esempio per Windows
```
chdir C:\Oracle\Middleware\Oracle_Home\essbase\modules\oracle.essbase.sysman\scripts\failover
```
Obbligatorio solo per Linux: nel nodo secondario/di failover (host 2), modificare le autorizzazioni di accesso per rendere eseguibile lo script di impostazione del failover di Essbase.
Esempio
```
chmod +x essbaseFailoverSetup.sh
```
Nel nodo secondario/di failover (host 2), eseguire lo script di impostazione del failover di Essbase per impostare la configurazione del nodo di failover.
La sintassi d'uso dello script è la seguente:
```
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
```
Esempio di sessione script
1. Eseguire lo script con l'opzione -failoverconfig.
  Esempio per l'ambiente Linux
```
./essbaseFailoverSetup.sh –failoverconfig
```
  Esempio per Windows
```
.\essbaseFailoverSetup.cmd –failoverconfig
```
2. Al prompt, immettere il percorso di rete condiviso per Essbase <Application Directory>. Se non si conosce la posizione di <Application Directory>, vedere Posizioni degli ambienti nella piattaforma Essbase per i dettagli.
  Esempio per l'ambiente Linux
```
/u01/essbase_data
```
  Esempio per Windows
```
z:\essbase_mount
```
  Nota
  In un ambiente configurato per il failover, la directory dell'applicazione deve essere un mount di rete condiviso accessibile da entrambi gli host.
3. Al prompt, immettere il nome di dominio del nodo primario. Deve corrispondere ai valori forniti durante la configurazione.
  Esempio
```
/scratch/user/oracle_home/domains/essbase_domain
```
  Dopo aver fornito tutti gli input allo script, termina la configurazione del failover per il nodo secondario.

Configurazioni aggiuntive

In entrambi i nodi, aggiornare le proprietà di avvio del server gestito per fare riferimento al nome host e alla porta del load balancer Oracle HTTP Server (OHS).
1. Configurare le voci OHS per i nodi primari e secondari utilizzando i passi documentati in Configura un load balancer per supportare il failover.
2. Sui nodi primario e di failover:
  Su Linux, modificare <Domain Home>\bin\setStartupEnv.sh
  
  In Windows, modificare <Domain Home>\bin\setStartupEnv.cmd
  - Cercare la stringa DISCOVERY_URL per il gruppo di avvio ESSBASE-MAN-SVR e modificare il nome host e la porta nell'URL di Oracle HTTP Server.
    Esempio
```
-DDISCOVERY_URL=http(s)://OHS_HOST:OHS_PORT/essbase/agent
```
Avviare e convalidare la configurazione del failover di Essbase utilizzando la procedura descritta in Avvio e convalida della configurazione del failover di Essbase.