기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# Snowball Edge 디바이스에 업데이트 다운로드
<a name="download-updates"></a>

Snowball Edge에 대한 업데이트를 다운로드할 수 있는 두 가지 방법이 있습니다.
+ 특정 Snowball Edge 클라이언트 명령을 사용하여 언제든 수동 업데이트를 트리거할 수 있습니다.
+ 프로그래밍 방식으로 디바이스를 자동으로 업데이트할 시간을 결정할 수 있습니다.

다음 절차는 수동 업데이트 다운로드 프로세스를 간략하게 설명합니다. Snowball Edge 디바이스의 자동 업데이트에 대한 자세한 내용은 [Snowball Edge 업데이트](https://docs.aws.amazon.com/snowball/latest/developer-guide/using-client-commands.html#update-client-commands)의 `configure-auto-update-strategy`를 참조하십시오.

**참고**  
디바이스에서 인터넷에 액세스할 수 없는 경우 [GetSoftwareUpdates](https://docs.aws.amazon.com/snowball/latest/api-reference/API_GetSoftwareUpdates.html) API를 사용하여 업데이트 파일을 다운로드할 수 있습니다. 그리고 다음 예와 같이 `uri` 파라미터를 사용하여 `download-updates`를 직접적으로 호출할 때 로컬 파일 위치를 가리킵니다.  

```
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` 명령을 사용하여 잠금 해제합니다. 자세한 내용은 [Snowball Edge 잠금 해제](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html)를 참조하세요.

1. 디바이스가 잠금 해제되면 `snowballEdge check-for-updates` 명령을 사용합니다. 이 명령은 Snowball Edge 소프트웨어의 최신 사용 가능한 버전을 반환하고, 디바이스의 현재 설치된 버전을 반환합니다.

1. 디바이스 소프트웨어가 최신이 아닌 경우 `snowballEdge download-updates` 명령을 실행합니다.
**참고**  
디바이스가 인터넷에 연결되어 있지 않으면 먼저 [GetSoftwareUpdates](https://docs.aws.amazon.com/snowball/latest/api-reference/API_GetSoftwareUpdates.html) 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
   ```

1. `snowballEdge describe-device-software` 명령을 사용하여 다운로드 상태를 확인할 수 있습니다. 업데이트를 다운로드하는 동안 이 명령을 사용하면 상태가 표시됩니다.  
**Example `describe-device-software` 명령의 출력**  

   ```
   Install State: Downloading
   ```

**디바이스의 클러스터를 위한 Snowball Edge 소프트웨어 업데이트를 확인하고 다운로드하려면**

1. 터미널 창을 열고 클러스터의 모든 Snowball Edge 디바이스가 `snowballEdge describe-device` 명령으로 잠금 해제되었는지 확인합니다. 디바이스가 잠긴 경우 `snowballEdge unlock-cluster` 명령을 사용하여 잠금 해제합니다. 자세한 내용은 [Snowball Edge 잠금 해제](https://docs.aws.amazon.com/snowball/latest/developer-guide/unlockdevice.html)를 참조하세요.

1. 클러스터의 모든 디바이스가 잠금 해제되면 클러스터의 각 디바이스에 대해 `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                    
   ```
**참고**  
잠금 해제 코드와 매니페스트 파일은 클러스터의 모든 디바이스에서 동일합니다.  
**Example / `check-for-updates` 명령**  

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

   `LatestVersion` 이름 값이 `InstalledVersion` 이름 값보다 큰 경우 업데이트를 사용할 수 있습니다.

1. 클러스터의 각 디바이스에 대해 `download-updates` 명령을 사용하여 업데이트를 다운로드합니다.

   ```
   snowballEdge download-updates --uri file:///tmp/local-update
   ```
**참고**  
Windows 운영 체제의 경우 `uri` 파라미터 값의 형식을 다음과 같이 지정합니다.  

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

1. 클러스터의 각 디바이스에 대한 이 다운로드 상태를 확인하려면 `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    
   ```  
**Example / `describe-device-software` 명령의 출력**  

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

   `InstallState` 이름 값이 `DOWNLOADED`인 경우 업데이트가 다운로드 완료되고 설치할 수 있습니다.