非Unicode集約ストレージ・アプリケーションのUnicodeモードへの変換
集約ストレージEssbase 11g On-Premiseアプリケーションをエクスポートする前に実行するステップについて説明します。
クライアント側の構成 - WindowsクライアントでESSCMD/ESSCMDQを設定するには
ノート:
ESSCMDQの回避策情報のその他のリファレンスは、ESSCMDQを使用してアウトラインを圧縮する方法(ドキュメントID 1534496.1)およびEssbase 21cのディメンションの圧縮オプションがJET UIに表示されない(ドキュメントID 2853804.1)です。- Essbase Webインタフェースから、Windows用EssbaseクライアントおよびMaxLクライアントをダウンロードします。
- MaxLクライアントをMaxLClientディレクトリに抽出します。
- ESSCMDクライアントをEssbaseClientディレクトリに抽出します。
- startMaxl.batスクリプトをMaxLClientディレクトリからEssbaseClientディレクトリにコピーします。スクリプトの名前をstartEsscmd.batに変更します。
- startEsscmd.batファイルを編集し、esscmd.shではなくesscmdを呼び出す新しい設定を追加します:
"%ESSBASEPATH%\bin\esscmd" %*
- ファイルを保存します。それを管理者として実行し、Essbase 21c MarketplaceまたはOn-Premise (独立デプロイメント)へのログインをテストします。
接続文字列:
login https://<servername or IP>/essbase/agent <user> <password>
- それが動作することを確認した後で、Windows用ESSCMDQをhttps://www.oracle.com/middleware/technologies/esscmdq-sampleapps-downloads.htmlからダウンロードします。
- ESSCMDQ.exeをEssbaseClient/binディレクトリに抽出します。
- startEsscmd.batスクリプトをstartEsscmdQ.batにコピーします。
- startEsscmdq.batファイルを編集して、esscmdではなくesscmdqを呼び出します。
"%ESSBASEPATH%\bin\esscmdq" %*
- ファイルを保存します。それを管理者として実行し、Essbase 21c MarketplaceまたはOn-Premise (独立デプロイメント)へのログインをテストします。
接続文字列:
login https://<servername or IP>/essbase/agent <user> <password>
ノート:
- IDCS/MSADユーザーIDを使用して接続しないでください。ネイティブ・ユーザーを使用してログインします。
- プロキシ・サーバーを使用する場合は、次の設定をstartEssmcd/q.batスクリプトに追加する必要がある場合があります。
- set HTTP_PROXY=<proxyserver>:<port>
- set HTTPS_PROXY=<proxyserver>:<port>
サーバー側の構成 - Essbaseサーバーで直接設定するには
- 次の説明に従って、MaxLシェルを使用して、コピーされた集約ストレージ・アプリケーションをUnicodeモードに変換します。
- 次の説明に従って、ソース・アウトライン内のESSLANG値をネイティブのエンコーディングからUTF-8に変更します。
- MaxLシェルを使用して、ソースのEssbase 11gインスタンスにログインします。
- MaxL文
alter application <copied_app> set type unicode_mode
を実行して、アプリケーションをUnicodeに変換します。例:
MaxLの詳細は、「アプリケーションの変更」を参照してください。MaxL> alter application SampleBck set type unicode_mode;
ノート:
次のすべての操作はコピーされたアプリケーションで実行する必要があります。ソース・アプリケーションでは実行しないでください。- ESSCMDQをダウンロードします。
- ESSCMDQのダウンロードから、プラットフォーム専用のESSCMDQの「11.1.2.4.010+」バージョンをソースEPM 11gインスタンスへダウンロードします。
- インストール環境内のESSCMDが存在するディレクトリに、ファイルを直接解凍します。
Linuxの場合
$ESSBASEPATH/bin
例:./Middleware/EPMSystem11R1/products/Essbase/EssbaseServer/bin/ESSCMDQ
Windowsの場合
%ESSBASEPATH%\bin
例:.\Middleware\EPMSystem11R1\products\Essbase\EssbaseServer\bin\ESSCMDQ.exe
ソースEPM 11gのインストール環境にある環境変数の値を確認するには、次のファイルを参照してください。
Linuxの場合:./Middleware/user_projects/<epm instance>/EssbaseServer/essbaseserver1/bin/setEssbaseEnv.sh
Windowsの場合:./Middleware/user_projects/<epm instance>/EssbaseServer/essbaseserver1/bin/setEssbaseEnv.bat
デフォルトでは、
<epm instance>
はepmsystem1
です。 - 既存のスクリプトのコピーを作成します。
Linuxの場合
./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmd.sh
次のようにします。
./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh
Windowsの場合
.\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmd.bat
次のようにします。
.\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmdQ.bat
新しく作成したスクリプトで、呼び出しを
ESSCMD
からESSCMDQ
に変更します。 - 最後の行の直前(ESSCMDQの呼び出しの直前)に、次の行を追加します。
Linuxの場合
export ESSCMDQ_UTF8MODE=1 export ESSLANG=.UTF-8@Binary
Windowsの場合
set ESSCMDQ_UTF8MODE=1 set ESSLANG=.UTF-8@Binary
- アウトラインを変換する前に、コピーされたアプリケーションが停止していることを確認します。
- 次は、ARBORPATHの下に"client"フォルダを作成します。
- アプリケーション・フォルダをARBORPATHのappディレクトリからclientディレクトリにコピーします。ASOBckアプリケーションの場合の例:
Linuxの場合
$ARBORPATH/app/ASOBck as $ARBORPATH/client/ASOBck
Windowsの場合
%ARBORPATH%\app\ASOBck as %ARBORPATH%\client\ASOBck
- 次のものの起動後に、ESSCMDQで次のコマンドを実行します。
ノート:
ESSCMDQは対話型であるため、各コマンドのパラメータは対話型モードで見つけることができます。パラメータの意味を確認するには、コマンド(OpenOtlなど)を入力して[Enter]を押し、パラメータを説明するメニューを確認します。または、ESSCMDQコマンドを入力して[Enter]を押すと(パラメータは指定しない)、パラメータ・メニューが表示されます。Linuxの例
./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh openotlex2 1 1 appName dbName outlineName Y Y Locale N 0
writeotlex 0 1 1 appName dbName outlineName 2
Windowsの例
.\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmdQ.bat openotlex2 1 1 appName dbName outlineName Y Y Locale N 0
writeotlex 0 1 1 appName dbName outlineName 2
Locale
は、ソースのEssbase 11g環境で使用されているネイティブのESSLANG値になっているはずです。例(Linux構文)
mkdir $ARBORPATH/client cp -r $ARBORPATH/app/ASOBck $ARBORPATH/client ./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh openotlex2 1 1 ASOBck Basic Basic Y Y "Japanese_Japan.MS932@Binary" N 0 writeotlex 0 1 1 ASOBck Basic Basic 2 exit
- 前述のコマンドの実行時にエラーが表示されていないことを確認します。次に、各キューブに対して、クライアント・ディレクトリのアウトライン・ファイルのみをアプリケーション・ディレクトリに再度コピーします。
例(Linux構文)
#Now copy back the converted outline only for each cube. For ASOBck app - cp $ARBORPATH/client/ASOBck/Basic/Basic.otl $ARBORPATH/app/ASOBck/Basic/Basic.otl #Note: The artifact files (.txt or .csc), which were created in native locale, may need to be converted to UTF-8 manually using third party tools which help in converting text encoding.
- 次を使用してESSCMDQを再度起動します。
Linuxの場合
./Middleware/user_projects/epmsystem1/EssbaseServer/essbaseserver1/bin/startEsscmdQ.sh
Windowsの場合
そして各キューブを再構築します。.\Middleware\user_projects\epmsystem1\EssbaseServer\essbaseserver1\bin\startEsscmdQ.bat
#Please replace hostname, username, password, appname and cubename with appropriate values login 'hostname' 'username' 'password' select appname cubename openotl 2 1 appname cubename outlinename y y 0 writeotl 0 2 1 appname cubename outlinename restructotl 1 closeotl 0 unlockobj 1 appname cubename outlinename logout exit
例:
login localhost:1423 user password select ASOBck Basic openotl 2 1 ASOBck Basic Basic y y 0 writeotl 0 2 1 ASOBck Basic Basic restructotl 1 closeotl 0 unlockobj 1 ASOBck Basic Basic logout exit