Migration d'une application Essbase 11g sur site

Vous pouvez exporter des applications à partir des versions 11.1.2.3.0nn, 11.1.2.4.0nn, 11.1.2.4.5nn ou 12.2.1, à l'aide de l'utilitaire d'export LCM 11g, puis les importer vers la version cible à l'aide de l'utilitaire CLI. Vous pouvez également exécuter LCMImport à partir de l'onglet Travaux Essbase pour importer des applications.

Workflow à migrer à partir de la version 11g :

Téléchargez l'utilitaire d'export LCM 11g : dans l'interface Web Essbase, cliquez sur Console, développez les outils de ligne de commande, puis téléchargez l'utilitaire d'export LCM 11g (EssbaseLCMUtility.zip). L'utilitaire téléchargé doit être copié et exécuté sur le même ordinateur que l'installation Essbase 11g sur site ou 12.2.1, pour que les rôles Enterprise Performance Management (EPM) puissent être exportés.

Définir les paramètres d'export : si l'option –exportepmroles est activée, vous devez définir les paramètres suivants avant d'exécuter l'export LCM.

Pour Linux :

export EPM_ORACLE_HOME=/scratch/Oracle/Middleware/EPMSystem11R1
export EPM_ORACLE_INSTANCE=/scratch/Oracle/Middleware/user_projects/epmsystem1

Pour Windows :

set EPM_ORACLE_HOME=C:\Oracle\Middleware\EPMSystem11R1
set EPM_ORACLE_INSTANCE=C:\Oracle\Middleware\user_projects\epmsystem1

Configurer l'utilitaire d'export LCM 11g : avant d'exécuter l'utilitaire, vous devez définir et exporter les variables d'environnement EPM_ORACLE_HOME et EPM_ORACLE_INSTANCE dans le terminal shell. Ces variables doivent être identiques à celles utilisées dans l'environnement EPM 11g source. Pour plus de détails, reportez-vous à la section A propos du répertoire de base Middleware, du répertoire de base Oracle EPM et de l'instance Oracle EPM. Par ailleurs, dans le fichier téléchargé décompressé, exécutez EssbaseLCM.bat (Windows) ou EssbaseLCM.sh (Linux) en fonction de la plate-forme sur laquelle vous souhaitez exécuter l'utilitaire. Reportez-vous également à Options de l'utilitaire d'export LCM 11g.
Vérifiez le répertoire /tmp : vous devrez peut-être modifier l'emplacement du répertoire tmp. S'il est plein, l'utilitaire d'exportation LCM 11g peut échouer.
Exécuter l'export : lorsque vous exportez des applications en mode "block storage" non Unicode, utilisez l'option -converttoutf8 dans la commande d'export LCM. Lorsque vous exportez des applications en mode "aggregate storage" non Unicode, convertissez-les manuellement en suivant les étapes décrites dans la section Conversion d'applications en mode "aggregate storage" non Unicode.
Syntaxe d'export LCM : à l'invite de commande, entrez la syntaxe de commande suivante pour exporter une ou plusieurs applications vers un fichier .zip :
```
EssbaseLCM.bat|.sh export -server essbasehost:port -user username -password password -application
      appname -zipfile zipfilename [-nodata] [-include-server-level] [-converttoutf8] [-forceutf8]
      [-generateartifactlist] [-exportepmroles] [-allApp] [-exportdata]
          [-cube] [-filetype] [-partitions] [-filters]
```
Spécifiez les options suivantes :

-exportepmroles : (facultatif) exporte les rôles EPM (Enterprise Performance Management).

-include-server-level : (facultatif) inclut les artefacts de niveau serveur, tels que les variables de substitution au niveau serveur ou les rôles de niveau serveur.

-generateartifactlist : (facultatif) génère une liste d'artefacts

Exemple :
```
EssbaseLCM.sh export -server localhost:1423 -user admin -password password -application Sample -zipfile Sample.zip -include-server-level -exportepmroles -generateartifactlist
```
Cela permet d'exporter des artefacts supplémentaires : les rôles de niveau serveur d'utilisateur et de groupe, les rôles de niveau application, les calculs et les associations de filtres.
Exécuter l'import : pour importer une ou plusieurs applications, utilisez l'utilitaire d'interface de ligne de commande Essbase (CLI) pour télécharger le fichier .zip vers l'application cible.
La syntaxe de la commande lcmimport de la CLI est la suivante :
```
lcmImport [-verbose] -zipfilename filename [-overwrite] [-targetappName targetApplicationName][-include-server-level][-artifactlist artifactList][-restEncryPassword]
```
Voir : LcmImport : Restaurer des fichiers de cube.
Lorsque des partitions sont présentes dans la source entre une base de données ou une application source, et une base de données ou une application cible, seules les partitions de la cible sont exportées dans le système de fichiers. Lorsque des partitions sont présentes entre les cubes à migrer, vous devez importer la source de données avant la cible de données. Sinon, les définitions de partition risquent de ne pas pouvoir être restaurées.

Les rôles sont définis uniquement si les utilisateurs sont disponibles dans Oracle Identity Cloud Service. Vous pouvez remplacer le mappage des rôles par défaut en modifiant le mappage dans CSSMappings.xml fourni avec l'utilitaire d'export LCM 11g.
Les partitions fédérées ne sont pas migrées. Par conséquent, lorsque vous déplacez votre application et votre cube vers un autre serveur ou une nouvelle version, vous devez supprimer la partition fédérée et le recréer dans le nouvel environnement. Reportez-vous à Maintenance et dépannage des cubes fédérés.
Mettre à niveau la version de l'outline en mode "aggregate storage" : une fois les applications en mode "aggregate storage" importées, l'outline doit être mise à niveau à l'aide d'ESSCMDQ. Reportez-vous à Mise à niveau de la version d'outline Aggregate Storage.
Valider : connectez-vous à l'interface Web Essbase pour afficher l'application et les cubes sur la page d'Applications.