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

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

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

Essbase 26aiWebインタフェースから、Windows用EssbaseクライアントおよびMaxLクライアントをダウンロードします。
MaxLクライアントをMaxLClientディレクトリに抽出します。
ESSCMDクライアントをEssbaseClientディレクトリに抽出します。
startMAXL.batスクリプトをMaxLClientディレクトリからEssbaseClientディレクトリにコピーします。スクリプト名をstartEsscmd.batに変更します。
startEsscmd.batファイルを編集し、esscmd.shではなくesscmdを呼び出す新しい設定を追加します。
```
"%ESSBASEPATH%\bin\esscmd" %*
```
ファイルを保存します。管理者として実行し、Essbase 26ai MarketplaceまたはIndependentデプロイメントへのログインをテストします。

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

ログイン構文:
```
login https://<servername_or_IP>/essbase/agent <user> <password>
```

ノート:

IDCS/MSADユーザーIDを使用して接続しないでください。ネイティブ・ユーザーを使用してログインします。
プロキシ・サーバーを使用する場合は、次の設定をstartEssmcd/q.batスクリプトに追加する必要がある場合があります。
- HTTP_PROXY=<proxyserver>:<ポート>を設定します。
- HTTPS_PROXY=<proxyserver>:<ポート>を設定します。

サーバー側の構成- Essbaseサーバーで直接設定するには

MaxL Shellを使用して、コピーされた集約ストレージ・アプリケーションをUnicodeモードに変換します。次に説明します。
次の説明に従って、ソース・アウトライン内のESSLANG値をネイティブのエンコーディングからUTF-8に変更します。

MaxL Shellを使用して、コピーされた集約ストレージ・アプリケーションを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