更新裝載
執行下列步驟來更新裝載︰
1. 準備輸入檔案。
2. 更新裝載。
先決條件:
• Amazon S3 儲存帳戶使用 Windchill 進行配置。
• Windchill 伺服器已啟動且正在執行。
準備輸入檔案
使用指令行公用程式 PrepareInputDataForMountMigrationTool,產生 CSV 格式的報告。然後,您可以使用此 CSV 報告作為 MountMigrationTool 的輸入來更新裝載。此報告儲存在 <Windchill>/logs/MountMigration/ 目錄中。此報告包含下列資訊:
• 根資料夾 - 所有可用根資料夾的清單。
• 來源主機
• 來源裝載路徑
• 來源裝載類型
• 目標裝載路徑
• 目標裝載類型 - 依預設,目標裝載類型為 azureBlob。
欲列出所有可能的指令行選項,請從 Windchill shell 中執行下列指令:
windchill wt.fv.tools.datamigration.PrepareInputDataForMountMigrationTool mount -h
有效引數的清單如下:
• -h = <help> - 說明
• -u = <username> - 管理員使用者名稱
• -p = <password> - 管理員密碼
• -v = <verbose> - 在偵錯模式下執行公用程式
• -b = <bucketName> - 目標貯體名稱
• -t = <mountType> - 目標裝載類型 (預設裝載類型為 azureBlob)
欲產生報告,請從 Windchill shell 中執行下列指令:
windchill wt.fv.tools.datamigration.PrepareInputDataForMountMigrationTool mount -u <userName> -p <password> -t <mountType>
當將裝載從一個 Amazon S3 儲存移轉至另一個 Amazon S3 儲存時,請使用 -b 引數提供目標貯體名稱,並使用 -t 引數將目標裝載類型設定為 amazonS3。工具會根據來源裝載路徑的目標貯體名稱與目錄結構自動產生目標裝載路徑。
如果您要將裝載從檔案型儲存庫或 Azure Blob 儲存移轉至 Amazon S3 儲存,請在 CSV 報告中手動輸入目標裝載路徑。在此情況下,工具不會自動產生目標裝載路徑。
|
• 來源 Amazon S3 儲存與目標 Amazon S3 儲存中的儲存庫目錄結構應該相同,才能使用 -b 引數產生正確的目標裝載路徑。如果目錄結構不相同,則必須手動輸入目標裝載路徑。
• 如果找到包含 AutoFolderCreation=false 內容的根資料夾,Windchill shell 中會顯示錯誤。如需解決此錯誤,請執行 wt.fv.tools.FolderToRootFolderConverter 工具。
• 如果您要將裝載從檔案型儲存庫移轉至其他檔案型儲存庫,請在 CSV 報告中手動輸入目標裝載路徑。在此情況下,工具不會自動產生目標裝載路徑。
|
更新裝載
您可使用在上一步產生的 CSV 報告作為輸入檔案來透過 MountMigrationTool 更新裝載。
欲列出所有可能的指令行選項,請執行下列指令:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -h
有效引數的清單如下:
• -h = <help> - 說明
• -u = <username> - 管理員使用者名稱
• -p = <password> - 管理員密碼
• -v = <verbose> - 在偵錯模式下執行公用程式
• -r = <rootFolderName> - 根資料夾的名稱。
• -t = <newMountType> - 裝載類型。有效值為 amazonS3 與 azureBlob。
• -m = <newMountPath> - Amazon S3 或 Blob 儲存中的裝載路徑。
• -i = <inputFile> - 輸入 CSV 檔案路徑。
從 Windchill shell 執行下列指令,可同時變更所有根資料夾的裝載類型與裝載路徑︰
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -i <inputFile>
從 Windchill shell 執行下列指令,可一次變更一個根資料夾的裝載類型與裝載路徑︰
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -r <RootFolder name> -m <mount path on Amazon S3 Storage> -t amazonS3
例如:
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -u <username> -p <password> -r defaultuploadfolder1 -m Testbucket/defaultup -t amazonS3
以 -i 引數執行完公用程式之後,摘要會顯示下列狀況:
• 成功 - 已成功移轉之根資料夾的名稱。
• 失敗 - 無法移轉之根資料夾的名稱。
• 已略過 - 已略過之根資料夾的名稱,因為它們已在之前的執行中成功移轉。
您也可以在執行公用程式後,在輸入 CSV 檔案中檢視裝載移轉狀況。您可使用相同的輸入 CSV 檔案多次執行 MountMigrationTool。
|
在移轉期間,如果現有根資料夾在輸入檔案中有鏡像根裝載路徑,則只會處理主要路徑,並捨棄次要路徑。
|
作為指令行工具的替代方式,您可以從「儲存庫組態」使用者介面取消裝載根資料夾,並針對 Azure Blob 進行裝載。請注意,當從使用者介面執行這些操作時,使用者不得存取根資料夾中的內容。如果您使用
-r、
-t 與
-m 引數移轉單一裝載,請從儲存庫組態使用者介面移除已移轉根資料夾的
Read Only 旗標。在
準備系統以進行移轉部份新建立的根資料夾可能包含不需要作為此儲存庫移轉流程一部份移出根資料夾的檔案。
儲存庫移轉流程完成後,請重新建立重新存放與內容複寫排程,並配置內容 wt.fv.faultTolerantVaultsAutoRestore。
指令摘要
windchill wt.fv.tools.FolderToRootFolderConverteraws
s3 cp C:\PTC\Windchill\vaults\defaultuploadvault s3://Testbucket/defaultuploadvault –recursive
snowball.bat start -i <ip address> -u <unlock code> -m <manifest file path>
snowball.bat ls
snowball.bat test -r <vault mount path on host machine>
snowball.bat mkdir s3://<bucketname>/<vaultname>
snowball.bat cp -r <path to vault> s3://<bucketname>/<vaultname>
snowball.bat validate <path on Amazon Snowball>
snowball.bat stopwindchill com.ptc.windchill.objectstorage.amazons3.tools.S3ConfigurationTool configure -u <username> -p <password>
windchill wt.fv.tools.datamigration.DataMigrationVerificationTool validateMigratedData -r <srcRootFolderName> -t <targetMountType> -m <targetMountPath> -u <userName> -p <password>
windchill wt.fv.tools.datamigration.MountMigrationTool migrate -r defaultuploadrootfolder -t amazonS3 -m Testbucket/defaultuploadvault -u <userName> -p <password>