使用移轉公用程式移轉應用程式

身為 Essbase 服務管理員，您可以使用「移轉公用程式」(migrationTools.jar) 將整個 Essbase 例項 (所有應用程式、使用者與群組以及其他人工因素) 從單一程序移轉至另一個雲端例項。

您可以使用「移轉公用程式」，透過市集從 OCI 上的 Essbase 部署移轉來源應用程式和元素。公用程式一次會移轉多個應用程式。它也會移轉人工因素、規則、使用者和群組。

請注意， Essbase 命令行介面 (CLI) 命令 lcmimport 和 lcmexport 不會移轉使用者和群組。

使用「移轉公用程式」之前，請先完成下列先決條件：設定 SSL 憑證。

移轉公用程式使用案例

以下是使用移轉公用程式進行移轉的一些使用案例。

• 將來源中的 Essbase 使用者從 WebLogic LDAP 移轉至目標中的 OCI Identity and Access Management (IAM) 或 Oracle Identity Cloud Service (IDCS)。
• 使用「移轉公用程式」來處理未自訂的基本部署。如果您的部署包含自訂項目 (例如自訂單一登入解決方案)，請使用 CLI 而非移轉公用程式。
• 來源 Essbase 部署來自
  • Oracle Cloud Infrastructure 上的 Essbase 市集、使用 OCI Identity and Access Management (IAM) 或 Oracle Identity Cloud Service (IDCS)，或
  • Oracle Cloud Infrastructure 上的 Essbase 市集 (使用內嵌 LDAP)
  然後，使用下方的「移轉」公用程式步驟進行匯出之前，請先建立建立機密識別應用程式中所述的新機密應用程式。此外，在使用「移轉公用程式」進行匯入之前，請先變更 import.properties 中的主機和 IAM 或 IDCS 詳細資訊，以指向目標 Essbase 執行處理。

使用移轉公用程式移轉雲端應用程式和使用者的步驟

1. 使用「移轉公用程式」之前，如果您尚未將來源 Essbase 例項修正為最新版本。

2. 如果尚未安裝，請從 Oracle Technology Network 下載並安裝 Java SE Development Kit (JDK) 8。

3. 在您的系統上設定 JAVA_HOME 環境變數名稱，使其指向 JDK 安裝資料夾。如果安裝路徑包含任何空格，請將變數值中的路徑括在引號內，例如 "C:\Program Files\Java\jdk1.8.0_171"。

4. 登入目標 Essbase Web 介面，然後導覽至主控台。

5. 在「主控台」中，移至「桌面工具」，並展開「命令行工具」。

6. 按一下移轉公用程式旁邊的下載。

7. 將「移轉公用程式」壓縮檔下載至本機磁碟機。為取得最佳結果，請選擇無空格的路徑，例如 C:\Oracle。

8. 將壓縮檔解壓縮，然後查看 migrationTools 資料夾中擷取的檔案 (特性、jar 和 readme)。

9. 執行「移轉公用程式」匯出之前，請先編輯 export.properties 檔案，該檔案位於與公用程式相同的目錄中。提供您要移轉之來源 Essbase 來源例項的詳細資料。

   匯出屬性	描述
   userName	(必要) Essbase 管理者使用者名稱。
   password - 密碼	(必要) Essbase 管理員密碼。
   host - 主機	(必要) 負載平衡器的 IP 位址 (如果在 Essbase 部署期間設定負載平衡器)。否則，與 Essbase 公用 IP 位址對應的主機名稱或 IP 位址。
   port	(選擇性) 來源 Essbase 執行處理的 HTTP 監聽連接埠。如果來源執行處理是以安全 (TLS) 模式設定，則假設為 isTLS= true 連接埠 443 。如果來源執行處理已設定 LDAP 身分識別提供者，請將連接埠設為 80 。
   繁體中文	選擇性： true 或 false 。若為 true，會使用指定的 port 值，以安全 (TLS) 模式設定來源執行處理。
   proxy - 代理主機	(選擇性) HTTP 代理主機位址 (如果與來源 Essbase 執行處理的連線需要代理主機)。代理主機和代理主機連接埠會以冒號區隔。如果省略代理主機連接埠，其值會假設為 80。省略的連接埠範例：www-proxy-example.com。包含連接埠的範例：www-proxy-example.com:80
   略過資料	(選擇性) 預設值為 false。如果只應該匯出 Essbase 應用程式的綱要，請設為 true 。
   略過使用者	選擇性： true 或 false 。只有在不需要匯出使用者和 (或) 群組時，才設為 true。預設值為 False。
   IDCS 主機	只有從透過市集部署在 OCI 上的執行處理移轉使用者和 (或) 群組時才需要。IAM 或 IDCS 中的來源識別網域主機。從識別網域 URL (例如：https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com))，只擷取字串之後的網域部分。範例：identity.oraclecloud.com
   idcs 租用戶	只有從透過市集在 OCI 上部署的執行處理移轉使用者和 (或) 群組時才需要。IAM 或 IDCS 中的來源主機識別網域租用戶 ID。從識別網域 URL (例如：https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)，僅擷取 idcs-<string_of_numbers_and_letters>)。
   客戶 ID	只有從透過市集在 OCI 上部署的執行處理移轉使用者和 (或) 群組時才需要。在整合的機密識別應用程式中找到之 OAuth 授權的來源主機從屬端 ID。
   clientSecret	只有從透過市集在 OCI 上部署的執行處理移轉使用者和 (或) 群組時才需要。在整合的機密識別應用程式中找到來源主機的 OAuth 授權從屬端加密密碼。
   appId	只有從透過市集在 OCI 上部署的執行處理移轉使用者和 (或) 群組時才需要。OCI 識別網域 (IAM 或 IDCS) 上整合之機密識別應用程式的 ID。此識別應用程式應設定可授予使用者和群組的應用程式角色。此特性可讓您將角色授予移轉的使用者和群組。

10. 編輯 import.properties 檔案，該檔案位於與公用程式相同的目錄中。提供您要移轉的目標 Essbase 目標例項詳細資料。

    匯入館別	描述
    userName	(必要) 目標例項的 Essbase 管理員使用者名稱。
    password - 密碼	(必要) 目標例項的 Essbase 管理員密碼。
    host - 主機	(必要) 如果負載平衡器是在 Essbase 部署期間設定，則為負載平衡器的目標執行處理 IP 位址。否則，與 Essbase 公用 IP 位址對應的主機名稱或 IP 位址。
    port	(選擇性) 目標 Essbase 執行處理的 HTTP 監聽連接埠。如果目標執行處理是以安全 (TLS) 模式設定，則假設為 isTLS= true 連接埠 443 。如果來源執行處理已設定 LDAP 身分識別提供者，請將連接埠設為 80 。
    繁體中文	選擇性： true 或 false 。若為 true，會使用指定的 port 值，以安全 (TLS) 模式設定目標執行處理。
    userPassword	(選擇性) 要指派給公用程式移轉至 IAM 或 IDCS 中整合識別應用程式之任何新使用者的初始密碼。若要在移轉後變更密碼，請使用 OCI 主控台。
    proxy - 代理主機	(選擇性) HTTP 代理主機位址 (如果目標 Essbase 執行處理的連線需要代理主機)。代理主機和代理主機連接埠會以冒號區隔。如果省略代理主機連接埠，其值會假設為 80。省略的連接埠範例：www-proxy-example.com。包含連接埠的範例：www-proxy-example.com:80
    略過使用者	選擇性： true 或 false 。只有在不需要匯入使用者和 (或) 群組時，才設為 true。預設值為 False。
    IDCS 主機	只有將使用者和 (或) 群組移轉至透過市集在 OCI 上部署的執行處理時才需要。目標識別網域主機。從識別網域 URL (例如：https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com))，只擷取字串之後的網域部分。範例：identity.oraclecloud.com
    idcs 租用戶	只有將使用者和 (或) 群組移轉至透過市集在 OCI 上部署的執行處理時才需要。目標主機的識別網域租用戶 ID。從識別網域 URL (例如：https://idcs-<string_of_numbers_and_letters>.identity.oraclecloud.com)，僅擷取 idcs-<string_of_numbers_and_letters>)。
    客戶 ID	只有將使用者和 (或) 群組移轉至透過市集在 OCI 上部署的執行處理時才需要。在整合的機密識別應用程式中找到目標主機的 OAuth 授權從屬端 ID。
    clientSecret	只有將使用者和 (或) 群組移轉至透過市集在 OCI 上部署的執行處理時才需要。在整合的機密識別應用程式中找到目標主機的 OAuth 授權從屬端加密密碼。
    appId	只有將使用者和 (或) 群組移轉至透過市集在 OCI 上部署的執行處理時才需要。OCI 識別網域 (IAM 或 IDCS) 上整合之機密識別應用程式的 ID。此識別應用程式應設定可授予使用者和群組的應用程式角色。此特性可讓您將角色授予移轉的使用者和群組。
    overwrite	(選擇性) 如果要匯入的應用程式已存在於目標上，而您想要覆寫應用程式，請設為 true 。預設值為 False。
    certificates - 憑證	(選擇性) 所有 TLS/SSL 伺服器之所有信任憑證檔案的完整路徑。若為 Windows，請以另一個反斜線來逸出反斜線。範例：C:\\migrationTools\\all_certs.pem

11. 使用匯出命令在 Java 中執行移轉公用程式，將 Essbase 來源例項目錄的所有應用程式、使用者和群組匯出至壓縮檔案。

    java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar export export.properties <new_tar_file>

    範例：

    java –jar -Dhttps.proxyHost=www-proxy-abcdef.example.com -Dhttps.proxyPort=80 migrationTools.jar export export.properties export.tar.gz

12. 使用匯入命令在 Java 中執行移轉公用程式，將壓縮的檔案匯入目標執行處理。

    java -jar -Dhttps.proxyHost=<proxy-url> -Dhttps.proxyPort=<nn> migrationTools.jar import import.properties <existing_tar_file>

13. 執行匯入之後，資料會移轉至目標執行處理的 Essbase 目錄。