準備從 Essbase 11g 內部部署移轉

如果您有現有的 Essbase 11g On-Premise 應用程式和立方體可移轉至 Essbase 26ai ，請檢閱下列注意事項和先決條件。

Essbase 11g 內部部署與 Essbase 26ai 之間的差異

• 具有輸入計量之立方體的任意格式資料匯出與匯入在 Essbase 26ai 中的行為方式不同。如需最新資訊，請參閱載入、清除及匯出文字與日期計量。

• 移轉之前，請先複查 Essbase 11g 與 Oracle Essbase 26ai 之間的差異。

移轉的作業流程

附註：

• 如果您使用 Essbase 11g 內部部署中的 EPM Shared Services 來設定外部安全性提供者，則不需要下面的步驟 1。根據組態期間選擇的安全模式，您可能需要設定目標 EPM 例項或 WebLogic 使用與 Essbase 11g 內部部署中使用的相同外部安全提供者。

• 如果您使用 Oracle Identity Cloud Service ，請將它設定為使用與 Essbase 11g 內部部署中使用的相同外部安全性提供者。

1. 將使用者和群組從來源 Essbase 11g 內部部署 EPM Shared Services 移轉至 OCI Identity and Access Management (IAM) 或 Oracle Identity Cloud Service (IDCS) (用於 OCI 部署) 或 EPM Shared Services / WebLogic LDAP (適用於獨立部署)。請參閱移轉 Essbase 11g 使用者與群組。

2. 如果您要匯出非 Unicode Essbase 11g 內部部署應用程式，則必須將應用程式轉換為 Unicode。

   1. 在執行「11g LCM 匯出公用程式」之前，使用伺服器上的 Alter System ，然後在 Essbase 應用程式的備份複本上，啟用 Essbase 本身以支援 Unicode 應用程式。

   2. 若為非 Unicode 的區塊儲存應用程式，請使用匯出命令中的 -converttoutf8 選項匯出應用程式。請參閱 11g LCM 匯出公用程式選項。

      對於非 Unicode、聚總儲存應用程式，請遵循將非 Unicode 聚總儲存應用程式轉換為 Unicode 模式中的手動 Unicode 轉換指示進行。

3. 移轉 11g 應用程式：

   1. 使用從目標 Essbase 26ai 例項下載的 11g LCM 匯出公用程式匯出 Essbase 應用程式，並在安裝 Essbase 11g 內部部署的電腦上執行公用程式。

      附註：

      若要使用「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。建議您先從 11.1.2.3.0.n.n 升級至 11.1.2.4.0.n.n 後，再嘗試移轉至 26ai。

不支援下列移轉路徑：

• 在 Windows 上將 Essbase 19c 或 26ai (市集部署) Essbase 26ai (獨立部署)
• Linux 上的 Essbase 26ai (獨立部署) 至 Windows 上的 Essbase 26ai (獨立部署)

移轉的 11g 使用者自建物件

複查支援移轉的 11g 使用者自建物件。請參閱已移轉的人工因素。

不支援的應用程式和資料庫設定值

移轉不支援下列應用程式層級或資料庫層級設定值：磁碟磁碟區。

組態備註

• 混合模式

  預設計算與查詢處理器是混合模式。混合模式可讓區塊儲存立方體擁有動態、高階稀疏成員，以及完全動態查詢與計算。您可以在更新資料後立即查詢資料，不需要執行批次計算。在混合模式中，如果您選擇不將動態計算套用至上層稀疏成員，則不會影響立方結構。注意：如果使用計算命令檔，混合模式不是預設值 - 如果您的計算命令檔包含許多稀疏相依性，請同時考慮對計算命令檔啟用混合模式。

• 隱含共用功能

  如果您在 Essbase 11g 內部部署應用程式中使用 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"

  如需載入超出範圍值的資訊，請參考載入、清除及匯出文字與日期計量。

• Configuration Settings - 組態設定值

  某些預設組態值與 Essbase 11g 內部部署中的組態值不同。請檢查組態參考。

  INDEXCACHESIZE 和 DATACACHESIZE 設定值現在可控制所有 Essbase 立方體的快取大小 (聚總儲存立方體除外)。這些設定過去只會影響新建立或移轉的立方體。

  若要修改應用程式層級組態設定值的預設值，請使用 Essbase Web 介面。

  Oracle 建議您在應用程式層級管理大多數組態。移轉應用程式時，在 LCM 匯出和匯入程序期間會保留應用程式層級的組態。不過，某些組態僅適用於 Essbase 伺服器。您在部署期間設定 Essbase 時所指定的大部分伺服器組態，但您也可以視需要使用 essbase.cfg 變更伺服器組態預設值。

一般說明

• 匯入的 SQL 時戳資料類型

  之前以 ODBC 格式 [yyyy-mm-dd hh:mm:ss] 顯示的 SQL 時間戳記資料類型，現在會以不同的格式 [dd-MON-yy hh.mm.ss.mmm a] 顯示，在 Essbase Web 介面的規則編輯器中，以及匯入時間戳記資料類型的每一個位置。若要在資料載入或維度建置期間使用您選擇的格式載入時間戳記，您可以在載入規則的查詢區段中使用 SQL 轉換函數，將時間戳記轉換為您選擇的字串格式。下列 SQL 查詢範例使用格式函數：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 建立應用程式敘述句

• 位置別名

  LCM 不支援位置別名證明資料移轉。從 Essbase 11g 內部部署移轉應用程式之後，您必須取代您的位置別名。您可以使用下列自動化方法，或是使用 MaxL 的手動方法。

  取代位置別名的自動化方法

  1. 解壓縮 LCM 匯出的 zip。
  2. 前往 {ApplicationName}\Databases{dbName}\Location 別名。
  3. 開啟此目錄下的檔案。此為 XML 格式檔案，其中 userName 與密碼欄位為空白。您可以提供證明資料。
  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 工作來匯入來源應用程式之後，請使用建立位置別名重新建立位置別名。

• 自訂函數和巨集

  FOR INDEPENDENT DEPLOYMENTS - 如果您有用於自訂計算函式和巨集的自訂 .jar 檔案，這些檔案不會被「11g LCM 匯出公用程式」移轉。您必須手動移動它們。若要執行這項作業，

  1. 請注意 Essbase 26ai 中 <Essbase Path> 和 <Application directory> ( ARBORPATH) 的位置。如有需要，請參考 Essbase 平台中的環境位置。

  2. 將來源例項上的 .jar 檔案從 <Essbase Path>/java/udf 複製到目標 Essbase 例項上的 <Essbase Path>/java/udf，以移轉全域 (系統層級) 函數。

  3. 將您的 .jar 檔案從來源例項上的應用程式目錄複製到目標 Essbase 例項上的應用程式目錄，以移轉本機 (應用程式層級) 函數。換句話說，將 .jar 檔案從 11g 伺服器上的 <ARBORPATH>/app/<app_name> 複製到 26ai 伺服器上的 <Application directory>/app/<app_name>。

  4. 在目標 Essbase 例項上，將 JVMMODULELOCATION 新增至 essbase.cfg，作為您系統上 JVM 程式庫路徑的引數。

• 從屬端服務 URL

  FOR INDEPENDENT DEPLOYMENTS - 在 Essbase 11g 中， Provider Services 是 Java API、 Smart View 和 XML FOR Analysis (XMLA) 用戶端之 Oracle Essbase 的中間層資料來源提供者。

  提供者服務功能已與 WebLogic 整合。將從屬端 URL 更新為目前的格式。

  從屬端	用於將 Provider Services 連線至特定用戶端的前 URL	Essbase 26ai 中的新 URL
  Java API	http://server_name:port/aps/JAPI	http://server_name:port/essbase/japi
  智慧型檢視	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 DEPLOYMENTS - 將 Essbase 應用程式從 Essbase 11g 內部部署伺服器移轉至透過 MARKETPLACE 部署於 OCI 的 Essbase 之後，您必須先在大綱中啟用輸入的計量，才能變更大綱解決順序。

  在 OCI 上部署的 Essbase 中，已啟用類型計量大綱特性預設為 FALSE。若要變更解決順序，必須先將「已啟用輸入計量」特性變更為 TRUE。若要變更此特性，請參閱 Database Administrator's Guide for Oracle Essbase 中的 About Typed Measures 。