Pasos manuales para la configuración de failover de Essbase en el nodo principal (host 1)

Consejo: para la versión 21.5.2 o superior, omita estas instrucciones y utilice las instrucciones de Configuración de un entorno de failover de Essbase mediante el script de configuración de failover en su lugar.

Configure el nodo principal de Essbase para el failover. Ejecutará el asistente de configuración de Fusion Middleware, editará archivos de script, agregará propiedades de configuración de Essbase, configurará servidores en la consola de WebLogic, ejecutará la utilidad de herramientas de TLS, empaquetará la configuración de dominio y la copiará en el segundo nodo.

Antes de comenzar, consulte Configuración de TLS para failover de Essbase para obtener información sobre cómo configurar el archivo de propiedades de TLS.

El host 1 es el nodo principal de Essbase y tiene todos los servicios no agrupados en clústeres (como AdminServer).

SSH en el host 1 y detenga la instancia de Essbase:

En Linux:
```
<Domain Home>/esstools/bin/stop.sh
```
En Windows:
```
<Domain Home>\esstools\bin\stop.cmd
```
Inicie el asistente de configuración de Fusion Middleware y actualice la configuración en el host 1:

En Linux:
```
<Oracle Home>/oracle_common/common/bin/config.sh
```
En Windows:
```
<Oracle Home>\oracle_common\common\bin\config.cmd
```
1. En la pantalla Crear dominio, seleccione Actualizar un dominio existente. Asegúrese de que la ubicación de dominio correcta esté especificada en el campo Domain Location (Ubicación de dominio) y haga clic en Next (Siguiente).
2. En la pantalla Templates (Plantillas), acepte los valores predeterminados y haga clic en Next (Siguiente).
3. En la pantalla Database Configuration Type (Tipo de configuración de base de datos), cambie la selección de RCU Data (Datos RCU) a Manual Configuration (Configuración manual) y haga clic en Next (Siguiente).
4. En la pantalla Component Datasources (Orígenes de datos de componentes), acepte los valores predeterminados y haga clic en Next (Siguiente).
5. En la pantalla Prueba JDBC, acepte los valores por defecto y haga clic en Siguiente.
6. En la pantalla Advanced Configuration (Configuración avanzada), seleccione Topology (Topología) y haga clic en Next (Siguiente).
7. En la pantalla Servidores Gestionados, haga clic en Agregar e introduzca los detalles del host 2.
  - Introduzca los puertos del servidor gestionado para essbase_server2.
  - Seleccione la casilla de control Activar SSL si necesita actualizar el puerto de recepción SSL.
  - Para actualizar el puerto de recepción SSL, haga clic en el cuadro de entrada Puerto de Recepción. Seleccione los grupos de servidores como ESSBASE-MAN-SVR y haga clic en Next (Siguiente).
8. Acepte los valores por defecto y haga clic en Next (Siguiente) en las siguientes pantallas:
  - Clusters
  - Plantillas del Servidor
  - Servidores Dinámicos
  - Asignar Servidores a Clusters
  - Aplicaciones de Proxy HTTP
  - Clusters de Coherence
9. En la pantalla Machines, haga clic en Add (Agregar) y agregue una máquina nueva, m2. Introduzca los valores de nombre de host y puerto del gestor de nodos del host 2. Puede seleccionar el puerto del gestor de nodos, 9556. Haga clic en Siguiente.
10. En la pantalla Assign Servers to Machines (Asignar servidores a máquinas), seleccione m2 en el panel derecho. Seleccione el servidor recién creado, essbase_server2, en el panel izquierdo, y agréguelo a m2. Después de agregarlo, essbase_server2 se muestra en m2. Haga clic en Siguiente.
11. Acepte los valores por defecto y haga clic en Next en las siguientes pantallas:
  - Destinos Virtuales
  - Particiones
12. En la pantalla Resumen de configuración, haga clic en Actualizar.
13. Cuando termine la actualización, haga clic en Next (Siguiente) y, en la última pantalla, haga clic en Finish (Finalizar) para completar los cambios de configuración.
En el host 1, edite el archivo <Domain Home>/bin/setDomainEnv.sh (en Linux) o <Domain Home>\bin\setDomainEnv.cmd (en Windows).
Atención:

La plataforma de Essbase incluye scripts en <DOMAIN HOME>/bin que pueden personalizar el entorno y los comportamientos de la funcionalidad de Essbase. Sin embargo, los cambios en estos scripts de inicio o entorno de dominio pueden tener efectos no deseados, incluido un fallo de inicio. Oracle recomienda realizar primero los cambios en un entorno de prueba. Antes de editar estos scripts, siempre debe:
1. Detenga los servidores gestionados de Essbase mediante <DOMAIN HOME>/esstools/bin/stop.sh (en Linux) o <DOMAIN HOME>\esstools\bin\stop.cmd (en Windows).
2. En <DOMAIN HOME>/bin, realice una copia de seguridad del archivo que desea editar. Por ejemplo,
  
  En Linux
```
cp setStartupEnv.sh setStartupEnv_bak.sh
```
  En Windows
```
copy setStartupEnv.cmd setStartupEnv_bak.cmd
```
3. Edítelo cuidadosamente siguiendo únicamente las instrucciones documentada de Oracle o trabajando con los Servicios de Soporte Oracle.
4. Reinicie Essbase mediante <DOMAIN HOME>/esstools/bin/start.sh (en Linux) o <DOMAIN HOME>\esstools\bin\start.cmd (en Windows). Compruebe que el inicio se ha completado normalmente.
1. Busque la cadena EXTRA_JAVA_PROPERTIES.
  
  Importante: busque EXTRA_JAVA_PROPERTIES, no JAVA_PROPERTIES.
2. Agregue la siguiente definición -D después de la línea EXTRA_JAVA_PROPERTIES de exportación existente:
  
  En Linux:
```
EXTRA_JAVA_PROPERTIES="${EXTRA_JAVA_PROPERTIES}-Dweblogic.security.SSL.ignoreHostnameVerification=true" export EXTRA_JAVA_PROPERTIES
```
  En Windows:
```
set EXTRA_JAVA_PROPERTIES=-Dweblogic.security.SSL.ignoreHostnameVerification=true %EXTRA_JAVA_PROPERTIES%
```
  Note:
  Este paso no es necesario si todos los certificados TLS se importan correctamente. En el caso de certificados autofirmados, o si el servidor gestionado posteriormente no se inicia con errores SSL, este paso es necesario.
Edite el archivo <Domain Home>/config/fmwconfig/essconfig/essbase/essbase.cfg y agregue las siguientes líneas:

FAILOVERMODE verdadero

#Opcional

AGENTLEASERENEWALTIME 10

#Opcional

AGENTLEASEEXPIRATIONTIME 20

Inicie AdminServer en el host 1.

En Linux:

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

En Windows:

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

Averigüe la IP pública de las máquinas de host 1 y host 2, por ejemplo, mediante el comando ping del otro host. Si ambos equipos están detrás del firewall, asegúrese de conocer las IP con las que el host 1 y el host 2 pueden comunicarse entre sí.
Configure el servidor de administración y los servidores gestionados mediante la consola de WebLogic:
1. Inicie sesión en la consola AdminServer de WebLogic con las credenciales de administrador de WebLogic. El puerto AdminServer por defecto es 7001.
  
  Ejemplo: http(s)://host:7001/console
2. Haga clic en Bloquear y editar en el menú de la izquierda. Vaya a <Nombre de dominio> -> Entorno -> Servidores -> AdminServer. En el separador Configuración, haga clic en General y amplíe la sección Avanzado. Introduzca la dirección IP pública del host 1 en la propiedad Dirección de recepción externa.
  
  Importante: introduzca la IP del host 1 como la ve el host 2.
3. Haga clic en Guardar.
4. Repita los pasos a, b y c directamente anteriores para actualizar la dirección de recepción externa para essbase_server1 con la IP pública del host 1.
5. Elimine essbase_cluster de los miembros de cluster de Coherence por defecto.
  1. Navegue hasta <Nombre de dominio> -> Entorno -> Clusters de Coherence.
  2. Haga clic en defaultCoherenceCluster. Haga clic en el separador Miembros. Anule la selección de essbase_cluster.
  3. Haga clic en Guardar.
6. Vaya al separador <Domain Name> (Nombre de dominio) -> Security (Seguridad) -> separador Embedded Ldap (Lap embebido). Seleccione la opción Master First y haga clic en Save.
7. Vaya a <Domain Name> (Nombre de dominio) -> Environment (Entorno) -> Servers (Servidores). Haga clic en el servidor recién agregado essbase_server2.
8. En el separador Configuración, vaya al separador General, amplíe la sección Avanzada y, a continuación, introduzca la dirección IP pública del host 2 en el campo Dirección de Recepción Externa. Asegúrese de obtener esta IP pública haciendo ping al host 2 desde el host 1. Haga clic en Guardar.
9. En el separador Configuración, vaya al separador General, elimine el valor del campo Dirección de Recepción y haga clic en Guardar.
10. Vaya a <Domain Name> (Nombre de dominio) -> Environment (Entorno) -> Servers (Servidores). Haga clic en essbase_server1. En el separador Configuración, vaya al separador General y elimine el valor del campo Dirección de Recepción. Haga clic en Guardar.
11. En el panel de la izquierda, haga clic en Activate Changes.
12. Cierre WebLogic en el host 1 con stop.sh (en Linux) o stop.cmd (en Windows).
  
  En Linux:
```
<Domain Home>/esstools/bin/stop.sh
```
  En Windows:
```
<Domain Home>\esstools\bin\stop.cmd
```
Ejecute tlsTools.jar para actualizar los certificados, como se describe en Configuración de TLS para failover de Essbase.

En el host 1, ejecute el siguiente comando para empaquetar la configuración completa del dominio y exporte la configuración como un archivo jar. Esto puede tardar unos minutos.

En 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

Ejemplo en 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

En 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

Ejemplo en 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

Transfiera el archivo jar generado, <user specified path>/essbase_ha.jar, a una carpeta del nodo secundario.
- En Linux, utilice una copia de red o ftp:
```
cp /network path of Host 1/<Host 1 Essbase Installation>/essbase_ha.jar <Host 2>/<some dir>/essbase_ha.jar
```
- En Windows, copie essbase_ha.jar en el segundo nodo compartiendo la carpeta entre los dos nodos.