Essbase 11g On-Premiseアプリケーションの移行

11g LCMエクスポート・ユーティリティを使用して、バージョン11.1.2.3.0nn、11.1.2.4.5nnまたは12.2.1からアプリケーションをエクスポートし、CLIユーティリティを使用してターゲット・バージョンにインポートできます。LCMImportをEssbaseの「ジョブ」タブから実行して、アプリケーションをインポートすることもできます。

次に、11gから移行する場合のワークフローを示します。
  1. 11g LCMエクスポート・ユーティリティのダウンロード: Essbase Webインタフェースで、「コンソール」をクリックし、コマンド・ライン・ツールを展開して、11g LCMエクスポート・ユーティリティ(EssbaseLCMUtility.zip)をダウンロードします。Enterprise Performance Management (EPM)のロールをエクスポートするために、ダウンロードしたユーティリティをEssbase 11g On-Premiseまたは12.2.1のインストールと同じマシン上にコピーして実行する必要があります。
  2. エクスポート・パラメータの設定: –exportepmrolesオプションが有効な場合は、LCMエクスポートの実行前に、次のパラメータを設定する必要があります。
    • 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
  3. 11g LCMエクスポート・ユーティリティの設定: ユーティリティの実行前に、shellターミナルで環境変数EPM_ORACLE_HOMEとEPM_ORACLE_INSTANCEを設定してエクスポートする必要があります。これらの変数は、ソースのEPM 11g環境で使用していたものと同じにする必要があります。詳細については、ミドルウェア・ホーム、EPM OracleホームおよびEPM Oracleインスタンスについてを参照してください。また、解凍したダウンロード済ファイルで、ユーティリティを実行するプラットフォームに基づいてEssbaseLCM.bat (Windows)またはEssbaseLCM.sh (Linux)も実行します。11g LCMエクスポート・ユーティリティのオプションも参照してください。
  4. /tmpディレクトリを確認する: tmpディレクトリの場所を変更する必要がある場合があります。満杯の場合、11g LCMエクスポート・ユーティリティが失敗することがあります。
  5. エクスポートの実行: 非Unicodeのブロック・ストレージ・アプリケーションをエクスポートする場合は、LCMのエクスポート・コマンドで-converttoutf8オプションを使用します。非Unicodeの集約ストレージ・アプリケーションをエクスポートする場合は、非Unicode集約ストレージ・アプリケーションのUnicodeモードへの変換に関する項のステップを使用して手動で変換します。
    LCMのエクスポート構文: コマンド・プロンプトで次のコマンド構文を入力して、1つ以上のアプリケーションを.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]

    次のオプションを指定します。

    -exportepmroles: (オプション) Enterprise Performance Management (EPM)のロールをエクスポートします。

    -include-server-level: (オプション)サーバー・レベルの置換変数またはサーバー・レベルのロールといった、サーバー・レベルのアーティファクトを含めます

    -generateartifactlist: (オプション)アーティファクトのリストを生成します。

    たとえば:

    EssbaseLCM.sh export -server localhost:1423 -user admin -password password -application Sample -zipfile Sample.zip -include-server-level -exportepmroles -generateartifactlist

    これにより、追加のアーティファクト(ユーザーとグループのサーバーレベルのロール、アプリケーションレベルのロール、計算、フィルタ・アソシエーション)がエクスポートされます。

  6. インポートの実行: 1つ以上のアプリケーションをインポートするには、Essbase コマンドライン・インタフェース・ユーティリティ(CLI)を使用して、.zipファイルをターゲット・アプリケーションにアップロードします。
    CLI lcmimportコマンドの構文は次のとおりです。 
    lcmImport [-verbose] -zipfilename filename [-overwrite] [-targetappName targetApplicationName][-include-server-level][-artifactlist artifactList][-restEncryPassword]
    LcmImport: キューブ・ファイルの復元を参照してください。
    ソース・アプリケーションまたはデータベースと、ターゲット・アプリケーションまたはデータベースとの間でソースにパーティションが存在する場合、ターゲットからのパーティションのみがファイル・システムにエクスポートされます。移行されるキューブ間にパーティションが存在する場合は、データ・ターゲットの前にデータ・ソースをインポートする必要があります。そうしないと、パーティション定義がリストアされない可能性があります。
    ロールは、ユーザーがOracle Identity Cloud Serviceで使用可能な場合にのみ設定されます。デフォルトのロール・マッピングは、11g LCMエクスポート・ユーティリティに付属のCSSMappings.xmlでマッピングを変更することで上書きできます。
  7. フェデレーテッド・パーティションは移行されないため、アプリケーションおよびキューブを別のサーバーまたはバージョンに移動する場合、フェデレーテッド・パーティションを削除して新しい環境で再作成する必要があります。「フェデレーテッド・キューブのメンテナンスおよびトラブルシューティング」を参照してください。
  8. 集約ストレージのアウトライン・バージョンのアップグレード: 集約ストレージ・アプリケーションをインポートしたら、ESSCMDQを使用してアウトラインをアップグレードする必要があります。集約ストレージ・アウトライン・バージョンのアップグレードを参照してください。
  9. 確認: Essbase Webインタフェースにログインし、「アプリケーション」ページでアプリケーションとキューブを確認します。