On-Premise-Anwendung in Essbase 11g migrieren

Sie können Anwendungen aus den Versionen 11.1.2.3.0nn, 11.1.2.4.0nn, 11.1.2.4.5nn oder 12.2.1 mit dem LCM-Exportutility 11g exportieren und sie dann mit dem CLI-Utility in die Zielversion importieren. Beachten Sie, dass Sie LCMImport auch über die Registerkarte "Essbase-Jobs" ausführen können, um Anwendungen zu importieren.

Der Workflow, der von 11g migriert werden soll:

Download des 11g LCM-Exportutilitys: Klicken Sie auf der Essbase-Weboberfläche auf Konsole, blenden Sie die Befehlszeilentools ein, und Laden Sie das LCM-Exportutility für 11g herunter (EssbaseLCMUtility.zip). Das heruntergeladene Utility muss auf denselben Rechner wie die Essbase 11g On Premise- oder 12.2.1-Installation kopiert und ausgeführt werden, damit die Enterprise Performance Management-(EPM-)Rollen exportiert werden können.

Exportparameter festlegen: Wenn die Option –exportepmroles aktiviert ist, müssen Sie die folgenden Parameter festlegen, bevor Sie den LCM-Export ausführen.

Linux:

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

Windows:

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

11g LCM-Exportutility einrichten: Vor der Ausführung des Utilitys müssen Sie die Umgebungsvariablen EPM_ORACLE_HOME und EPM_ORACLE_INSTANCE im Shell-Terminal festlegen und exportieren. Diese Variablen müssen den Variablen entsprechen, die in der EPM 11g-Quellumgebung verwendet werden. Weitere Einzelheiten finden Sie unter Informationen zu Middleware Home, EPM Oracle Home und EPM Oracle-Instanz. Führen Sie außerdem in der entpackten heruntergeladenen Datei EssbaseLCM.bat (Windows) oder EssbaseLCM.sh (Linux) aus, je nachdem, auf welcher Plattform das Utility ausgeführt werden soll. Siehe auch Optionen des 11g LCM-Exportutilitys.
Prüfen Sie das /tmp-Verzeichnis: Möglicherweise müssen Sie den Speicherort des tmp-Verzeichnisses ändern. Wenn er voll ist, kann das 11g LCM-Exportutility fehlschlagen.
Export ausführen: Wenn Sie Nicht-Unicode-Blockspeicheranwendungen exportieren, verwenden Sie die Option -converttoutf8 im LCM-Exportbefehl. Wenn Sie Nicht-Unicode-Aggregatspeicheranwendungen exportieren, konvertieren Sie diese manuell mit den Schritten unter Nicht-Unicode-Aggregatspeicheranwendung in Unicode-Modus konvertieren.
LCM-Exportsyntax: Geben Sie an der Eingabeaufforderung die folgende Befehlssyntax ein, um eine oder mehrere Anwendungen in eine ZIP-Datei zu exportieren:
```
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]
```
Geben Sie die folgenden Optionen an:

-exportepmroles: (optional) Exportiert Enterprise Performance Management-(EPM-)Rollen

-include-server-level: (optional) Umfasst Artefakte auf Serverebene, wie Substitutionsvariablen auf Serverebene oder Rollen auf Serverebene

-generateartifactlist: (optional) Generiert Artefaktliste

Beispiel:
```
EssbaseLCM.sh export -server localhost:1423 -user admin -password password -application Sample -zipfile Sample.zip -include-server-level -exportepmroles -generateartifactlist
```
Dadurch werden zusätzliche Artefakte exportiert: Rollen auf Benutzer- und Gruppenserverebene, Rollen auf Anwendungsebene, Berechnungen und Filterzuordnungen.
Import ausführen: Um eine oder mehrere Anwendungen zu importieren, laden Sie die Datei .zip mit dem Essbase Befehlszeilenschnittstellen-Utility (CLI) in die Zielanwendung hoch.
Der CLI-Befehl lcmimport hat die folgende Syntax:
```
lcmImport [-verbose] -zipfilename filename [-overwrite] [-targetappName targetApplicationName][-include-server-level][-artifactlist artifactList][-restEncryPassword]
```
Siehe: LcmImport: Cube-Dateien wiederherstellen.
Wenn zwischen einer Quellanwendung oder -datenbank und einer Zielanwendung oder -datenbank Partitionen vorhanden sind, werden nur die Partitionen aus dem Ziel in das Dateiensystem exportiert. Wenn Partitionen zwischen den zu migrierenden Cubes vorhanden sind, müssen Sie die Datenquelle vor dem Datenziel importieren. Andernfalls könnten Partitionsdefinitionen nicht wiederhergestellt werden.

Rollen werden nur festgelegt, wenn die Benutzer in Oracle Identity Cloud Service verfügbar sind. Sie können die Standardrollenzuordnung überschreiben, indem Sie die Zuordnung in CSSMappings.xml ändern, die mit dem 11g LCM-Exportutility bereitgestellt wird.
Föderierte Partitionen werden nicht migriert. Daher müssen Sie die föderierte Partition löschen und in der neuen Umgebung neu erstellen, wenn Sie Ihre Anwendung an einen anderen Server oder eine andere Version verschieben. Siehe Federierte Cubes verwalten und Fehler beheben.
Upgradeversion der Aggregate Storage-Modellstruktur: Nach dem Import von Aggregate Storage-Anwendungen muss das Upgrade der Modellstruktur mit ESSCMDQ durchgeführt werden. Siehe Gliederungsversion für Aggregate Storage upgraden.
Validieren: Melden Sie Sie sich bei der Essbase-Weboberfläche an, um die Anwendung und den Cube auf der Seite Anwendungen anzuzeigen.