Snowball Edge デバイスへの更新のダウンロード

Snowball Edge の更新をダウンロードするには、次の 2 つの方法があります。

• 特定の Snowball Edge クライアントのコマンドを使用して、随時手動で更新をトリガーできます。

• デバイスを自動的に更新する時間をプログラムで決定できます。

以下の処理は、手動で更新をダウンロードするプロセスを説明しています。Snowball Edge デバイスの自動更新に関する詳細は、「Updating a 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 コマンドを使用してロック解除します。詳細については、「Unlocking the Snowball Edge」を参照してください。

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. ターミナルウィンドウを開き、snowballEdge describe-device コマンドでクラスター内のすべての Snowball Edge デバイスがロック解除されていることを確認します。デバイスがロックされている場合は、snowballEdge unlock-cluster コマンドを使用してロック解除します。詳細については、「Unlocking the 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 の場合、更新のダウンロードが完了していて、インストールできるようになっています。