Configurar Essbase en Windows

Debe configurar Essbase en Windows mediante la herramienta de configuración después de la instalación.

Requisitos previos y notas

Fusion Middleware ya debe estar instalado y Oracle Essbase debe estar instalado en el mismo directorio raíz de Oracle. Consulte Instalar Fusion Middleware.
Se debe instalar la base de datos relacional soportada, como se menciona en los requisitos de instalación. Consulte Instalación de una base de datos relacional.
Si utiliza la autenticación de EPM Shared Services, ya debe tener instalada una versión admitida de EPM, con los usuarios de EPM Shared Services creados y configurados, y conozca los detalles de la instancia de Oracle Home y EPM.
- Si utiliza la autenticación de EPM Shared Services, debe ejecutarse durante la configuración de Essbase. Si EPM Shared Services no se está ejecutando, algunos números de puerto se deben configurar manualmente para evitar conflictos de puertos. Al configurar Essbase, debe ser cauteloso y tener en cuenta los puertos que ya están siendo utilizados por cualquier servicio de EPM en este host, y solo debe elegir y utilizar puertos válidos que no sean utilizados por un servicio o aplicación en este host. También debe definir estos números de puerto no utilizados según corresponda en la interfaz de usuario o en el archivo de respuesta.
Si utiliza Microsoft SQL Server (MSSQL) como base de datos para los esquemas del repositorio de Essbase (RCU), debe ejecutar el proceso para modificar la base de datos y aplicar las consideraciones correctas de correlación y esquema de dirección antes de ejecutar la herramienta de configuración de Essbase. Para obtener más información, consulte Configuración de Microsoft SQL Server como base de datos de repositorio para esquemas de Essbase.
En Creación previa de esquemas de RCU para Essbase se explica el proceso si decide crear previamente esquemas de RCU antes de la configuración, en lugar de que la herramienta de configuración los cree. Un caso de uso para crear previamente esquemas es si está empleando una conexión HTTPS segura mediante una cartera.
En Panel de control de Windows > Reloj y región > Región, seleccione el separador Administrativo. Haga clic en Cambiar Configuración Regional del Sistema y seleccione las casillas de verificación Beta: Use Unicode UTF-8 para la compatibilidad del idioma en todo el mundo.
Essbase en Windows no puede tener varias configuraciones o instancias en el mismo host.
Debe aplicar los siguientes parches en el directorio raíz de Oracle antes de crear esquemas de RCU, tanto si utiliza esquemas creados previamente como si no. Consulte los parches más recientes en la sección Notas de la versión de Essbase para Despliegue independiente o póngase en contacto con Soporte para verificar las versiones de parches adecuadas.
- 28186730 - Última versión de OPatch 13.9.4.2.x para FMW/WLS
- 31676526: parche 12.2.1.4.0 para advertencia de RCU de TNS_ADMIN
- 30540494: parche 12.2.1.4.0 para el bug RCU de RAC
- 30754186: parche 12.2.1.4.0 para el bug RCU de RAC
Todos los puertos no deben estar dentro del rango de puertos efímeros ni estar en uso por otro software en ejecución. Consulte Avoid Port Conflicts.
Cada servidor gestionado se debe asignar a una máquina, la representación lógica de la computadora que aloja una o más instancias de servidor. El nombre de máquina debe ser único con respecto al resto de recursos configurables del dominio.
Si tiene previsto instalar y configurar más de una instancia local de Essbase, para soportar el failover, necesita un equilibrador de carga de frontend y las instancias se deben configurar en hosts diferentes. Como se ha mencionado, Essbase en Windows no puede tener varias configuraciones o instancias en el mismo host. Consulte Configuración de un equilibrador de carga para soportar el failover.
Si el servicio de Essbase se va a configurar o está disponible como servicio de Windows de Essbase, para iniciar y detener el servicio de Essbase, PowerShell debe estar en la variable PATH de entorno. También debe activar el servicio de Windows de Essbase durante la configuración para instalar el servicio de Windows.
Si se conecta a través de Smart View, mediante la URL /aps/SmartView, debe cambiar la URL. Consulte Redirección a la nueva URL de conexión de Essbase Smart View. También puede configurar la redirección a la nueva URL en el servidor web. Si utiliza Oracle HTTP Server (OHS) o HTTPD Server, redirija la URL mientras modifica la configuración de Oracle HTTP Server, como se indica en la viñeta anterior.
Para acceder al archivo de respuesta y utilizarlo, debe definir las variables de entorno TEMP y TMP para el usuario, de la siguiente manera:
1. En la barra de tareas de Windows, haga clic con el botón derecho en el icono de Windows y seleccione Sistema.
2. En la página Configuración, en la cabecera Configuración relacionada de la derecha, haga clic en Información de sistemas y, a continuación, en Configuración avanzada del sistema.
3. Seleccione Variables de entorno.
4. Haga clic en Nuevo para crear nuevas variables de entorno TEMP y TMP o haga clic en Editar para modificar las variables de entorno TEMP y TMP existentes, con los valores de las variables de usuario. Puede utilizar el mismo valor para ambos.
5. Después de establecerlo, abra un nuevo cmd o símbolo del sistema para reflejar el nuevo conjunto de variables.

Ejecutar herramienta de configuración

Si no ha continuado con la configuración al final de la instalación, inicie la herramienta de configuración.
1. En el directorio raíz de Oracle, donde están instalados Essbase y Fusion Middleware, abra un terminal en \essbase\bin. Por ejemplo, abra un terminal en <Oracle_Home>\essbase\bin.
2. Inicie la herramienta de configuración con la secuencia de comandos config.cmd.
```
config.cmd
```
  El script se puede ejecutar con parámetros (como -mode, -log, -log priority, -responseFile). Si utiliza el parámetro responseFile, todos los campos se rellenan con entradas de configuración anteriores, excepto las contraseñas. Para obtener más información sobre las opciones de script de configuración, ejecute: config.cmd -help.
En la página Bienvenido, haga clic en Siguiente.
En la página Domain Details (Detalles de dominio), haga lo siguiente.
1. Acepte el valor por defecto (si es correcto) o introduzca su nombre de dominio, por ejemplo, essbase_domain.
2. Acepte el valor por defecto (si es correcto) o introduzca la ruta raíz del dominio, por ejemplo,
```
C:\Oracle_home\dist\domains
```
3. Acepte el valor por defecto o introduzca el directorio de la aplicación, por ejemplo,
```
C:\Oracle_home\dist\applications\essbase
```
  Se recomienda que el directorio de aplicaciones esté separado de los archivos de configuración.
4. Introduzca el nombre y la contraseña de una cuenta de administrador de WebLogic que utilizará para gestionar servidores de Essbase y middleware.
  - Si utiliza WebLogic Embedded LDAP, a este administrador también se le asigna un rol de administrador de servicio de Essbase.
  - Si utiliza EPM Shared Services, este administrador solo es para la instancia de WebLogic del dominio de Essbase. El usuario administrador de EPM Shared Services se aprovisionará con el rol de usuario de Essbase: Administrador de servicio.
5. Haga clic en Siguiente.
En la página de conexión a la base de datos, haga lo siguiente.
1. Acepte el valor por defecto o introduzca el tipo de base de datos. Esta es la base de datos relacional soportada, por ejemplo, Oracle Database.
2. Introduzca la cadena de conexión, por ejemplo,
```
myhost.example.com:1521/orcl
```
  Consulte Formatos de cadena de conexión.
3. Seleccione si desea crear nuevos esquemas ahora o utilizar los esquemas creados previamente mediante la utilidad RCU de Fusion Middleware en Creación previa de esquemas RCU para Essbase como tarea de flujo de trabajo de configuración previa. Si utiliza Microsoft SQL Server (MSSQL) en la configuración, consulte los requisitos relacionados anteriores.
4. Introduzca un prefijo de esquema, por ejemplo, ESS26AI. Debe ser una cadena nueva y única, que contenga entre 1 y 12 caracteres alfanuméricos y que empiece por una letra.
5. Introduzca una contraseña de esquema que se compartirá para todos los nuevos esquemas.
6. Para el nombre de usuario y la contraseña del administrador, introduzca las credenciales de cualquier usuario al que se haya otorgado un rol sysdba para Oracle Database. Puede ser el usuario sys predeterminado o el administrador de la base de datos de Microsoft. El nombre de usuario debe empezar por una letra y contener entre 5 y 128 caracteres alfanuméricos. La contrase debe empezar con una letra, tener entre 8 y 30 caracteres de longitud, contener al menos un número y, opcionalmente, cualquier número de caracteres especiales ($ # _).
7. Haga clic en Siguiente.
En la página Node Manager Configuration, realice lo siguiente.
1. Acepte los valores por defecto o introduzca la cadena para el nombre de la máquina del gestor de nodos, que maneja los clusters. Todos los puertos no deben estar dentro del rango de puertos efímeros ni estar en uso por otro software en ejecución. Consulte Avoid Port Conflicts.
2. En Dirección de Recepción del Gestor de Nodos, puede introducir o seleccionar el nombre de host completo (donde WebLogic está instalado junto con la instalación de Fusion Middleware). También puede ser una dirección del sistema operativo. Para obtener más información, consulte Configuración de direcciones de recepción.
3. Haga clic en Siguiente.
En la página Configuración de puertos del servidor de WebLogic, configure según las opciones que haya realizado durante la instalación.
Acepte los valores por defecto o introduzca valores. Los valores de la pantalla anterior son solo ejemplos. Especifique puertos claros y seguros para cada uno de los servidores. Consulte Server Configuration Options. Todos los puertos no deben estar dentro del rango de puertos efímeros ni estar en uso por otro software en ejecución. Consulte Avoid Port Conflicts.
1. Para proteger las conexiones mediante Transport Layer Security (TLS Everywhere), seleccione la casilla de control Secure Connection Mode (Modo de conexión segura); a continuación, se reconocerá el certificado autofirmado. Si aún no lo ha hecho, revise este tema: Acerca de la protección de la comunicación y la red. Si se despliega la seguridad de TLS, el puerto por defecto es el puerto seguro del servidor gestionado. El valor de puerto por defecto es 9000 para no seguro y 9001 para seguro. Se recomienda utilizar la seguridad (9001).
  
  Si configura Essbase para que utilice una base de datos relacional que no sea de Oracle como base de datos de repositorio de RCU, puede que necesite realizar pasos adicionales, una vez que se haya completado el despliegue de Essbase, para configurar los controladores ODBC del sistema para que admitan el cifrado seguro/TLS. Consulte las instrucciones de configuración del controlador de la base de datos.
2. [Opcional] Para limitar el acceso a hosts específicos (para entornos de directorio raíz múltiple), especifique o seleccione un dominio, por ejemplo, localhost, en los campos de dirección de recepción. Si no selecciona/introduce valores de direcciones de recepción, las direcciones de recepción se aplican a todas las interfaces y direcciones, y se puede acceder a todos los hosts asignados.
3. Haga clic en Siguiente.
En la página Configuración de puertos de Essbase, realice lo siguiente.
1. Acepte los valores predeterminados o introduzca valores para el puerto del agente, el puerto seguro del agente (utilizado para la comunicación segura mediante TLS) y los puertos mínimo y máximo para los servidores de aplicaciones de Essbase.
  - El puerto del agente especifica el puerto para el agente de Essbase; el valor predeterminado es 1423.
  - El puerto seguro del agente especifica el puerto que el agente de Essbase utiliza para la comunicación segura cuando está en modo de conexión segura con seguridad de capa de transporte (TLS). El valor predeterminado es 6423.
  - Cuando se instalan varias instancias del Servidor Essbase en un host, se debe especificar un número de puerto único para cada instancia.
  - Todos los puertos no deben estar dentro del rango de puertos efímeros ni estar en uso por otro software en ejecución. Consulte Avoid Port Conflicts.
  - El rango entre los puertos mínimo y máximo debe ser de al menos 1000, según la cantidad utilizada.
2. Haga clic en Siguiente.
En la página de configuración del proveedor de identidad, realice lo siguiente.
1. Si aún no lo ha hecho, revise el tema Seleccionar proveedor de autenticación.
2. WebLogic es el valor predeterminado. Si actualmente utiliza EPM Shared Services y desea continuar, seleccione la casilla de control Activar proveedor de identidad de EPM Shared Services. El ejemplo de la ventana muestra el proveedor de EPM seleccionado. Cuando está activado, los campos de EPM están disponibles para confirmar o especificar las ubicaciones del directorio raíz de Oracle de EPM y la instancia de Oracle. For details on these, see About Middleware Home, EPM Oracle Home, and EPM Oracle Instance.
3. Para que el servicio de Windows de Essbase se configure o esté disponible, para iniciar y detener el servicio de Essbase, PowerShell debe estar en la variable de entorno PATH. También debe activar el servicio de Windows de Essbase durante la configuración para instalar el servicio de Windows. Para utilizar esta función, debe seleccionar Activar Servicio de Windows de Essbase, en esta página, para instalar el servicio de Windows. El inicio y la parada del servicio de Windows de Essbase se realizan mediante Windows SCM.
4. Haga clic en Siguiente.
Revise la página Resumen de configuración. Observe la ubicación del archivo log (si se muestra) y la ubicación del archivo de respuesta. Este ejemplo de ventana puede variar de las entradas o valores seleccionados. Puede utilizar el archivo de respuesta (.rsp) para guardar las opciones de configuración y rellenar los mismos valores de campo (excluyendo contraseñas) en una futura configuración en modo silencioso o basada en IU. Si desea ejecutar una configuración futura mediante un archivo .rsp, también puede ejecutar la configuración hasta la página de resumen, hacer clic en Cancelar en lugar de en Configurar y volver a utilizar el archivo de respuesta más tarde. El archivo .rsp se guarda en la ubicación temporal que se muestra en el resumen como Ubicación de archivo de respuesta. Si tiene previsto utilizarlo para automatizar una configuración futura, asegúrese de guardarlo en un lugar más permanente, ya que los directorios tmp se pueden limpiar de forma rutinaria. Consulte Archivo de respuesta de ejemplo y parámetros.
Haga clic en Configurar. En la página Progreso de la configuración, cerca del final del procesamiento de la herramienta de configuración, se inician los componentes de la plataforma de Essbase. Cuando el progreso alcance el 100 %, haga clic en Siguiente.
En la página Configuración finalizada, revise los detalles y haga clic en Terminar. Tenga en cuenta que este ejemplo de ventana no refleja necesariamente las entradas o valores seleccionados. Ahora puede iniciar sesión en Essbase. Para conocer las URL de inicio de sesión, consulte URL de cliente de Essbase, REST e Smart View.
Note:

Si ha configurado Essbase de forma segura con una base de datos externa mediante un alias de TNS_ADMIN, por ejemplo, adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS, debe hacer lo siguiente para que el servidor de Essbase pueda procesar la conexión:
1. Editar:
```
<DOMAIN_HOME>\bin\setStartupEnv.cmd
```
2. Agregue la siguiente línea al script de inicio, antes del uso de -DODBC_URL=:
```
set TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS
```
3. Cambie la siguiente línea:
```
-DODBC_URL='OCI;SERVICE=adwsql_low?TNS_ADMIN=C:/Users/opc/Documents/EssbaseADWS'
```
  to
```
-DODBC_URL='OCI;SERVICE='adwsql_low'
```

Las opciones y tareas avanzadas y posteriores a la configuración se pueden revisar en Temas de configuración avanzados. Esto incluye temas sobre la supresión de esquemas de RCU, la configuración de Essbase y el servidor HTTP de Oracle, entre otros.