Eseguire la migrazione di un'applicazione Essbase 11g in locale

È possibile esportare le applicazioni dalle versioni 11.1.2.3.0nn, 11.1.2.4.0nn, 11.1.2.4.5nn o 12.2.1, utilizzando la utility di esportazione LCM 11g, quindi importarle nella versione di destinazione utilizzando la utility CLI. Si noti che è anche possibile eseguire LCMImport dalla scheda Job di Essbase per importare le applicazioni.

Flusso di lavoro per la migrazione da 11g:

Scaricare l'utility di esportazione LCM 11g: nell'interfaccia Web Essbase, fare clic su Console, espandere Strumenti di linea di comando e scaricare l'utility di esportazione LCM 11g (EssbaseLCMUtility.zip). La utility scaricata deve essere copiata ed eseguita sullo stesso computer dell'installazione Essbase 11g in locale o 12.2.1, affinché i ruoli di Enterprise Performance Management (EPM) possano essere esportati.

Imposta parametri di esportazione: se l'opzione –exportepmroles è abilitata, è necessario impostare i seguenti parametri prima di eseguire l'esportazione LCM.

Per Linux:

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

Per Windows:

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

Impostare la utility di esportazione LCM 11g: prima di eseguire la utility, è necessario impostare ed esportare le variabili di ambiente EPM_ORACLE_HOME ed EPM_ORACLE_INSTANCE nel terminale della shell. Queste variabili devono essere uguali a quelle utilizzate nell'ambiente EPM 11g di origine. Per informazioni dettagliate, vedere Informazioni sulla home Middleware, sulla Oracle home EPM e sull'istanza Oracle EPM. Inoltre, nel file scaricato non compresso, eseguire EssbaseLCM.bat (Windows) o EssbaseLCM.sh (Linux), a seconda della piattaforma su cui si desidera eseguire la utility. Vedere anche 11g LCM Export Utility Options.
Verificare la directory /tmp: potrebbe essere necessario modificare la posizione della directory tmp. Se è piena, è possibile che la utility di esportazione LCM 11g non riesca.
Eseguire l'esportazione: quando si esportano applicazioni di memorizzazione a blocchi non Unicode, utilizzare l'opzione -converttoutf8 nel comando di esportazione LCM. Quando si esportano applicazioni di memorizzazione di aggregazione non Unicode, convertirle manualmente utilizzando la procedura descritta in Converti applicazione di memorizzazione di aggregazione non Unicode in modalità Unicode.
Sintassi di esportazione LCM: al prompt dei comandi, immettere la seguente sintassi dei comandi per esportare una o più applicazioni in un file .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]
```
Specificare una delle opzioni seguenti:

-exportepmroles: (facoltativo) esporta i ruoli di Enterprise Performance Management (EPM)

-include-server-level: (facoltativo) include artifact a livello di server, ad esempio variabili di sostituzione a livello di server o ruoli a livello di server

-generateartifactlist: (facoltativo) genera la lista di artifact

Ad esempio:
```
EssbaseLCM.sh export -server localhost:1423 -user admin -password password -application Sample -zipfile Sample.zip -include-server-level -exportepmroles -generateartifactlist
```
Vengono esportati artifact aggiuntivi: ruoli a livello di server utente e gruppo, ruoli a livello di applicazione, calcoli e associazioni di filtri.
Eseguire l'importazione: per importare una o più applicazioni, utilizzare la utility CLI (Command Line Interface) di Essbase per caricare il file .zip nell'applicazione target.
La sintassi del comando CLI lcmimport è la seguente:
```
lcmImport [-verbose] -zipfilename filename [-overwrite] [-targetappName targetApplicationName][-include-server-level][-artifactlist artifactList][-restEncryPassword]
```
Vedere: LcmImport: Ripristina file di cubo.
Quando esistono partizioni nell'origine tra un'applicazione o un database di origine e un'applicazione o un database di destinazione, vengono esportate nel file system solo le partizioni dalla destinazione. Quando esistono partizioni tra i cubi in fase di migrazione, è necessario importare l'origine dati prima della destinazione dati. In caso contrario, le definizioni delle partizioni potrebbero non essere ripristinate.

I ruoli vengono impostati solo se gli utenti sono disponibili in Oracle Identity Cloud Service. È possibile eseguire l'override del mapping dei ruoli predefinito modificando il mapping in CSSMappings.xml fornito con la utility di esportazione LCM 11g.
Le partizioni federate non vengono sottoposte a migrazione, pertanto quando si sposta l'applicazione e il cubo in un altro server o se ne esegue la versione, è necessario eliminare la partizione federata e ricrearla nel nuovo ambiente. Fare riferimento alla sezione Gestione e risoluzione dei problemi del cubo federato.
Aggiornare la versione del profilo di memorizzazione di aggregazione: dopo l'importazione delle applicazioni di memorizzazione di aggregazione, il profilo deve essere aggiornato mediante ESSCMDQ. Fare riferimento alla sezione Aggiornamento della versione del profilo della memorizzazione di aggregazione.
Convalidare: eseguire il login all'interfaccia Web Essbase per visualizzare l'applicazione e il cubo nella pagina Applicazioni.