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

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

Essbase 11g On-PremiseとEssbase 26aiの違い

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

移行のタスク・フロー

ノート:

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

Migrate users and groups from source Essbase 11g On-Premise EPM Shared Services to OCI Identity and Access Management (IAM) or Oracle Identity Cloud Service (IDCS) (for OCI deployment) or EPM Shared Services / WebLogic LDAP (for Independent deployments). Essbase 11gのユーザーとグループの移行を参照してください。
非UnicodeのEssbase 11g On-Premiseアプリケーションを移行する場合は、そのアプリケーションをUnicodeに変換する必要があります。
1. 11g LCMエクスポート・ユーティリティを実行する前に、サーバーでAlter Systemを使用し、次にEssbaseアプリケーションのバックアップ・コピーの順にAlter Systemを使用して、Essbase自体がUnicodeアプリケーションをサポートできるようにします。
2. Unicode以外のブロック・ストレージ・アプリケーションのブロックの場合は、エクスポート・コマンドで-converttoutf8オプションを使用して、アプリケーションをエクスポートします。11g LCMエクスポート・ユーティリティのオプションを参照してください。
  
  Unicode以外の集約ストレージ・アプリケーションについては、Unicode以外の集約ストレージ・アプリケーションからUnicodeモードへの変換の手動でのUnicode変換の手順に従ってください。
11gアプリケーションを移行します。
1. ターゲットのEssbase 26aiインスタンスからダウンロードした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 26aiインスタンスからダウンロードした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から26aiに移行できるわけではありません。26aiへの移行を試行する前に、11.1.2.3.0.n.nから11.1.2.4.0.n.nにアップグレードすることをお薦めします。

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

OCI上のEssbase 19cまたは26ai (マーケットプレイス・デプロイメント)からWindows上のEssbase 26ai (独立したデプロイメント)
Linux上のEssbase 26ai (独立したデプロイメント)からWindows上のEssbase 26ai (独立したデプロイメント)

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

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

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

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

構成についての注意事項

ハイブリッド・モード

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

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

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

これを修正するには、次の場所にあるesssql.cfgからUPPERCASECONNECTION設定を手動で削除します。
```
<DOMAIN_HOME>/config/fmwconfig/essconfig/essbase/esssql.cfg
```
次に、Essbaseサーバーを再起動します。
テキスト・メジャーおよび日付メジャー
Essbase 21.3以降では、構成ALLOWOUTOFRANGELOADは非推奨になり、以前のバージョンのALLOWOUTOFRANGELOAD TRUEと同じ動作になります。範囲外で、入力されたメジャーの欠落値が、テキスト・メジャーを持つキューブにロードおよびエクスポートされます。次のデータ・エクスポート・ファイルの例では、欠落した値の<OutOfRange_Name>は「無効」および「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問合せの例では、format関数を使用しています: SELECT introdate, format(introdate, 'yyyy-MM-dd hh:mm:ss') FROM tbc.dbo.product
EPMアプリケーションのアップグレード- 計算およびフィルタ

アプリケーションをEssbase 26aiにアップグレードした後は、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 26aiの<Essbase Path>および<Application directory> (ARBORPATH)の場所に注意してください。必要に応じて、「Essbaseプラットフォームの環境の場所」を参照してください。
2. ソース・インスタンスの<Essbaseパス>/java/udfにある.jarファイルを、ターゲットEssbaseインスタンスの<Essbaseパス>/java/udfにコピーすることで、グローバル(システムレベル)関数を移行します。
3. ソース・インスタンスのアプリケーション・ディレクトリにある.jarファイルを、ターゲットEssbaseインスタンスのアプリケーション・ディレクトリにコピーすることで、ローカル(アプリケーションレベル)関数を移行します。言い換えると、11gサーバーの<ARBORPATH>/app/<app_name>にある.jarファイルを、26aiサーバーの<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 26aiの新しい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 (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データベース管理者ガイド』の型付きメジャーについてに関する項を参照してください。