使用快照移轉 Oracle Analytics Cloud

您可以利用下載和上傳功能將快照儲存至本機檔案系統，並將它們上傳回雲端。您可以使用這些功能在兩個不同的服務之間，或在開發、測試與生產環境之間進行內容移轉，以及將 Oracle Cloud Infrastructure Classic 中部署的服務移轉至 Oracle Cloud Infrastructure。

主題：

關於 Oracle Analytics Cloud 移轉

您可以使用快照，輕鬆地將內容和設定值從一個 Oracle Analytics Cloud 環境移轉至另一個環境。您可以移轉所有內容或移轉特定類型的內容。

移轉先決條件

使用快照移轉使用者內容之前，請先檢查來源和目標環境：

來源和目標環境兩者都必須使用 Oracle Analytics Cloud 5.1.x 或更新版本。從較舊版本建立的快照並不會擷取整個環境。

如果您不確定，請詢問您的 Oracle 業務代表。
如果您還沒這樣做，請在 Oracle Cloud Infrastructure 上建立目標服務。

請參閱 Administering Oracle Analytics Cloud on Oracle Cloud Infrastructure (Gen 2) 中的 Create a Service with Oracle Analytics Cloud。
如果您想要移轉檔案式資料，請檢查來源和目標環境是否均已啟動並執行中，並且設定了有效的儲存證明資料。

若發生儲存存取問題，將會無法使用快照進行資料檔移轉。如果發生此問題，可以使用資料移轉公用程式下載您的資料檔案，然後再分開上傳。

未移轉的項目

快照沒有包含某些 Oracle Analytics Cloud 使用者自建物件，也沒有包含非 Oracle Analytics Cloud 使用者自建物件。

未移轉的項目	其他資訊
病毒掃描程式組態	記錄來源環境中使用的病毒掃描程式組態，然後使用相同的資訊設定目標環境的病毒掃描程式。請參閱設定病毒掃描程式。
郵件伺服器組態	記錄來源環境中使用的 SMTP 郵件伺服器組態，然後使用該資訊設定目標環境的郵件伺服器。請參閱設定傳遞報表的電子郵件伺服器。
來源環境中其他已儲存的快照	如有需要，請下載想要移轉的個別快照，然後將它們上傳到目標環境。請參閱匯入快照。
使用者 (和群組)	從 Oracle Cloud Infrastructure Identity and Access Management (IAM) 識別網域進行移轉使用 Oracle Cloud Infrastructure 主控台的匯出和匯入功能，將使用者和角色從一個識別網域移轉至另一個。請參閱 Oracle Cloud Infrastructure 文件中的 Transferring Data。從 Oracle Identity Cloud Service 進行移轉使用 Oracle Identity Cloud Service 主控台的匯出和匯入功能，將使用者和角色從一個識別網域移轉至另一個。請參閱管理 Oracle Identity Cloud Service 使用者和管理 Oracle Identity Cloud Service 群組。從內嵌 WebLogic LDAP 伺服器進行移轉使用 `wls_ldap_csv_exporter` 命令檔將使用者和群組匯出成 CSV 檔案，供您匯入目標 Oracle Identity Cloud Service。請參閱從內嵌 WebLogic LDAP 伺服器匯出使用者和群組。
識別管理組態	使用目標環境中的 Oracle Cloud Infrastructure 主控台，重新設定在來源設定的所有使用者 (或群組) 應用程式角色指定、重新設定單一登入 (SSO) 等等。
網路組態	視需要在目標環境中設定您的網路需求。

移轉 Oracle Analytics Cloud 的一般工作流程

您可以使用快照將 Oracle Analytics Cloud 移轉至其他環境。所需要進行的作業如下。

作業	描述	其他資訊
瞭解如何使用快照進行移轉	瞭解可以和不能使用快照移轉的項目和先決條件。	關於 Oracle Analytics Cloud 移轉
建立目標服務	使用 Oracle Cloud Infrastructure 主控台在 Oracle Cloud Infrastructure 上部署新服務。	Create a Service with Oracle Analytics Cloud
移轉使用者和群組	使用 Oracle Cloud Infrastructure 主控台的匯出和匯入功能，將使用者和角色從一個識別網域移轉至另一個。移轉 Oracle Analytics Cloud 使用者的方式取決於您的雲端帳戶是否能使用識別網域。如果不確定，請參閱關於設定使用者和群組。您的來源系統若使用內嵌的 WebLogic LDAP 伺服器管理識別，請使用 `wls_ldap_csv_exporter` 命令檔將使用者和群組匯出成 CSV 檔案。	傳輸資料 (IAM 使用者) 管理 Oracle Identity Cloud Service 使用者從內嵌 WebLogic LDAP 伺服器匯出使用者和群組
建立來源的快照	擷取來源系統上所要移轉的內容。	建立快照
匯出快照	下載您要移轉至本機檔案系統或 Oracle Cloud Infrastructure 上儲存的儲存桶之快照。	匯出快照
將快照上傳至目標	登入目標系統，然後上傳快照。	匯入快照
回復快照內容	從已儲存的快照清單中選取新上傳的快照，然後回復快照中的內容。	從快照回復
移轉資料檔案	使用「資料移轉」公用程式將資料檔案從一個環境移轉到另一個環境。只有在以下情況時需要：移轉至其他區域。從 Oracle Analytics Cloud (Gen 1) 或 Oracle Cloud Infrastructure Classic 移轉至 Oracle Analytics Cloud (Gen 2)。回復處理作業因網路連線或儲存存取問題失敗。	移轉檔案型資料
重新設定病毒掃描程式	記錄來源環境的病毒掃描程式組態，然後用它設定目標環境的病毒掃描程式。	設定病毒掃描程式
重新設定郵件伺服器	記錄來源環境的 SMTP 郵件伺服器組態，然後用它設定目標環境的郵件伺服器。	設定傳遞報表的電子郵件伺服器
(選擇性) 移轉其他快照	下載想要移轉的個別快照，然後視需要將它們上傳到目標環境。	匯出快照匯入快照
移轉識別管理組態	使用目標環境中的 Oracle Cloud Infrastructure 主控台，重新設定在來源設定的所有使用者 (或群組) 應用程式角色指定、重新設定單一登入 (SSO) 等等。

移轉檔案型資料

使用者可以將資料檔案 (例如試算表) 上傳至 Oracle Analytics Cloud 以建立資料集。移轉至新的 Oracle Analytics Cloud 環境時，可以將此檔案型資料一併進行移轉。有的時候，您可能會因為網路連線或儲存存取問題，而無法在快照中移轉資料檔案。針對這類情況，Oracle Analytics Cloud 提供 CLI 公用程式 (命令行介面)，可讓您將資料檔移至新位置。快照 CLI 公用程式也會一併移動所有地圖相關 Plug-in，以及使用者可能上傳以用於其資料視覺化的擴充檔案。

嘗試回復包含資料檔案的快照時，若見到回復成功，但有錯誤 - 資料回復失敗或類似訊息時，請執行資料移轉 CLI 公用程式。以下情況會出現此訊息：

移轉其他區域的內容。
將 Oracle Analytics Cloud (Gen 1) 或 Oracle Cloud Infrastructure Classic 的內容移轉至 Oracle Analytics Cloud (Gen 2)。
回復處理作業因發生某些其他的網路連線或儲存存取問題而失敗。

CLI 公用程式讓您只需要單一步驟，就能將資料檔從一個環境直接移至另一個環境。或者，也可以採用兩個步驟，亦即先將檔案型資料下載成壓縮檔，再將資料檔案上傳至選擇的環境。

檢查您的環境詳細資訊。
- 確認來源和目標系統都使用 Oracle Analytics Cloud 5.3 或更新版本。較舊的版本並未提供 CLI 公用程式。
  
  如果您不確定，請詢問您的 Oracle 業務代表。
- 確定來源和目標系統都已啟動並在執行中，而且 Oracle Analytics Cloud 已設定有效的儲存證明資料。
- 檢查本機環境。您需要有 Java 1.8 或更新版本，才能夠執行 CLI 公用程式。
- 確定可從計畫執行 CLI 公用程式的本機環境存取來源環境和目標 Oracle Analytics Cloud。
- 檢查先前下載內含檔案型資料的快照名稱和位置。例如 /tmp/20190307095216.bar。
下載 CLI 公用程式。
1. 在目標 Oracle Analytics Cloud 中，依序按一下主控台和快照。
2. 按一下「頁面」功能表，然後依序選取移轉和下載資料移轉公用程式。
  依指示將 migrate-oac-data.zip 檔案儲存到本機。
解壓縮 migrate-oac-data.zip。
壓縮檔會包含 3 個檔案：
- migrate-oac-data.jar
- config.properties
- readme

如果希望只用單一步驟就將來源環境中儲存的資料檔案直接移轉至目標環境，請設定 config.properties 中的 [MigrateData] 區段。

[MigrateData]
# Migrate data files from a source Oracle Analytics Cloud environment (OAC) to a target Oracle Analytics Cloud environment.
    # Specify the source environment as Oracle Analytics Cloud.
      SOURCE_ENVIRONMENT=OAC
    # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
      SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

    # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
      SOURCE_USERNAME=<Source Administrator User Name>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>
    # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
      TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
    # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
      TARGET_USERNAME=<Target Administrator User Name>

如果希望先從來源 Oracle Analytics Cloud 將資料檔下載至本機環境，接著再將資料檔上傳至目標 Oracle Analytics Cloud 環境，請設定 config.properties 中的 [DownloadDataFiles] 和 [UploadDataFiles] 區段。

[DownloadDataFiles]
#Download Data Files: Download data files from Oracle Analytics Cloud storage to a local repository
    # Specify the source environment as Oracle Analytics Cloud.
      SOURCE_ENVIRONMENT=OAC
    # Source Oracle Analytics Cloud URL. For example: https://sourcehost.com:443 or http://sourcehost.com:9704
      SOURCE_URL=http(s)://<Source Oracle Analytics Cloud Host>:<Source Port>

    # Name of a user with Administrator permissions in the source environment. For example: SourceAdmin
      SOURCE_USERNAME=<Source Administrator User Name>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>
    # Local data file directory. Make sure you have enough space to download the data files to this directory. For example: /tmp/mydatafiledir 
      DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
     # Data fragment size. Data files are downloaded in fragments. Default fragment size is 500MB.
      MAX_DATA_FRAGMENT_SIZE_IN_MB=500

[UploadDataFiles]
#Upload data files: Upload data files to the target Oracle Analytics Cloud. 
    # Target Oracle Analytics Cloud URL. For example: https://targethost.com:443 or http://targethost.com:9704
      TARGET_URL=http(s)://<Target Oracle Analytics Cloud Host>:<Target Port>
    # Name of a user with Administrator permissions in the target environment. For example: TargetAdmin
      TARGET_USERNAME=<Target Administrator User Name>
    # Local directory containing the data files you want to upload. For example: /tmp/mydatafiledir
      DATA_FRAGMENTS_DIRECTORY=<Data Files Directory>
    # Location of the source snapshot (.bar file). For example:  /tmp/20190307095216.bar
      BAR_PATH=<Path to Source Snapshot>

在本機環境中執行 migrate-oac-data.jar 檔案。
語法：
```
migrate-oac-data.jar [-config configfile] [-d] [-help] [-m]  [-u]
```
其中：
- -config configfile：config.properties 檔案的名稱
- -d：使用 config.properties 中的資訊將資料下載到本機
- -help：顯示說明
- -m：使用 config.properties 檔案中的來源和目標資訊移轉資料
- -u：使用 config.properties 檔案中的資訊上傳資料
例如，若要透過單一步驟移轉資料檔案：
```
java -jar migrate-oac-data.jar -m -config config.properties
```
例如，若要將資料檔案下載到本機：
```
java -jar migrate-oac-data.jar -d -config config.properties
```
例如，若要上傳資料檔案：
```
java -jar migrate-oac-data.jar -u -config config.properties
```
登入目標 Oracle Analytics Cloud。
若要在 Oracle Analytics Cloud 中公開資料檔，必須回復用於第二次移轉剩餘內容的快照。此時，您必須選取自訂回復選項。
1. 開啟「主控台」，然後按一下管理快照。
2. 選取包含您資料檔案的快照。
3. 選取自訂回復選項，然後選取檔案型資料選項。
  取消選取所有其他選項。
4. 按一下回復。
確認您的資料檔案可以使用。