將非 Unicode 聚總儲存應用程式轉換成 Unicode 模式

從 Essbase 11g 內部部署匯出彙總儲存應用程式以準備移轉至 Essbase 26ai 之前，請先將它轉換成 Unicode 模式。

從屬端組態 - 在 Windows 從屬端設定 ESSCMD/ESSCMDQ

  1. 從 Essbase 26ai Web 介面，下載適用於 Windows 的 Essbase 用戶端，以及 MaxL 用戶端。

  2. 將 MaxL 從屬端解壓縮至 MaxLClient 目錄。

  3. 將 ESSCMD 從屬端擷取至 EssbaseClient 目錄。

  4. 將 startMAXL.bat 命令檔從 MaxLClient 目錄複製到 EssbaseClient 目錄。將命令檔重新命名為 startEsscmd.bat。

  5. 編輯 startEsscmd.bat 檔案，然後新增設定值以呼叫 esscmd ，而非 esscmd.sh ： 

    "%ESSBASEPATH%\bin\esscmd" %*

  6. 儲存檔案。以管理員身分執行並測試登入 Essbase 26ai 市集或獨立部署。

    登入語法：

    login https://<servername_or_IP>/essbase/agent <user> <password>

  7. 確認後，請從 https://www.oracle.com/middleware/technologies/esscmdq-sampleapps-downloads.html 下載 ESSCMDQ for Windows。

  8. 將 ESSCMDQ.exe 擷取至 EssbaseClient/bin 目錄。

  9. 將 startEsscmd.bat 命令檔複製到 startEsscmdQ.bat。

  10. 編輯 startEsscmdQ.bat 檔案以呼叫 esscmdq 而不是 esscmd ： 

    "%ESSBASEPATH%\bin\esscmdq" %*

  11. 儲存檔案。以管理員身分執行並測試登入 Essbase 26ai 市集或獨立部署。

    登入語法：

    login https://<servername_or_IP>/essbase/agent <user> <password>

附註：

  • 請勿使用 IDCS/MSAD 使用者 ID 來連線。使用「原生」使用者登入。
  • 如果使用代理伺服器，您可能需要將下列設定加入 startEssmcd/q.bat 指令集：
    • 設定 HTTP_PROXY=<proxyserver>：< 連接埠 >
    • 設定 HTTPS_PROXY=<proxyserver>：<port>

伺服器端組態 - 直接在 Essbase 伺服器上設定

  1. 使用 MaxL Shell 將複製的聚總儲存應用程式轉換成 Unicode 模式，如下所述。

  2. 將來源大綱中的 ESSLANG 值從原生編碼變更為 UTF-8，如下所述。

使用 MaxL Shell 將複製的聚總儲存應用程式轉換成 Unicode 模式：

  1. 使用 MaxL Shell 登入來源 Essbase 11g 內部部署例項。

  2. 執行 MaxL 陳述式 alter application <copied_app> set type unicode_mode，將應用程式轉換成 Unicode。

    舉例而言： 
    MaxL> alter application SampleBck set type unicode_mode;
    如需有關 MaxL 的詳細資訊，請參閱變更應用程式 (聚總儲存) 。

附註：

必須對複製的應用程式執行以下所有作業，而不是來源應用程式。
將來源大綱內的 ESSLANG 值從原生編碼變更為 UTF-8。

  1. 下載 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

  2. 在轉換大綱之前，請確定已停止複製的應用程式。

  3. 現在在 ARBORPATH 下建立 client 資料夾。

  4. 將應用程式資料夾從 ARBORPATH/app 目錄複製到用戶端目錄。若為 ASOBck 應用程式，例如：

    Linux

    $ARBORPATH/app/ASOBck as $ARBORPATH/client/ASOBck

    Windows

    %ARBORPATH%\app\ASOBck as %ARBORPATH%\client\ASOBck

  5. 啟動下列項目後，請在 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

  6. 執行上述命令時，請確定未顯示任何錯誤。然後，針對每個立方體，只將從屬端目錄中的大綱檔案複製回應用程式目錄。

    例如 (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.

  7. 使用下列方法再次啟動 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