Migration von Essbase 11g On Premise vorbereiten

Wenn eine vorhandene Essbase 11g On-Premise-Anwendung und ein Cube in Essbase 26ai migriert werden sollen, berücksichtigen Sie die folgenden Aspekte und Voraussetzungen.

Unterschiede zwischen Essbase 11g On Premise und Essbase 26ai

Taskflow für Migration

Hinweis:

  • Wenn Sie EPM Shared Services in Essbase 11g On-Premise verwendet haben, um einen externen Sicherheitsprovider zu konfigurieren, ist Schritt 1 unten nicht erforderlich. Je nach dem bei der Konfiguration ausgewählten Sicherheitsmodus müssen Sie möglicherweise die EPM-Zielinstanz oder WebLogic so konfigurieren, dass derselbe externe Sicherheitsprovider wie in Essbase 11g On Premise verwendet wird.

  • Wenn Sie Oracle Identity Cloud Service verwenden, konfigurieren Sie es so, dass es denselben externen Sicherheitsprovider verwendet, der in Essbase 11g On Premise verwendet wird.

  1. Migrieren Sie Benutzer und Gruppen von EPM Shared Services-Quell-Essbase 11g On Premise zu OCI Identity and Access Management (IAM) oder Oracle Identity Cloud Service (IDCS) (für OCI-Deployment) oder EPM Shared Services/WebLogic LDAP (für unabhängige Deployments). Siehe Essbase 11g-Benutzer und -Gruppen migrieren.

  2. Wenn Sie Nicht-Unicode-Essbase 11g On-Premise-Anwendungen exportieren, müssen Sie die Anwendungen in Unicode konvertieren.

    1. Verwenden Sie System ändern auf dem Server und dann auf einer Backupkopie der Essbase-Anwendung, bevor Sie das 11g LCM-Exportutility ausführen, um Essbase selbst zu aktivieren, dass die Unicode-Anwendung unterstützt wird.

    2. Bei Nicht-Unicode-Speicheranwendungen können Sie die Anwendung mit der Option -converttoutf8 im Exportbefehl blockieren. Siehe 11g LCM-Exportutilityoptionen.

      Befolgen Sie für Nicht-Unicode-Speicheranwendungen für Aggregate die manuellen Unicode-Konvertierungsanweisungen unter Nicht-Unicode-Aggregatspeicheranwendung in Unicode-Modus konvertieren.

  3. 11g-Anwendungen migrieren:

    1. Exportieren Sie Essbase-Anwendungen mit dem 11g LCM-Exportutility, das von der Essbase 26ai-Zielinstanz heruntergeladen wurde, und führen Sie das Utility auf dem Computer aus, auf dem Essbase 11g On Premise installiert ist.

      Hinweis:

      Um das 11g LCM-Exportutility verwenden zu können, muss Java Development Kit (JDK) 8 oder höher installiert sein. Die folgenden Variablen müssen festgelegt werden: JAVA_HOME-Umgebungsvariable und EPM_ORACLE_HOME- und EPM_ORACLE_INSTANCE-Variablen im Shell-Terminal.

    2. Importieren Sie Essbase-Anwendungen mit dem Essbase Befehlszeilenschnittstelle-(CLI-)Utility, das von der Essbase 26ai-Instanz heruntergeladen wurde. Führen Sie das Utility für jede exportierte ZIP-Datei aus.

Unterstützte Essbase-Versionen und -Pfade

Die folgenden Releases wurden auf Migration getestet: 11.1.2.3.0nn, 11.1.2.4.0nn, 12.2.1 und höher.

Hinweis:

Die Migration von 11.1.2.3 wird unterstützt. Es kann jedoch nicht jede Anwendung von 11.1.2.3 auf 26ai migriert werden. Wir empfehlen ein Upgrade von 11.1.2.3.0.n.n auf 11.1.2.4.0.n.n, bevor Sie die Migration zu 26ai versuchen.

Die folgenden Migrationspfade werden nicht unterstützt:
  • Essbase 19c oder 26ai auf OCI (Marketplace-Deployment) in Essbase 26ai unter Windows (unabhängiges Deployment)
  • Essbase 26ai unter Linux (unabhängiges Deployment) in Essbase 26ai unter Windows (unabhängiges Deployment)

Migrierte 11g-Artefakte

Prüfen Sie die 11g-Artefakte, die für die Migration unterstützt werden. Siehe Migrierte Artefakte.

Nicht unterstützte Anwendungs- und Datenbankeinstellungen

Die folgenden Einstellungen auf Anwendungs- oder Datenbankebene werden bei der Migration nicht unterstützt: Datenträger-Volumes.

KONFIGURATIONSHINWEISE

  • Hybridmodus

    Der Standardberechnungs- und Abfrageprozessor ist Hybridmodus. Im Hybridmodus können Block Storage Cubes über dynamische Sparse-Elemente der obersten Ebene verfügen und vollständig dynamische Abfragen und Berechnungen ermöglichen. Sie können Daten sofort nach deren Aktualisierung abfragen, ohne Batchberechnungen auszuführen. Wenn Sie im Hybridmodus keine dynamischen Berechnungen auf Sparse-Elemente in der oberen Ebene anwenden, hat das keine Auswirkungen auf Ihre Cubes. Hinweis: Der Hybridmodus ist nicht der Standardmodus, wenn Berechnungsskripte verwendet werden. Wenn Ihre Berechnungsskripte viele Sparse-Abhängigkeiten enthalten, sollten Sie auch den Hybridmodus für Berechnungsskripte aktivieren.

  • Implied Sharing

    Wenn Sie die Konfigurationseinstellung IMPLIED_SHARE in Ihrer Essbase 11g On-Premise-Anwendung verwenden, wird Ihre implizite Freigabeeinstellung migriert, um eine minimale Unterbrechung zu vermeiden. Weitere Informationen zu impliziten Freigabestandards in Essbase 26ai finden Sie im Konfigurationsthema IMPLIED_SHARE_ON_CREATE.

  • Warnung bezüglich der Einstellung UPPERCASECONNECTION esssql.cfg

    Wenn Ihre Umgebung eine esssql.cfg-Datei mit der nicht mehr unterstützten UPPERCASECONNECTION-Einstellung enthält, erhalten Sie möglicherweise eine Warnung wie die folgende beim Ausführen von Dataload-Vorgängen:

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

    Die Möglichkeit, dies zu beheben, besteht darin, die UPPERCASECONNECTION-Einstellung manuell aus esssql.cfg zu entfernen, die sich in 

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

    und starten Sie dann die Essbase-Server neu.

  • Text- und Datumskennzahlen
    Ab Essbase 21.3 und höher ist die Konfiguration ALLOWOUTOFRANGELOAD veraltet, und das Verhalten ist mit "ALLOWOUTOFRANGELOAD TRUE" in früheren Versionen identisch. Außerhalb des Bereichs und fehlende Werte typisierter Kennzahlen werden in Cubes mit Textkennzahlen geladen und daraus exportiert. Im folgenden Beispiel für eine Datenexportdatei sind <OutOfRange_Name> ungültig und "NoColor" für fehlende Werte.
    "Color1" "Color2"
"Shoes" "Massachusetts" "Q1" "#Txt:NoColor" "#Txt:Yellow"
"Q2" "#Txt:Green"
"Connecticut" "Q1" "#Txt:Green" "#Txt:Invalid"
    Informationen zum Laden von Werten außerhalb des gültigen Bereichs finden Sie unter Text- und Datumskennzahlen laden, löschen und exportieren.

  • Konfigurationseinstellungen

    Einige Standardkonfigurationswerte unterscheiden sich von denen in Essbase 11g On-Premise. Prüfen Sie die Konfigurationsreferenz.

    Die Einstellungen INDEXCACHESIZE und DATACACHESIZE steuern jetzt die Cachegrößen für alle Essbase-Cubes (mit Ausnahme von Aggregate Storage-Cubes). Diese Einstellungen wirkten sich zuvor nur auf neu erstellte oder migrierte Cubes aus.

    Um die Standardwerte für Konfigurationseinstellungen auf Anwendungsebene zu ändern, verwenden Sie die Essbase-Weboberfläche.

    Oracle empfiehlt, die meisten Konfigurationen auf Anwendungsebene zu verwalten. Wenn Sie Anwendungen migrieren, wird die Konfiguration auf Anwendungsebene während der LCM-Export- und -Importprozesse beibehalten. Einige Konfigurationen sind jedoch nur auf den Essbase-Server anwendbar. Die meisten dieser Serverkonfigurationen, die Sie beim Konfigurieren von Essbase während des Deployments angeben. Sie können jedoch bei Bedarf auch Serverkonfigurationsstandardwerte mit essbase.cfg ändern.

ALLGEMEINE HINWEISE

  • Importierte SQL-Zeitstempeldatentypen

    SQL-Zeitstempeldatentypen, die zuvor im ODBC-Format [yyyy-mm-dd hh:mm:ss] angezeigt wurden, können jetzt in einem anderen Format angezeigt werden [dd-MON-yy hh.mm.ss.mmm a], sowohl im Regeleditor der Essbase-Weboberfläche als auch an allen anderen Orten, an denen Zeitstempeldatentypen importiert werden. Um Zeitstempel in einem Format Ihrer Wahl bei Dataloads oder Dimensionserstellungen zu laden, können Sie Zeitstempel mit einer SQL-Konvertierungsfunktion im Abfrageabschnitt der Laderegel in Ihr bevorzugtes Zeichenfolgenformat konvertieren. Das folgende SQL-Abfragebeispiel verwendet die Formatfunktion: SELECT introdate, format(introdate, 'yyyy-MM-dd hh:mm:ss') FROM tbc.dbo.product

  • EPM-Anwendungen upgraden – Berechnungen und Filter

    Nach dem Upgrade von Anwendungen auf Essbase 26ai können Sie keine Elemente für Berechnungen oder Filter über die EPM Shared Services-Konsole bereitstellen. Sie müssen die Essbase-Weboberfläche verwenden, um Elemente zuzuweisen. Weitere Informationen finden Sie unter Filter zuweisen und Zugriff auf Berechnungen.

  • Partitionen

    Importieren Sie beim LCM-Import die Quellanwendungen vor den Zielanwendungen. Wenn Sie die Quellanwendungen nicht vor den Zielanwendungen importieren, funktioniert die Partitionsdefinition nicht. In diesem Fall müssen Sie die Partitionsdefinition nach dem Importieren der Quellanwendungen neu erstellen.

    Nach dem Rollback eines OPatch müssen Sie möglicherweise transparente und replizierte Partitionen neu erstellen und die Partitionen erneut validieren.

  • Optionen zur Anwendungserstellung neben dem LCM-Utility

    Neben der Verwendung des LCM-Utilitys für die Migration von exportieren Anwendungen können Sie Anwendungen auch wie folgt erstellen:

    • Mit Excel-Anwendungsarbeitsmappen importieren
    • In Smart View mit der Cube Designer-Erweiterung
    • MaxL-Anweisung create application

  • Speicherort-Aliasnamen

    LCM unterstützt die Migration von Standortaliaszugangsdaten nicht. Nachdem Sie Ihre Anwendungen von Essbase 11g On-Premise migriert haben, müssen Sie Ihre Standortaliasnamen ersetzen. Sie können die folgende automatisierte Methode oder eine manuelle Methode mit MaxL verwenden.

    Automatisierte Methode zum Ersetzen von Standort-Aliasnamen

    1. Dekomprimieren Sie die exportierte LCM-ZIP.
    2. Gehen Sie zu den Aliasnamen {ApplicationName}\Databases{dbName}\Location.
    3. Öffnen Sie die Datei unter diesem Verzeichnis. Dies ist eine XML-Formatdatei, in der das Feld "userName" und "Kennwort" leer sind. Sie können die Zugangsdaten angeben.
    4. Zip das Verzeichnis erneut.
    5. Importieren Sie die Anwendung mit dem ZIP-Verzeichnis.

      XML-Beispieldatei

      <?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>

    Manuelle Methode, mit der MaxL Standortaliasnamen ersetzt werden

    Bei einer manuellen alternativen Option wird MaxL verwendet. Nachdem Sie Quellanwendungen importiert haben, indem Sie den CLI-LCMImportjob ausführen, erstellen Sie Standortaliasnamen mit Speicherortalias erstellen neu.

  • Benutzerdefinierte Funktionen und Makros

    FOR INDEPENDENT DEPLOYMENTS - Wenn Sie eine benutzerdefinierte .jar-Datei haben, die Sie für benutzerdefinierte Berechnungsfunktionen und Makros verwenden, werden diese nicht vom 11g LCM-Exportutility migriert. Sie müssen sie manuell verschieben. Um dies zu tun,

    1. Notieren Sie sich den Speicherort von <Essbase Path> und <Application directory> (ARBORPATH) in Essbase 26ai. Informationen hierzu finden Sie bei Bedarf unter Umgebungsspeicherorte in der Essbase-Plattform.

    2. Migrieren Sie globale Funktionen (auf Systemebene), indem Sie die .jar-Dateien aus <Essbase Path>/java/udf auf der Quellinstanz in <Essbase Path>/java/udf auf der Essbase-Zielinstanz kopieren.

    3. Migrieren Sie lokale Funktionen (auf Anwendungsebene), indem Sie die .jar-Dateien aus dem Anwendungsverzeichnis der Quellinstanz in das Anwendungsverzeichnis der Essbase-Zielinstanz kopieren. Mit anderen Worten, kopieren Sie die .jar-Dateien von <ARBORPATH>/app/<app_name> auf Ihrem 11g-Server nach <Application directory>/app/<app_name> auf Ihrem 26ai-Server.

    4. Fügen Sie auf der Essbase-Zielinstanz JVMMODULELOCATION zu essbase.cfg hinzu, und geben Sie als Argument den Pfad zur JVM-Library auf dem System an.

  • Clientservice-URLs

    FOR INDEPENDENT DEPLOYMENTS - Für Essbase 11g ist Provider Services der Middle-Tier-Datenquellenprovider von Oracle Essbase für Java API-, Smart View- und XML FOR Analysis-(XMLA-)Clients.

    Die Provider Services-Funktionalität ist in WebLogic integriert. Aktualisieren Sie die Client-URLs auf das aktuelle Format.

    Clients Frühere URL zum Verbinden von Provider Services mit dem angegebenen Client Neue URL in Essbase 26ai
    Java-API 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 für Analyse (XMLA) http://server_name:port/aps/XMLA http://server_name:port/essbase/xmla

  • Modellstruktur - Lösungsreihenfolge und aktivierte Kennzahlen

    FOR OCI MARKETPLACE DEPLOYMENTS - Nachdem Sie eine Essbase-Anwendung über MARKETPLACE vom Essbase 11g-On-Premise-Server zu Essbase migriert haben, das auf OCI bereitgestellt ist, müssen Sie eingegebene Kennzahlen in der Gliederung aktivieren, bevor Sie die Gliederungslösungsreihenfolge ändern können.

    In Essbase, das auf OCI bereitgestellt wird, ist die Outline-Eigenschaft Typed Measures Enabled standardmäßig auf FALSE gesetzt. Um die Lösungsreihenfolge zu ändern, muss zuerst die Eigenschaft "Typed Measures Enabled" in TRUE geändert werden. Informationen zum Ändern dieser Eigenschaft finden Sie unter Informationen zu eingegebenen Kennzahlen in der Dokumentation Database Administrator's Guide for Oracle Essbase.