Essbase 11g On-Premiseからの移行の準備

既存のEssbase 11g On-PremiseアプリケーションとキューブをEssbase 21cに移行する場合は、次の考慮事項と前提条件を確認してください。

Essbase 11g On-PremiseとEssbase 21cとの違い

Essbase 21cでは、型付きメジャーを持つキューブに対するフリーフォーム・データのエクスポートおよびインポートは、動作が異なります。最新の情報は、テキストおよびデータのメジャーのロード、クリーニングおよびエクスポートに関する項を参照してください。
移行する前に、Essbase 11gとEssbase 21cとの違いを確認します。

移行のタスク・フロー

ノート:

Essbase 11g On-Premiseで外部セキュリティ・プロバイダを構成するためにEPM Shared Servicesを使用していた場合は、次のステップ1は不要です。構成時に選択したセキュリティ・モードに基づき、Essbase 11g On-Premiseで使用されているのと同じ外部セキュリティ・プロバイダを使用するようにターゲットのEPMインストールまたはWebLogicを構成する必要が生じる場合があります。
Oracle Identity Cloud Serviceを使用する場合は、Essbase 11g On-Premiseで使用していたものと同じ外部セキュリティ・プロバイダを使用するように構成します。

ソースのEssbase 11g On-Premise EPM Shared Servicesから、OCI Identity and Access Management (IAM)またはOracle Identity Cloud Service (IDCS) (OCIデプロイメント用)またはEPM Shared Services/WebLogic LDAP (独立デプロイメント用)に、ユーザーおよびグループを移行します。「Essbase 11gのユーザーとグループの移行」を参照してください。
非UnicodeのEssbase 11g On-Premiseアプリケーションを移行する場合は、そのアプリケーションをUnicodeに変換する必要があります。
1. 11g LCMエクスポート・ユーティリティを実行する前に、サーバー、Essbaseアプリケーションのバックアップ・コピーの順にAlter Systemを使用して、Essbase自体がUnicodeアプリケーションをサポートできるようにします。
2. Unicode以外のブロック・ストレージ・アプリケーションの場合は、エクスポート・コマンドで-converttoutf8オプションを使用してアプリケーションをエクスポートします。「11g LCMエクスポート・ユーティリティのオプション」を参照してください。
  
  非Unicodeの集約ストレージ・アプリケーションの場合は、「非Unicode集約ストレージ・アプリケーションのUnicodeモードへの変換」の手動でのUnicode変換の手順に従ってください。
11gアプリケーションを移行します:
1. ターゲットのEssbase 21cインスタンスからダウンロードした11g LCMエクスポート・ユーティリティを使用してEssbaseアプリケーションをエクスポートし、Essbase 11g On-Premiseがインストールされているコンピュータでユーティリティを実行します。
  
  ノート:
  11g LCMエクスポート・ユーティリティを使用するには、Java Development Kit (JDK) 8以降がインストールされている必要があります。また、JAVA_HOME環境変数、shellターミナルのEPM_ORACLE_HOME変数とEPM_ORACLE_INSTANCE変数が設定されている必要があります。
2. Essbase 21cインスタンスからダウンロードしたEssbaseのコマンドライン・インタフェース(CLI)を使用して、Essbaseアプリケーションをインポートします。このユーティリティは、エクスポートしたzipファイルごとに実行します。

サポートされているEssbaseのバージョンとパス

移行がテスト済のリリースは、11.1.2.3.0nn、11.1.2.4.0nn、12.2.1以降です。

ノート:

11.1.2.3からの移行はサポートされていますが、すべてのアプリケーションを11.1.2.3から21cに移行できるわけではありません。21cへの移行を試す前に、11.1.2.3.0.n.nから11.1.2.4.0.n.nにアップグレードすることをお薦めします。

次の移行パスはサポートされていません。

Oracle Analytics Cloud - EssbaseからWindows上のEssbase 21c (独立デプロイメント)
OCI上のEssbase 19cまたは21c (Marketplaceデプロイメント)からWindows上のEssbase 21c (独立デプロイメント)
Linux上のEssbase 21c (独立デプロイメント)からWindows上のEssbase 21c (独立デプロイメント)

移行される11gのアーティファクト

移行についてサポートされる11gアーティファクトを確認します。「移行される21cのアーティファクト」を参照してください。

サポートされていないアプリケーションおよびデータベース設定

次のアプリケーションレベルの設定とデータベースレベルの設定は、移行でサポートされていません: ディスク・ボリューム。

構成についてのノート

ハイブリッド・モード

デフォルトの計算および問合せプロセッサは、ハイブリッド・モードです。ハイブリッド・モードでは、ブロック・ストレージ・キューブが上位レベルの動的疎メンバー、および完全な動的問合せと計算を含むことができます。更新後に、バッチ計算を実行しないで即座にデータを問い合せることができます。ハイブリッド・モードでは、動的計算を上位レベルの疎メンバーに適用しないことにした場合、キューブへの影響はありません。注意: 計算スクリプトを使用している場合、ハイブリッド・モードはデフォルトではありません。計算スクリプトに多数のスパース依存関係が含まれている場合は、計算スクリプトでもハイブリッド・モードを有効にすることを検討してください。
暗黙の共有

Essbase 11g On-PremiseアプリケーションでIMPLIED_SHARE構成設定を使用している場合は、混乱を最小限に抑えるため、ご使用の暗黙共有設定が移行されます。Essbase 21cでの暗黙の共有のデフォルト値について詳しくは、IMPLIED_SHARE_ON_CREATEの構成のトピックを参照してください。
UPPERCASECONNECTION esssql.cfg設定に関する警告
サポートされなくなったUPPERCASECONNECTION設定を含むesssql.cfgファイルが環境にある場合、データ・ロード操作の実行中に次のような警告が表示されることがあります:

警告 – 1021037 - SQL構成ファイルの構文エラー[UpperCaseConnection]です。無視されました。

これを修正するには、次の場所にあるesssql.cfgからUPPERCASECONNECTION設定を手動で削除します
```
<DOMAIN_HOME>/config/fmwconfig/essconfig/essbase/esssql.cfg
```
次に、Essbaseサーバーを再起動します。
テキスト・メジャーおよび日付メジャー
Essbase 21.3以降では、構成ALLOWOUTOFRANGELOADは非推奨になり、以前のバージョンでは動作が"ALLOWOUTOFRANGELOAD TRUE"と同じになります。型付きメジャーの範囲外および欠落した値は、テキスト・メジャーを持つキューブにロードされ、そこからエクスポートされます。次のデータ・エクスポート・ファイルの例では、欠落値の<OutOfRange_Name>は" Invalid"および"NoColor"です。
```
"Color1" "Color2"
"Shoes" "Massachusetts" "Q1" "#Txt:NoColor" "#Txt:Yellow"
"Q2" "#Txt:Green"
"Connecticut" "Q1" "#Txt:Green" "#Txt:Invalid"
```
範囲外の値のロードの詳細は、テキストおよび日付メジャーのロード、クリーニングおよびエクスポートを参照してください。
構成設定

一部のデフォルト構成値は、Essbase 11g On-Premiseでの値と異なります。構成リファレンスを確認してください。

INDEXCACHESIZEおよびDATACACHESIZEの設定は、すべてのEssbaseキューブ(集約ストレージ・キューブを除く)のキャッシュ・サイズを制御するようになりました。以前は、これらの設定では、新規に作成したキューブまたは移行したキューブのみに影響がありました。

アプリケーション・レベルの構成設定のデフォルト値を変更するには、アプリケーション・レベルの構成プロパティの設定の説明に従って、Essbase Webインタフェースを使用します。

ほとんどの構成は、アプリケーション・レベルで管理することをお薦めします。アプリケーションを移行する際、アプリケーション・レベルの構成は、LCMのエクスポートおよびインポートのプロセス時に保持されます。ただし、一部の構成はEssbaseサーバーにのみ適用されます。これらのサーバー構成のほとんどは、デプロイメント中にEssbaseを構成する際に指定しますが、必要に応じて、essbase.cfgを使用してサーバー構成デフォルトを変更することもできます。

一般的なノート

インポートされたSQLタイムスタンプ・データ型

以前はODBC形式[yyyy-mm-dd hh:mm:ss]で表示されていたSQLタイムスタンプ・データ型は、Essbase Webインタフェースのルール・エディタ、およびタイムスタンプ・データ型がインポートされる他の場所では、異なる形式[dd-MON-yy hh.mm.ss.mmm a]で表示されるようになりました。データ・ロード時またはディメンション構築時に選択した形式でタイムスタンプをロードするには、ロード・ルールの問合せセクションでSQL変換関数を使用して、タイムスタンプを選択した文字列形式に変換します。次のSQL問合せ例では、フォーマット関数SELECT introdate, format(introdate, 'yyyy-MM-dd hh:mm:ss') FROM tbc.dbo.productを使用します
EPMアプリケーションのアップグレード - 計算およびフィルタ

アプリケーションをEssbase 21cにアップグレードした後は、EPM Shared Servicesコンソールから計算やフィルタのためにメンバーをプロビジョニングできません。Essbase Webインタフェースを使用してメンバーを割り当てる必要があります。フィルタの割当ておよび計算へのアクセスを参照してください。
パーティション

LCMのインポート操作を実行するときは、ターゲット・アプリケーションの前にソース・アプリケーションをインポートします。ターゲット・アプリケーションの前にソース・アプリケーションをインポートしない場合、パーティション定義が機能しないため、ソース・アプリケーションをインポートした後にパーティション定義を再作成する必要があります。

OPatchをロールバックした後、透過パーティションおよびレプリケート・パーティションを再作成し、パーティションを再検証する必要がある場合があります。
LCM以外のアプリケーション作成オプション

LCMによるエクスポート済アプリケーションの移行に加えて、次のようにアプリケーションを作成することもできます。
- Excelのアプリケーション・ワークブックを使用してインポートします
- Smart Viewでキューブ・デザイナの拡張機能を使用します
- MaxLのcreate application文
ロケーション別名

LCMではロケーション別名の資格証明移行はサポートされません。Essbase 11g On-Premiseからアプリケーションを移行した後、ロケーション別名を置き換える必要があります。次の自動化された方法、またはMaxLによる手動の方法を使用できます。

ロケーション別名を置き換えるための自動化された方法
1. LCMでエクスポートしたzipを解凍します。
2. {ApplicationName}\Databases{dbName}\Location Aliasesに移動します。
3. このディレクトリでファイルを開きます。これはXML形式のファイルであり、userNameおよびpasswordフィールドは空です。資格証明を指定できます。
4. ディレクトリを再度圧縮します。
5. zipディレクトリを使用してアプリケーションをインポートします。
  サンプルxmlファイル
```
<?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>
```
MaxLを使用して手動でロケーション別名を置き換える方法

代替オプションである手動の方法では、MaxLを使用します。CLIのLCMImportジョブを実行してソース・アプリケーションをインポートした後で、ロケーション別名の作成を使用して、ロケーション別名を再作成します。
カスタム定義の関数とマクロ

独立デプロイメントの場合 - カスタム定義の計算関数とマクロに使用するカスタムのjarがある場合、それらは11g LCMエクスポート・ユーティリティでは移行されません。それらは手動で移行する必要があります。これを実行するには
1. Essbase 21cの<Essbaseパス>と<アプリケーション・ディレクトリ>(ARBORPATH)の場所をメモします。必要に応じて、Essbaseプラットフォームの環境の場所を参照してください。
2. ソース・インスタンスの<Essbaseパス>/java/udfにある.jarファイルを、ターゲットEssbaseインスタンスの<Essbaseパス>/java/udfにコピーすることで、グローバル(システムレベル)関数を移行します。
3. ソース・インスタンスのアプリケーション・ディレクトリにある.jarファイルを、ターゲットEssbaseインスタンスのアプリケーション・ディレクトリにコピーすることで、ローカル(アプリケーションレベル)関数を移行します。言い換えると、11gサーバーの<ARBORPATH>/app/<app_name>にある.jarファイルを、21cサーバーの<Application directory>/app/<app_name>にコピーします。
4. ターゲットEssbaseインスタンスで、essbase.cfgにJVMMODULELOCATIONを追加し、システムのJVMライブラリへのパスを引数として指定します。

クライアント・サービスのURL

独立デプロイメントの場合 - Essbase 11gでは、Provider Servicesは、Java API、Smart ViewおよびXML for Analysis (XMLA)の各クライアントに対応するOracle Essbaseへの中間層のデータソース・プロバイダです。

Provider Services機能は、WebLogicと統合されます。クライアントURLを現在の形式に更新します。

クライアント	指定したクライアントにProvider Servicesから接続するための以前のURL	Essbase 21cの新しいURL
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 for Analysis (XMLA)	`http://server_name:port/aps/XMLA`	`http://server_name:port/essbase/xmla`

アウトライン解決順序および使用可能な型付きメジャー

OCI Marketplaceデプロイメントの場合 - EssbaseアプリケーションをEssbase 11g On Premisesサーバーから、OCIにデプロイされたEssbaseにMarketplace経由で移行した後、アウトライン解決順序を変更する前に、アウトラインの型付きメジャーを有効にする必要があります。

OCIにデプロイされたEssbaseで、「使用可能な型付きメジャー」アウトライン・プロパティは、デフォルトでFALSEに設定されています。解決順序を変更するには、最初に「使用可能な型付きメジャー」プロパティをTRUEに変更する必要があります。このプロパティを変更するには、『Oracle Essbaseデータベース管理者ガイド』の型付きメジャーについてに関する項を参照してください。