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

Suggerimento: per la release 21.5.2 o successiva, ignorare queste istruzioni e utilizzare le istruzioni in Impostazione di un ambiente di failover Essbase mediante lo script di impostazione del failover.

Configurare il nodo primario di Essbase per il failover. Si eseguirà la configurazione guidata di Fusion Middleware, si modificheranno i file di script, si aggiungeranno le proprietà di configurazione di Essbase, si configureranno i server nella console WebLogic, si eseguirà la utility Strumenti TLS, si comprerà la configurazione del dominio e la si copierà nel secondo nodo.

Prima di iniziare, vedere Configura TLS per il failover di Essbase per informazioni sulla configurazione del file delle proprietà di TLS.

Host 1 è il nodo primario di Essbase e dispone di tutti i servizi non in cluster (ad esempio AdminServer).

SSH all'host 1 e arrestare l'istanza di Essbase:

In Linux:

<Domain Home>/esstools/bin/stop.sh

In Windows:

<Domain Home>\esstools\bin\stop.cmd

Avviare la configurazione guidata di Fusion Middleware e aggiornare la configurazione sull'host 1:

In Linux:
```
<Oracle Home>/oracle_common/common/bin/config.sh
```
In Windows:
```
<Oracle Home>\oracle_common\common\bin\config.cmd
```
1. Nella schermata Crea dominio, selezionare Aggiorna un dominio esistente. Assicurarsi che la posizione del dominio corretta sia specificata nel campo Posizione dominio e fare clic su Successivo.
2. Nella schermata Modelli accettare i valori predefiniti e fare clic su Successivo.
3. Nella schermata Tipo di configurazione database, modificare la selezione da Dati RCU a Configurazione manuale e fare clic su Successivo.
4. Nella schermata Origini dati componente accettare i valori predefiniti e fare clic su Successivo.
5. Nella schermata Test JDBC accettare i valori predefiniti e fare clic su Successivo.
6. Nella schermata Configurazione avanzata selezionare Topologia e fare clic su Successivo.
7. Nella schermata Server gestiti, fare clic su Aggiungi e immettere i dettagli dell'host 2.
  - Immettere le porte del server gestito per essbase_server2.
  - Selezionare la casella di controllo Abilita SSL se è necessario aggiornare la porta di ascolto SSL.
  - Per aggiornare la porta di ascolto SSL, fare clic sulla casella di input Porta di ascolto. Selezionare i gruppi di server come ESSBASE-MAN-SVR e fare clic su Successivo.
8. Accettare le impostazioni predefinite e fare clic su Successivo nelle schermate riportate di seguito.
  - Cluster
  - Modelli server
  - Server dinamici
  - Assegna server a cluster
  - Applicazioni proxy HTTP
  - Cluster Coherence
9. Nella schermata Macchine, fare clic su Aggiungi e aggiungere un nuovo computer, m2. Immettere i valori per il nome host e la porta Node Manager di Host 2. È possibile scegliere la porta Node Manager, 9556. Fare clic su Successivo.
10. Nella schermata Assegna server a computer, selezionare m2 nel pannello di destra. Selezionare il server appena creato, essbase_server2, nel pannello di sinistra e aggiungerlo a m2. Dopo averla aggiunta, essbase_server2 viene visualizzato in m2. Fare clic su Avanti.
11. Accettare le impostazioni predefinite e fare clic su Avanti nelle seguenti schermate:
  - Destinazioni virtuali
  - Partizioni
12. Nella schermata Riepilogo configurazione fare clic su Aggiorna.
13. Al termine dell'aggiornamento, fare clic su Successivo e nell'ultima schermata fare clic su Fine per completare le modifiche alla configurazione.
Nell'host 1, modificare il file <Domain Home>/bin/setDomainEnv.sh (su Linux) o <Domain Home>\bin\setDomainEnv.cmd (su Windows).
Attenzione

La piattaforma Essbase include script in <DOMAIN HOME>/bin in grado di personalizzare l'ambiente e i comportamenti della funzionalità Essbase. Tuttavia, apportare modifiche a questi script dell'ambiente di dominio o di avvio può avere effetti indesiderati, incluso il mancato avvio. Oracle consiglia di apportare le modifiche prima in un ambiente di test. Prima di modificare questi script, effettuare sempre le operazioni riportate di seguito.
1. Arrestare i server gestiti di Essbase utilizzando <DOMAIN HOME>/esstools/bin/stop.sh (in Linux) o <DOMAIN HOME>\esstools\bin\stop.cmd (in Windows).
2. In <DOMAIN HOME>/bin, fare una copia di backup del file che si desidera modificare. Di seguito sono riportati alcuni esempi.
  
  in Linux
```
cp setStartupEnv.sh setStartupEnv_bak.sh
```
  in Windows
```
copy setStartupEnv.cmd setStartupEnv_bak.cmd
```
3. Apportare le modifiche con attenzione, utilizzando solo le istruzioni documentate di Oracle o collaborando con il Supporto Oracle.
4. Riavviare Essbase utilizzando <DOMAIN HOME>/esstools/bin/start.sh (su Linux) o <DOMAIN HOME>\esstools\bin\start.cmd (su Windows). Verificare che l'avvio sia stato completato normalmente.
1. Cercare la stringa EXTRA_JAVA_PROPERTIES.
  
  Importante: cercare EXTRA_JAVA_PROPERTIES e non JAVA_PROPERTIES.
2. Aggiungere la seguente definizione -D dopo la riga EXTRA_JAVA_PROPERTIES di esportazione esistente:
  
  In Linux:
```
EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES}-Dweblogic.security.SSL.ignoreHostnameVerification=true" export EXTRA_JAVA_PROPERTIES
```
  In Windows:
```
set EXTRA_JAVA_PROPERTIES=-Dweblogic.security.SSL.ignoreHostnameVerification=true %EXTRA_JAVA_PROPERTIES%
```
  Nota
  Questo passaggio non è necessario se tutti i certificati TLS vengono importati correttamente. In caso di certificati autofirmati o se in seguito il server gestito non riesce ad avviarsi con errori SSL, questo passaggio è necessario.
Modificare il file <Domain Home>/config/fmwconfig/essconfig/essbase/essbase.cfg e aggiungere le righe seguenti:

FAILOVERMODE true

N. facoltativo

TEMPO DI RINNOVO DELICATO 10

N. facoltativo

TEMPO DI SCADENZAAGENTLEASE 20

Avvia AdminServer nell'host 1.

In Linux:

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

In Windows:

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

Individuare l'IP pubblico dei computer Host 1 e Host 2, ad esempio utilizzando il comando ping dell'altro host. Se entrambe le macchine sono dietro il firewall, assicurarsi di conoscere gli IP con cui sia Host 1 che Host 2 possono comunicare tra loro.
Configurare il server di amministrazione e i server gestiti utilizzando la console WebLogic:
1. Eseguire il login alla console AdminServer WebLogic utilizzando le credenziali di amministrazione WebLogic. La porta AdminServer predefinita è 7001.
  
  Esempio: http(s)://host:7001/console
2. Fare clic su Lock & Edit nel pannello sinistro. Passare a <Domain Name> -> Environment -> Servers -> AdminServer. Nella scheda Configurazione fare clic su Generale ed espandere la sezione Avanzate. Immettere l'indirizzo IP pubblico dell'host 1 nella proprietà Indirizzo di ascolto esterno.
  
  Importante: immettere l'IP dell'host 1 visualizzato dall'host 2.
3. Fare clic su Salva.
4. Ripetere i passi a, b e c direttamente sopra per aggiornare l'indirizzo di ascolto esterno per essbase_server1 con l'IP pubblico dell'host 1.
5. Rimuovere essbase_cluster dall'appartenenza cluster Coherence predefinita.
  1. Passare a <Nome dominio> -> Ambiente -> Cluster Coherence.
  2. Fare clic su defaultCoherenceCluster. Fare clic sulla scheda Membri. Deselezionare essbase_cluster.
  3. Fare clic su Salva.
6. Passare a <Domain Name> -> scheda Security-> scheda Embedded Ldap. Selezionare l'opzione Primo master e fare clic su Salva.
7. Passare a <Domain Name> -> Environment -> Servers. Fare clic sul nuovo server essbase_server2 aggiunto.
8. Nella scheda Configurazione andare alla scheda Generale, espandere la sezione Avanzate, quindi immettere l'indirizzo IP pubblico dell'host 2 nel campo Indirizzo di ascolto esterno. Assicurati di ottenere questo IP pubblico ping Host 2 da Host 1. Fare clic su Salva.
9. Nella scheda Configurazione andare alla scheda Generale, rimuovere il valore dal campo Indirizzo di ascolto e fare clic su Salva.
10. Passare a <Domain Name> -> Environment -> Servers. Fare clic su essbase_server1. Nella scheda Configurazione andare alla scheda Generale e rimuovere il valore dal campo Indirizzo di ascolto. Fare clic su Salva.
11. Nel pannello a sinistra, fare clic su Attiva modifiche.
12. Arrestare WebLogic nell'host 1 utilizzando stop.sh (su Linux) o stop.cmd (su Windows).
  
  In Linux:
```
<Domain Home>/esstools/bin/stop.sh
```
  In Windows:
```
<Domain Home>\esstools\bin\stop.cmd
```
Eseguire tlsTools.jar per aggiornare i certificati, come descritto in Configura TLS per il failover Essbase.

Nell'host 1 comprimere la configurazione completa del dominio eseguendo il comando seguente ed esportarla come file jar. Questa operazione potrebbe richiedere alcuni minuti.

In 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

Esempio per l'ambiente 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

In Windows:

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

Esempio per l'ambiente 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

Trasferire il file jar generato, <user specified path>/essbase_ha.jar, in una cartella nel nodo secondario.
- Su Linux, usa la copia di rete o ftp:
```
cp /network path of Host 1/<Host 1 Essbase Installation>/essbase_ha.jar <Host 2>/<some dir>/essbase_ha.jar
```
- In Windows copiare il file essbase_ha.jar nel secondo nodo condividendo la cartella tra i due nodi.