非Unicode集約ストレージ・アプリケーションのUnicodeモードへの変換

Essbase 21cへの移行の準備としてEssbase 11g On-Premiseから集約ストレージ・アプリケーションをエクスポートする前に、Unicodeモードに変換します。

クライアント側の構成 - WindowsクライアントでESSCMD/ESSCMDQを設定するには

ノート:

ESSCMDQの回避策情報のその他のリファレンスは、ESSCMDQを使用してアウトラインを圧縮する方法(ドキュメントID 1534496.1)およびEssbase 21cのディメンションの圧縮オプションがJET UIに表示されない(ドキュメントID 2853804.1)です。

Essbase 21cの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または独立デプロイメントへのログインをテストします。

ログイン構文:
```
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または独立デプロイメントへのログインをテストします。

ログイン構文:
```
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シェルを使用して、コピーされた集約ストレージ・アプリケーションをUnicodeモードに変換します:

MaxLシェルを使用して、ソースのEssbase 11g On-Premiseインスタンスにログインします。
MaxL文alter application <copied_app> set type unicode_modeを実行して、アプリケーションをUnicodeに変換します。
例:
```
MaxL> alter application SampleBck set type unicode_mode;
```
MaxLの詳細は、アプリケーションの変更(集約ストレージ)を参照してください。

ノート:

次のすべての操作はコピーされたアプリケーションで実行する必要があります。ソース・アプリケーションでは実行しないでください。

ソース・アウトライン内のESSLANG値をネイティブ・エンコーディングからUTF-8に変更します。

ESSCMDQをダウンロードします
1. ESSCMDQのダウンロードから、プラットフォーム専用のESSCMDQの「11.1.2.4.010+」バージョンをソースEPM 11gインスタンスへダウンロードします。
2. インストール環境内の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です。
3. 既存のスクリプトのコピーを作成します。
  
  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に変更します。
4. 最後の行の直前(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ディレクトリからクライアント・ディレクトリにコピーします。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 On-Premise環境で使用されているネイティブの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