Préparation de la migration à partir d'Essbase 11g sur site

Si vous disposez d'une application et d'un cube Essbase 11g sur site existants à migrer vers Essbase 26ai, reportez-vous aux remarques et aux conditions préalables suivantes.

Différences entre Essbase 11g sur site et Essbase 26ai

Flux de tâches pour la migration

Remarques :

  • Si vous avez utilisé EPM Shared Services dans Essbase 11g sur site pour configurer un fournisseur de sécurité externe, l'étape 1 ci-dessous n'est pas requise. En fonction du mode de sécurité choisi lors de la configuration, vous devrez peut-être configurer votre instance EPM cible ou WebLogic pour utiliser le même fournisseur de sécurité externe que celui utilisé dans Essbase 11g sur site.

  • Si vous utilisez Oracle Identity Cloud Service, configurez-le pour qu'il utilise le même fournisseur de sécurité externe que celui utilisé dans Essbase 11g sur site.

  1. Migrez des utilisateurs et des groupes à partir d'Essbase 11g sur site EPM Shared Services source vers OCI Identity and Access Management (IAM) ou Oracle Identity Cloud Service (pour le déploiement OCI) ou EPM Shared Services / LDAP WebLogic (pour les déploiements indépendants). Reportez-vous à Migration d'utilisateurs et de groupes Essbase 11g.

  2. Si vous exportez des applications Essbase 11g sur site non Unicode, vous devez convertir les applications en Unicode.

    1. Utilisez Alter System sur le serveur, puis sur une copie de sauvegarde de l'application Essbase, avant d'exécuter l'utilitaire d'export LCM 11g, pour permettre à Essbase lui-même de prendre en charge l'application Unicode.

    2. Pour les applications de stockage non Unicode block, exportez l'application à l'aide de l'option -converttoutf8 dans la commande d'export. Reportez-vous à la section 11g LCM Export Utility Options.

      Pour les applications de stockage non Unicode aggregate, suivez les instructions de conversion Unicode manuelles de la section Convert Non-Unicode Aggregate Storage Application to Unicode Mode.

  3. Migrer des applications 11g :

    1. Exportez les applications Essbase à l'aide de l'utilitaire d'export LCM 11g, téléchargé à partir de l'instance Essbase 26ai cible, et exécutez l'utilitaire sur l'ordinateur sur lequel Essbase 11g sur site est installé.

      Remarques :

      Pour utiliser l'utilitaire d'export LCM 11g, Java Development Kit (JDK) 8 ou supérieur doit être installé et les variables suivantes doivent être définies : variable d'environnement JAVA_HOME et variables EPM_ORACLE_HOME et EPM_ORACLE_INSTANCE dans le terminal shell.

    2. Importez les applications Essbase à l'aide de l'utilitaire Interface de ligne de commande (CLI) Essbase, téléchargé à partir de l'instance Essbase 26ai. Exécutez l'utilitaire pour chaque fichier ZIP exporté.

Versions et chemins d'accès Essbase pris en charge

La migration des versions suivantes a été testée : 11.1.2.3.0nn, 11.1.2.4.0nn, 12.2.1 et versions ultérieures.

Remarques :

La migration à partir de 11.1.2.3 est prise en charge. Toutefois, toutes les applications ne peuvent pas être migrées de 11.1.2.3 vers 26ai. Nous vous recommandons de passer de la version 11.1.2.3.0.n.n à la version 11.1.2.4.0.n.n avant de tenter la migration vers la version 26ai.

Les chemins de migration suivants ne sont pas pris en charge :
  • Essbase 19c ou 26ai sur OCI (déploiement Marketplace) vers Essbase 26ai sous Windows (déploiement indépendant)
  • Essbase 26ai sous Linux (déploiement indépendant) vers Essbase 26ai sous Windows (déploiement indépendant)

Artefacts 11g migrés

Consultez les artefacts 11g pris en charge pour la migration. Reportez-vous à Artefacts migrés.

Paramètres d'application et base de données non pris en charge

Les paramètres de niveau application ou base de données suivants ne sont pas pris en charge dans la migration : volumes de disque.

REMARQUES DE CONFIGURATION

  • Mode hybride

    Le processeur par défaut de calcul et de requête est mode hybride. Le mode hybride permet aux cubes en stockage de blocs d'avoir des membres dispersés dynamiques de haut niveau, ainsi qu'une requête et des calculs entièrement dynamiques. Vous pouvez interroger des données immédiatement après leur mise à jour, sans exécuter de calculs par lots. En mode hybride, les cubes ne sont pas concernés si vous choisissez de n'appliquer le calcul dynamique aux membres dispersés du niveau supérieur. Remarque : Le mode hybride n'est pas la valeur par défaut si vous utilisez des scripts de calcul. Si vos scripts de calcul contiennent de nombreuses dépendances dispersées, envisagez également d'activer le mode hybride pour les scripts de calcul.

  • Partage implicite

    Si vous utilisez le paramètre de configuration IMPLIED_SHARE dans votre application Essbase 11g sur site, votre paramètre de partage implicite est migré, pour une interruption minimale. Pour plus d'informations sur les valeurs par défaut de partage implicite dans Essbase 26ai, reportez-vous à la rubrique de configuration IMPLIED_SHARE_ON_CREATE.

  • Avertissement concernant le paramètre UPPERCASECONNECTION esssql.cfg

    Si votre environnement dispose d'un fichier esssql.cfg contenant le paramètre UPPERCASECONNECTION qui n'est plus pris en charge, un avertissement semblable au suivant peut s'afficher lors de l'exécution des opérations de chargement de données :

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

    Pour résoudre ce problème, supprimez manuellement le paramètre UPPERCASECONNECTION de esssql.cfg, situé dans 

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

    puis redémarrez les serveurs Essbase.

  • Mesures de texte et de date
    A partir d'Essbase 21.3, la configuration ALLOWOUTOFRANGELOAD est en phase d'abandon et le comportement sera le même que "ALLOWOUTOFRANGELOAD TRUE" dans les versions précédentes. Les valeurs manquantes et hors limites des mesures typées seront chargées dans les cubes contenant des mesures textuelles et exportées à partir de ces cubes. Dans l'exemple de fichier d'export de données suivant, <OutOfRange_Name> est "Non valide" et "NoColor" pour les valeurs manquantes.
    "Color1" "Color2"
"Shoes" "Massachusetts" "Q1" "#Txt:NoColor" "#Txt:Yellow"
"Q2" "#Txt:Green"
"Connecticut" "Q1" "#Txt:Green" "#Txt:Invalid"
    Pour plus d'informations sur le chargement de valeurs hors plage, voir Chargement, effacement et exportation de mesures de texte et de date.

  • Paramètres de configuration

    Certaines valeurs de configuration par défaut sont différentes de celles figurant dans Essbase 11g sur site. Vérifiez la référence de configuration.

    Les paramètres INDEXCACHESIZE et DATACACHESIZE contrôlent désormais la taille du cache pour tous les cubes Essbase (à l'exception des cubes en mode "aggregate storage"). Auparavant, ces paramètres concernaient uniquement les cubes créés ou migrés récemment.

    Pour modifier les valeurs par défaut des paramètres de configuration de niveau application, utilisez l'interface Web Essbase.

    Oracle recommande de gérer la plupart des configurations au niveau de l'application. Lorsque vous migrez des applications, la configuration au niveau de l'application est préservée lors des processus d'export et d'import LCM. Toutefois, certaines configurations ne sont applicables qu'au serveur Essbase. La plupart de ces configurations de serveur que vous spécifiez lors de la configuration d'Essbase au cours du déploiement, mais vous pouvez également modifier les paramètres de configuration par défaut du serveur à l'aide de essbase.cfg, si nécessaire.

REMARQUES GÉNÉRALES

  • Types de données d'horodatage SQL importés

    Les types d'horodatage SQL précédemment affichés au format ODBC [yyyy-mm-dd hh:mm:ss] s'affichent désormais au format [dd-MON-yy hh.mm.ss.mmm a], dans l'éditeur de règles de l'interface WebEssbase et partout où ces types d'horodatage sont importés. Pour charger les horodatages au format de votre choix lors des chargements de données ou des constructions de dimension, vous pouvez convertir les horodatages au format de chaîne de votre choix à l'aide d'une fonction de conversion SQL dans la section des requêtes de la règle de chargement. L'exemple de requête SQL suivant emploie la fonction de format SELECT introdate, format(introdate, 'yyyy-MM-dd hh:mm:ss') FROM tbc.dbo.product

  • Mise à niveau des applications EPM - Calculs et filtres

    Une fois les applications mises à niveau vers Essbase 26ai, vous ne pouvez pas provisionner de membres vers des calculs ou des filtres à partir de la console EPM Shared Services. Vous devez utiliser l'interface Web Essbase pour affecter des membres. Voir : Affecter des filtres et Accès aux calculs.

  • Partitions

    Lorsque vous réalisez l'opération d'import LCM, importez les applications source avant les applications cible. Si vous n'importez pas les applications source avant les applications cible, la définition de partition ne fonctionnera pas. Vous devrez alors recréer la définition de partition après avoir importé des applications source.

    Après avoir annulé (rollback) un processus OPatch, vous devrez peut-être recréer des partitions transparentes et répliquées, puis valider à nouveau les partitions.

  • Options de création d'application autres que LCM

    En plus d'utiliser LCM pour migrer des applications exportées, vous pouvez également créer des applications comme suit :

    • Importer à l'aide de classeurs d'application Excel
    • Dans Smart View, utilisez l'extension du concepteur de cubes
    • Instruction MaxL de création d'application

  • Alias d'emplacement

    LCM ne prend pas en charge la migration des informations d'identification d'alias d'emplacement. Après avoir migré vos applications à partir d'Essbase 11g sur site, vous devez remplacer vos alias d'emplacement. Vous pouvez utiliser la méthode automatisée suivante ou une méthode manuelle à l'aide de MaxL.

    Méthode automatisée de remplacement des alias d'emplacement

    1. Décompressez le fichier ZIP exporté LCM.
    2. Accédez à {ApplicationName}\Databases{dbName}\Location Aliases.
    3. Ouvrez le fichier sous ce répertoire. Il s'agit d'un fichier au format XML, où le champ userName et le champ password sont vides. Vous pouvez fournir les informations d'identification.
    4. Compressez à nouveau le répertoire.
    5. Importez l'application à l'aide du répertoire zip.

      Fichier xml échantillon

      <?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éthode manuelle utilisant MaxL pour remplacer les alias d'emplacement

    Une autre méthode manuelle d'option utilise MaxL. Après avoir importé les applications source en exécutant le travail LCMImport de l'interface de ligne de commande, recréez les alias d'emplacement à l'aide de Créer un alias d'emplacement.

  • Fonctions et macros personnalisées

    FOR INDEPENDENT DEPLOYMENTS - Si vous disposez d'un fichier .jar personnalisé que vous utilisez pour des fonctions de calcul et des macros personnalisées, celles-ci ne sont pas migrées par l'utilitaire d'export LCM 11g. Vous devez les déplacer manuellement. Pour ce faire,

    1. Notez l'emplacement de vos variables <Essbase Path> et <Application directory> (ARBORPATH) dans Essbase 26ai. Si nécessaire, voir Emplacements d'environnement dans la plate-forme Essbase.

    2. Migrez les fonctions globales (au niveau du système) en copiant vos fichiers .jar à partir de <Essbase Path>/java/udf sur votre instance source vers <Essbase Path>/java/udf sur votre instance Essbase cible.

    3. Migrez les fonctions locales (au niveau de l'application) en copiant les fichiers .jar du répertoire d'application de votre instance source vers le répertoire d'application de votre instance Essbase cible. En d'autres termes, copiez les fichiers .jar de <ARBORPATH>/app/<app_name> sur votre serveur 11g vers <Application directory>/app/<app_name> sur votre serveur 26ai.

    4. Sur l'instance Essbase cible, ajoutez JVMMODULELOCATION à essbase.cfg, en fournissant comme argument le chemin d'accès à la bibliothèque JVM sur votre système.

  • URL du service client

    FOR INDEPENDENT DEPLOYMENTS - In Essbase 11g, Provider Services is the middle-tier data-source provider to Oracle Essbase for Java API, Smart View, and XML for Analysis (XMLA) clients.

    La fonctionnalité Provider Services est intégrée à WebLogic. Mettez à jour les URL client vers le format en cours.

    Clients Ancienne URL permettant de connecter Provider Services au client spécifié Nouvelle URL dans Essbase 26ai
    API 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
    XMLA (XML for Analysis) http://server_name:port/aps/XMLA http://server_name:port/essbase/xmla

  • Ordre de résolution de l'outline et mesures saisies activées

    POUR LES DÉPLOIEMENTS DE MARKETPLACE OCI - Après avoir migré une application Essbase du serveur sur site Essbase 11g vers Essbase déployé sur OCI via MARKETPLACE, vous devez activer les mesures typées dans l'outline avant de pouvoir modifier l'ordre de résolution de l'outline.

    Dans Essbase déployé sur OCI, la propriété d'outline Mesures typées activées est définie sur FALSE par défaut. Pour modifier l'ordre de résolution, la propriété Mesures typées activées doit d'abord être remplacée par TRUE. Pour modifier cette propriété, reportez-vous à A propos des mesures typées dans le Guide de l'administrateur de base de données pour Oracle Essbase.