安裝 Snowball Edge 裝置的更新 - AWS Snowball Edge 開發人員指南

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

安裝 Snowball Edge 裝置的更新

下載更新後，您必須安裝更新並重新啟動裝置，更新才會生效。下列程序會引導您手動安裝更新。

對於 Snowball Edge 裝置的叢集，必須將更新下載至叢集中的每個裝置並安裝更新。

注意

在安裝軟體更新之前，請先暫停裝置上的所有活動。安裝更新會停止執行執行個體，並中斷裝置上 Amazon S3 儲存貯體的任何寫入。這可能會導致資料遺失

安裝已下載至獨立 Snow Family 裝置的軟體更新

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

  2. 執行 list-services命令以查看裝置上可用的服務。命令會傳回裝置上每個可用IDs服務的服務。

    
snowballEdge list-services
    範例 list-services 命令的輸出
    
{
  "ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ]
}

  3. 對於 list-services命令識別的每個服務 ID，請執行 describe-service命令以查看 狀態。使用此資訊來識別要停止的服務。

    
snowballEdge describe-service --service-id service-id
    範例 describe-service 命令的輸出
    
{
"ServiceId" : "s3",
  "Status" : {
    "State" : "ACTIVE"
  },
"Storage" : {
"TotalSpaceBytes" : 99608745492480,
"FreeSpaceBytes" : 99608744468480
},
"Endpoints" : [ {
"Protocol" : "http",
"Port" : 8080,
"Host" : "192.0.2.0"
}, {
"Protocol" : "https",
"Port" : 8443,
"Host" : "192.0.2.0",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/6d955EXAMPLEdb71798146EXAMPLE3f0"
  }
 } ]
}

    此輸出顯示s3服務作用中，必須使用 stop-service命令停止。

  4. 使用 stop-service命令來停止每個 服務，其中State名稱的值位於 list-services命令的輸出ACTIVE中。如果執行多個服務，請先停止每個服務，然後再繼續。

    注意

    IAM Amazon S3 轉接器、Amazon EC2 AWS STS和服務無法停止。如果 Snow Family 裝置上的 Amazon S3 相容儲存正在執行，請在安裝更新之前停止它。Snow Family 裝置上的 Amazon S3 相容儲存體s3-snow做為 serviceId。

    
snowballEdge stop-service --service-id service-id --device-ip-addresses snow-device-1-ip-address snow-device-device-2-ip-address snow-device-3-ip-address --manifest-file path/to/manifest/file.bin --unlock-code 29-character-unlock-code --endpoint https://snow-device-ip-address
    範例 stop-service 命令的輸出
    
Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

  5. 執行 snowballEdge install-updates 命令。

  6. 您可以使用 snowballEdge describe-device-software 命令來檢查此安裝的狀態。安裝更新時，您會使用此命令顯示 狀態。

    範例輸出

    Install State: Installing //Possible values[NA, Installing, Requires Reboot]

    您已成功為 Snowball Edge 裝置安裝軟體更新。安裝更新不會自動將更新套用到裝置。若要完成更新的安裝，必須重新啟動裝置。

    警告

    重新啟動 Snow Family 裝置而不停止裝置上的所有活動，可能會導致資料遺失。

  7. 當裝置上的所有服務停止時，重新啟動裝置、解除鎖定裝置，然後再次重新啟動裝置。如此即完成下載軟體更新的安裝。如需重新啟動裝置的詳細資訊，請參閱重新啟動 Snow Family 裝置 。如需解除鎖定裝置的詳細資訊，請參閱解除鎖定 Snowball Edge

  8. 當裝置在第二次重新啟動後開啟電源時，請解除鎖定裝置。

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

安裝已下載至 Snowball Edge 裝置叢集的軟體更新

  1. 對於叢集中的每個裝置，執行 describe-device命令來判斷裝置是否已解除鎖定。如果裝置已鎖定，請使用 unlock-cluster命令將其解除鎖定。如需詳細資訊，請參閱解除鎖定 Snowball Edge 。

  2. 對於叢集中的每個裝置，執行 list-services命令以查看裝置上可用的服務。命令會傳回裝置上每個可用IDs服務的服務。

    
snowballEdge list-services
    範例 list-services 命令的輸出
    
{
  "ServiceIds" : [ "greengrass", "fileinterface", "s3", "ec2", "s3-snow" ]
}

  3. 對於 list-services命令識別的每個服務 ID，請執行 describe-service命令以查看 狀態。使用此資訊來識別要停止的服務。

    
snowballEdge describe-service --service-id service-id
    範例 describe-service 命令的輸出
    
{
"ServiceId" : "s3",
  "Status" : {
    "State" : "ACTIVE"
  },
"Storage" : {
"TotalSpaceBytes" : 99608745492480,
"FreeSpaceBytes" : 99608744468480
},
"Endpoints" : [ {
"Protocol" : "http",
"Port" : 8080,
"Host" : "192.0.2.0"
}, {
"Protocol" : "https",
"Port" : 8443,
"Host" : "192.0.2.0",
"CertificateAssociation" : {
"CertificateArn" : "arn:aws:snowball-device:::certificate/6d955EXAMPLEdb71798146EXAMPLE3f0"
  }
 } ]
}

    此輸出顯示s3服務作用中，必須使用 stop-service命令停止。

  4. 對於叢集中的每個裝置，使用 stop-service命令來停止每個服務，其中State名稱的值位於list-services命令的輸出ACTIVE中。如果執行多個服務，請先停止每個服務，然後再繼續。

    注意

    IAM Amazon S3 轉接器、Amazon EC2 AWS STS和服務無法停止。如果 Snow Family 裝置上的 Amazon S3 相容儲存正在執行，請在安裝更新之前停止它。Snow Family 裝置上的 Amazon S3 相容儲存體s3-snow做為 serviceId。

    
snowballEdge stop-service --service-id service-id --device-ip-addresses snow-device-1-ip-address snow-device-device-2-ip-address snow-device-3-ip-address --manifest-file path/to/manifest/file.bin --unlock-code 29-character-unlock-code --endpoint https://snow-device-ip-address
    範例 stop-service 命令的輸出
    
Stopping the AWS service on your Snowball Edge. You can determine the status of the AWS service using the describe-service command.

  5. 對於叢集中的每個裝置，執行 install-updates命令。

    
snowballEdge install-updates

  6. 您可以使用 describe-device-software 命令來檢查此安裝的狀態。

    
snowballEdge describe-device-software
    範例 describe-device-service 命令的輸出
    
Install State: Installing //Possible values[NA, Installing, Requires Reboot]

    當 Install State為 時Requires Reboot，您已成功安裝 Snowball Edge 裝置的軟體更新。安裝更新不會自動將更新套用到裝置。若要完成更新的安裝，必須重新啟動裝置。

    警告

    重新啟動 Snowball Edge 裝置而不停止裝置上的所有活動，可能會導致資料遺失。

  7. 重新啟動叢集中的所有裝置、解除鎖定叢集，並重新重新啟動叢集中的所有裝置。如此即完成下載軟體更新的安裝。如需重新啟動裝置的詳細資訊，請參閱重新啟動 Snow Family 裝置 。如需解除鎖定裝置叢集的詳細資訊，請參閱解除鎖定 Snowball Edge 。

  8. 叢集中的每個裝置重新啟動兩次後，請解除鎖定叢集，然後使用 check-for-updates命令來驗證裝置是否已更新。此命令會傳回 Snowball Edge 軟體的最新可用版本，以及裝置上安裝的目前版本。如果目前版本和最新的可用版本相同，裝置已成功更新。

您現在已成功更新 Snow Family 裝置或裝置叢集，並確認更新至最新的 Snow Family 軟體。