下載更新至 Snowball Edge 裝置

有兩種方式可以下載 Snow Family 裝置的更新：

• 您可以隨時使用特定的 Snowball Edge 用戶端命令觸發手動更新。

• 您可以透過程式設計方式判斷時間，以自動更新裝置。

下列程序概述手動下載更新的程序。如需有關自動更新 Snowball Edge 裝置的資訊，請參閱更新 Snowball Edge configure-auto-update-strategy中的 。

注意

如果您的裝置無法存取網際網路，您可以使用 GetSoftwareUpdates 下載更新檔案API。然後在download-updates使用 uri 參數呼叫 時指向本機檔案位置，如下列範例所示。

snowballEdge download-updates --uri file:///tmp/local-update

對於 Windows 作業系統，請格式化 uri 參數的值，如下所示：

snowballEdge download-updates --uri file:/C:/path/to/local-update

檢查和下載獨立裝置的 Snowball Edge 軟體更新

1. 開啟終端機視窗，並確保 Snowball Edge 裝置已使用 describe-device命令解除鎖定。如果裝置已鎖定，請使用 unlock-device 命令來解除鎖定。如需詳細資訊，請參閱解除鎖定 Snow Family 裝置 。

2. 裝置解除鎖定時，執行 snowballEdge check-for-updates 命令。此命令會傳回 Snowball Edge 軟體的最新可用版本，以及裝置上安裝的目前版本。

3. 如果您的裝置軟體已過時，請執行 snowballEdge download-updates 命令。

   注意

   如果您的裝置未連線至網際網路，請先使用 GetSoftwareUpdates 下載更新檔案API。然後使用 uri 參數搭配您下載檔案的本機路徑來執行 snowballEdge download-updates命令，如下列範例所示。

   snowballEdge download-updates --uri file:///tmp/local-update

   對於 Windows 作業系統，請格式化 uri 參數的值，如下所示：

   snowballEdge download-updates --uri file:/C:/path/to/local-update

4. 您可以使用 snowballEdge describe-device-software 命令來檢查此下載的狀態。下載更新時，您可以使用此命令顯示 狀態。

   範例 describe-device-software 命令的輸出

   
   Install State: Downloading
       

檢查和下載裝置叢集的 Snowball Edge 軟體更新

1. 開啟終端機視窗，並確保叢集中的所有 Snowball Edge 裝置都使用 snowballEdge describe-device命令解除鎖定。如果裝置已鎖定，請使用 snowballEdge unlock-cluster命令將其解除鎖定。如需詳細資訊，請參閱解除鎖定 Snowball Edge 。

2. 當叢集中的所有裝置都解除鎖定時，請針對叢集中的每個裝置執行 check-for-updates命令。此命令會傳回 Snowball Edge 軟體的最新可用版本，以及裝置上安裝的目前版本。

   
   snowballEdge check-for-updates --unlock-code 29-character-unlock-code --manifest-file path/to/manifest/file.bin --endpoint https://ip-address-of-snow-device                    
                   

   注意

   叢集中所有裝置的解鎖碼和資訊清單檔案都相同。

   範例 check-for-updates 命令的

   
   {
   "InstalledVersion" : "118",
   "LatestVersion" : "119"
   }                       
                      

   如果LatestVersion名稱的值大於InstalledVersion名稱的值，則會提供更新。

3. 針對叢集中的每個裝置，使用 download-updates命令下載更新。

   
   snowballEdge download-updates --uri file:///tmp/local-update

   注意

   對於 Windows 作業系統，請格式化 uri 參數的值，如下所示：

   snowballEdge download-updates --uri file:/C:/path/to/local-update

4. 若要檢查叢集中每個裝置此下載的狀態，請使用 describe-device-software命令。

   
   snowballEdge describe-device-software --unlock-code 29-character-unlock-code --manifest-file path/to/manifest/file.bin --endpoint https://ip-address-of-snow-device    
   

   範例 describe-device-software 命令的輸出

   
   {
   "InstalledVersion" : "118",
   "InstallingVersion" : "119",
   "InstallState" : "DOWNLOADED",
   "CertificateExpiry" : "Sat Mar 30 16:47:51 UTC 2024"
   }        
       

   如果InstallState名稱的值為 DOWNLOADED，則更新會完成下載並可供安裝。