Preparación para la migración desde Essbase 11g local

Si dispone de una aplicación y de un cubo local de Essbase 11g existentes para migrar a Essbase 26ai, revise las siguientes consideraciones y requisitos previos.

Diferencias entre Essbase 11g local y Essbase 26ai

Flujo de tareas para la migración

Note:

  • Si ha utilizado EPM Shared Services en Essbase 11g On-Premise para configurar un proveedor de seguridad externo, el paso 1 a continuación no es necesario. En función del modo de seguridad seleccionado durante la configuración, puede que necesite configurar la instancia de EPM de destino o WebLogic para utilizar el mismo proveedor de seguridad externo que se utiliza en Essbase 11g local.

  • Si utiliza Oracle Identity Cloud Service, configúrelo para que utilice el mismo proveedor de seguridad externo que se utiliza en Essbase 11g local.

  1. Migre usuarios y grupos de Essbase 11g On-Premise EPM Shared Services de origen a OCI Identity and Access Management (IAM) u Oracle Identity Cloud Service (IDCS) (para despliegue de OCI) o EPM Shared Services / LDAP de WebLogic (para despliegues independientes). Consulte Migración de usuarios y grupos de Essbase 11g.

  2. Si está exportando aplicaciones locales de Essbase 11g On-Premise que no sean Unicode, debe convertir las aplicaciones a Unicode.

    1. Utilice Alter System en el servidor y, a continuación, en una copia de seguridad de la aplicación de Essbase, antes de ejecutar la utilidad de exportación de LCM de 11g, para permitir que Essbase admita la aplicación Unicode.

    2. Para aplicaciones de almacenamiento block que no sean Unicode, exporte la aplicación mediante la opción -converttoutf8 en el comando export. Consulte Opciones de utilidad de exportación de LCM para 11g.

      Para aplicaciones de almacenamiento agregadas que no sean Unicode, siga las instrucciones manuales de conversión de Unicode en Convertir aplicación de almacenamiento agregado no Unicode en modo Unicode.

  3. Migrar aplicaciones 11g:

    1. Exporte las aplicaciones de Essbase mediante la utilidad de exportación de LCM de 11g, descargada de la instancia de destino de Essbase 26ai y ejecutando la utilidad en el equipo donde está instalado Essbase 11g local.

      Note:

      Para utilizar la utilidad de exportación de LCM 11g, se debe instalar Java Development Kit (JDK) 8 o superior, y se deben definir las siguientes variables: variable de entorno JAVA_HOME y variables de entorno EPM_ORACLE_HOME y EPM_ORACLE_INSTANCE en el terminal de shell.

    2. Importe aplicaciones de Essbase mediante la utilidad de interfaz de línea de comandos (CLI) de Essbase, descargada de la instancia de Essbase 26ai. Ejecute la utilidad para cada archivo zip exportado.

Versiones y rutas de Essbase soportadas

Se han probado las siguientes versiones para migración: 11.1.2.3.0nn, 11.1.2.4.0nn, 12.2.1 y posteriores.

Note:

Se admite la migración desde 11.1.2.3; sin embargo, no todas las aplicaciones se pueden migrar de 11.1.2.3 a 26ai. Le recomendamos que actualice de 11.1.2.3.0.n.n a 11.1.2.4.0.n.n antes de intentar la migración a 26ai.

No se admiten las siguientes rutas de migración:
  • Essbase 19c o 26ai en OCI (despliegue de Marketplace) en Essbase 26ai en Windows (despliegue independiente)
  • Essbase 26ai en Linux (despliegue independiente) en Essbase 26ai en Windows (despliegue independiente)

Artefactos migrados de 11g

Revise los artefactos de 11g soportados para la migración. Consulte Artefactos migrados.

Configuración de aplicación y base de datos no soportada

Los siguientes valores de nivel de aplicación o base de datos no están soportados en la migración: volúmenes de disco.

NOTAS DE CONFIGURACIÓN

  • Modo híbrido

    El procesador por defecto de cálculo y consulta es modo híbrido. El modo híbrido permite a los cubos de almacenamiento en bloque tener miembros ligeros de nivel superior dinámicos, así cómo consulta y cálculo totalmente dinámicos. Puede consultar los datos inmediatamente después de actualizarlos, sin ejecutar cálculos por lotes. En el modo híbrido, los cubos no se ven perjudicados si decide no aplicar Cálculo Dinámico a miembros ligeros del nivel superior. Nota: El modo híbrido no es el predeterminado si se utilizan scripts de cálculo. Si los scripts de cálculo contienen muchas dependencias dispersas, considere activar también el modo híbrido para los scripts de cálculo.

  • Uso compartido implícito

    Si utiliza el valor de configuración IMPLIED_SHARE en la aplicación local de Essbase 11g, el valor de uso compartido implícito se migra para una interrupción mínima. Para obtener más información sobre los valores predeterminados de uso compartido implícito en Essbase 26ai, consulte el tema de configuración IMPLIED_SHARE_ON_CREATE.

  • Advertencia sobre la configuración de UPPERCASECONNECTION esssql.cfg

    Si su entorno tiene un archivo esssql.cfg que contiene la configuración de UPPERCASECONNECTION que ya no se admite, puede obtener una advertencia como la siguiente al realizar operaciones de carga de datos:

    WARNING – 1021037 - SQL Config file syntax error [UpperCaseConnection], ignored.

    La forma de solucionarlo es eliminar manualmente la configuración de UPPERCASECONNECTION de esssql.cfg, que se encuentra en 

    <DOMAIN_HOME>/config/fmwconfig/essconfig/essbase/esssql.cfg

    y reinicie los servidores de Essbase.

  • Medidas de texto y fecha
    A partir de Essbase 21.3 y versiones posteriores, la configuración ALLOWOUTOFRANGELOAD está en desuso y el comportamiento será el mismo que "ALLOWOUTOFRANGELOAD TRUE" en versiones anteriores. Los valores fuera de rango y faltantes de las medidas introducidas se cargarán en los cubos que tengan medidas textuales y se exportarán desde ellos. En el siguiente ejemplo de archivo de exportación de datos, <OutOfRange_Name> es "No válido" y "NoColor" para los valores que faltan.
    "Color1" "Color2"
"Shoes" "Massachusetts" "Q1" "#Txt:NoColor" "#Txt:Yellow"
"Q2" "#Txt:Green"
"Connecticut" "Q1" "#Txt:Green" "#Txt:Invalid"
    Para obtener información sobre la carga de valores fuera de rango, consulte Carga, borrado y exportación de texto y medidas de fecha.

  • Valores de configuración

    Algunos valores de configuración predeterminados son diferentes de los que tenían en Essbase 11g local. Compruebe la Referencia de configuración.

    La configuración de INDEXCACHESIZE y DATACACHESIZE ahora controla los tamaños de caché para todos los cubos de Essbase (excepto para los cubos de almacenamiento agregado). Anteriormente, estos valores solo afectaban a los cubos recién creados o migrados.

    Para modificar los valores predeterminados de los valores de configuración de nivel de aplicación, utilice la interfaz web de Essbase.

    Oracle recomienda gestionar la mayoría de las configuraciones a nivel de aplicación. Al migrar aplicaciones, la configuración de nivel de aplicación se conserva durante los procesos de exportación e importación de LCM. Sin embargo, algunas configuraciones solo se aplican al servidor de Essbase. La mayoría de las configuraciones de servidor que especifique al configurar Essbase durante el despliegue, pero también puede cambiar los valores predeterminados de configuración del servidor mediante essbase.cfg, si es necesario.

NOTAS GENERALES

  • Tipos de datos de registro de hora SQL importados

    Los tipos de datos del registro de hora SQL que anteriormente se mostraban en formato ODBC [yyyy-mm-dd hh:mm:ss], ahora se muestran en un formato diferente [dd-MON-yy hh.mm.ss.mmm a] en el editor de reglas de la interfaz web deEssbase y, en cualquier otro lugar, en el que se importen los tipos de datos del registro de hora. Para cargar el registro de hora en el formato que elija durante las cargas de datos o las creaciones de dimensiones, puede convertir los registros de hora al formato de cadena seleccionado utilizando la función de conversión SQL en la sección de consultas de la regla de carga. El ejemplo siguiente de consulta SQL utiliza la función de formato: SELECT introdate, format(introdate, 'yyyy-MM-dd hh:mm:ss') FROM tbc.dbo.product

  • Actualización de aplicaciones de EPM: cálculos y filtros

    Después de actualizar las aplicaciones a Essbase 26ai, no puede aprovisionar miembros a cálculos o filtros desde la consola de EPM Shared Services. Debe utilizar la interfaz web de Essbase para asignar miembros. Consulte: Asignación de filtros y Acceso a cálculos.

  • Particiones

    Al realizar la operación de importación de LCM, importe las aplicaciones de origen antes que las aplicaciones de destino. Si no importa las aplicaciones de origen antes que las aplicaciones de destino, la definición de partición no funcionará y deberá volver a crearla después de importar las aplicaciones de origen.

    Después de realizar un rollback de un OPatch, puede que necesite volver a crear particiones transparentes y replicadas, y volver a validar las particiones.

  • Opciones de creación de aplicaciones que no sean LCM

    Además de utilizar LCM para migrar aplicaciones exportadas, también puede crear aplicaciones de las siguientes formas:

    • Importar mediante libros de trabajo de la aplicación Excel
    • En Smart View, utilice la extensión del diseñador de cubos
    • Sentencia create application de MaxL

  • Alias de ubicación

    LCM no admite la migración de credenciales de alias de ubicación. Después de migrar las aplicaciones desde Essbase 11g local, debe sustituir los alias de ubicación. Puede utilizar el siguiente método automatizado o un método manual mediante MaxL.

    Método automatizado para sustituir alias de ubicación

    1. Descomprima el zip exportado de LCM.
    2. Vaya a Alias de {ApplicationName}\Databases{dbName}\Location.
    3. Abra el archivo en este directorio. Se trata de un archivo con formato XML, donde el campo userName y password están vacíos. Puede proporcionar las credenciales.
    4. Vuelva a comprimir el directorio.
    5. Importe la aplicación mediante el directorio zip.

      Archivo xml de ejemplo

      <?xml version="1.0" encoding="UTF-8"?>
<java version="$VERSION$" class="java.beans.XMLDecoder">
<object class="oracle.essbase.lcm.essbase.EssbaseLocationAlias">
<void property="aliasAppName">
<string>
{appName}
</string>
</void>
<void property="aliasCubeName">
<string>
{dbName}
</string>
</void>
<void property="aliasHostName">
<string>localhost</string>
</void>
<void property="password">
<string>password</string>
</void>
<void property="userName">
<string>lauser</string>
</void>
</object>
</java>

    Método manual que utiliza MaxL para sustituir alias de ubicación

    Un método manual de opción alternativa utiliza MaxL. Después de importar aplicaciones de origen mediante la realización del trabajo LCMImport de la CLI, vuelva a crear alias de ubicación mediante Crear alias de ubicación.

  • Funciones y macros definidas por el cliente

    FOR INDEPENDENT DEPLOYMENTS: si tiene un archivo .jar personalizado que utiliza para funciones y macros de cálculo definidas personalizadas, la utilidad de exportación LCM 11g no las migra. Debe moverlos manualmente. Para ello,

    1. Observe la ubicación de <Essbase Path> y <Application directory> (ARBORPATH) en Essbase 26ai. Consulte Ubicaciones de entorno en la plataforma Essbase si es necesario.

    2. Migre funciones globales (a nivel de sistema) copiando los archivos .jar de <Essbase Path>/java/udf en la instancia de origen a <Essbase Path>/java/udf en la instancia de Essbase de destino.

    3. Migre las funciones locales (a nivel de aplicación) copiando los archivos .jar del directorio de la aplicación en la instancia de origen al directorio de la aplicación en la instancia de Essbase de destino. En otras palabras, copie los archivos .jar de <ARBORPATH>/app/<app_name> en su servidor 11g a <Application directory>/app/<app_name> en su servidor 26ai.

    4. En la instancia de destino de Essbase, agregue JVMMODULELOCATION a essbase.cfg, proporcionando como argumento la ruta a la biblioteca de JVM del sistema.

  • URL de servicio de cliente

    PARA DESPLIEGUES INDEPENDIENTES: en Essbase 11g, Provider Services es el proveedor de origen de datos de nivel medio para Oracle Essbase de clientes API de Java, Smart View y XML FOR Analysis (XMLA).

    La funcionalidad Provider Services está integrada con WebLogic. Actualice las URL de cliente al formato actual.

    Clientes URL anterior para conectar Provider Services al cliente específico Nueva URL en Essbase 26ai
    API de Java http://server_name:port/aps/JAPI http://server_name:port/essbase/japi
    Smart View http://server_name:port/aps/SmartView http://server_name:port/essbase/smartview
    XML para análisis (XMLA) http://server_name:port/aps/XMLA http://server_name:port/essbase/xmla

  • Orden de resolución de esquema y medidas con tipo activadas

    FOR OCI MARKETPLACE DEPLOYMENTS: después de migrar una aplicación de Essbase del servidor local de Essbase 11g a Essbase desplegado en OCI a través de Marketplace, debe activar las medidas introducidas en el esquema para poder cambiar el orden de resolución del esquema.

    En Essbase desplegado en OCI, la propiedad de esquema Medidas sincronizadas activadas se establece en FALSE de forma predeterminada. Para cambiar el orden de resolución, primero se debe cambiar la propiedad Typed Measures Enabled a TRUE. Para cambiar esta propiedad, consulte Acerca de las medidas escritas en la Guía del administrador de bases de datos para Oracle Essbase.