이 문서에는 디바이스 업데이트 사용자가 보고한 몇 가지 일반적인 질문과 문제가 나열되어 있습니다. 디바이스 업데이트가 공개 미리 보기를 통해 진행됨에 따라 이 문제 해결 가이드는 새로운 질문과 솔루션으로 주기적으로 업데이트됩니다. 이 문제 해결 가이드에 표시되지 않는 문제가 발생하는 경우 Microsoft 지원 문의 섹션을 참조하여 상황을 문서화합니다.
업데이트 가져오기
Q: 디바이스 업데이트 인스턴스를 IoT Hub 인스턴스에 연결하는 데 문제가 있습니다.
Device Update 리소스 설명서에 따라 IoT Hub 메시지 경로가 올바르게 구성되었는지 확인하세요.
Q: 역할 관련 오류(Azure Portal의 오류 메시지 또는 403 API 오류)가 발생합니다.
액세스 권한이 올바르게 구성되지 않았을 수 있습니다. 디바이스 업데이트 액세스 제어 설명서에 따라 액세스 권한을 올바르게 구성했는지 확인하세요.
Q: 디바이스 업데이트 서비스로 콘텐츠를 가져올 때 500 형식 오류가 발생합니다.
500 범위의 오류 코드는 디바이스 업데이트 서비스에 문제가 있음을 나타낼 수 있습니다. 5분 동안 기다린 다음 다시 시도하세요. 동일한 오류가 지속되면 microsoft 지원 문의 섹션의 지침에 따라 Microsoft에 지원 요청을 제출하세요.
Q: 동일한 호환성 속성을 유지하려고 하지만(내 업데이트를 동일한 디바이스 유형으로 대상 지정) 가져오기 매니페스트에서 공급자 또는 이름을 변경합니다. 하지만 "실패: 제한 초과로 인해 업데이트를 가져오는 동안 오류가 발생했습니다."라는 오류가 발생합니다.
동일한 호환성 속성 집합을 둘 이상의 업데이트 공급자 및 이름 조합과 함께 사용할 수 없습니다. 이를 통해 디바이스 업데이트 서비스는 지정된 디바이스에 배포할 수 있어야 하는 업데이트를 확실하게 결정할 수 있습니다. 단일 디바이스에서 여러 구성 요소 또는 파티션을 업데이트해야 하는 경우 프록시 업데이트 기능은 해당 기능을 제공합니다.
Q: 콘텐츠를 가져올 때 오류 메시지가 표시되고 자세한 내용을 이해하려고 합니다.
가져오기 관련 오류 메시지에 대한 자세한 내용은 디바이스 업데이트 오류 코드 설명서를 참조하세요.
디바이스 오류
Q: 디바이스가 IoT Hub용 디바이스 업데이트에 연결되어 있는지 확인하려면 어떻게 해야 하나요?
디바이스가 Azure Portal의 준수 보기에 있는 "그룹화되지 않은" 디바이스 섹션 아래에 표시되는지 확인하여 디바이스가 디바이스 업데이트에 연결되어 있는지 확인할 수 있습니다.
Q: 하나 이상의 디바이스가 업데이트되지 않습니다.
디바이스 업데이트 실패의 근본 원인은 여러 가지가 있습니다. 디바이스가 1) IoT Hub 인스턴스에 연결되고, 2) 디바이스 업데이트 인스턴스에 연결되고, 3) DO(배달 최적화) 서비스가 실행 중인지 확인하세요. 디바이스에 대한 세 가지 모두 사실인 경우, Microsoft 지원 문의 섹션의 지침에 따라 Microsoft에 지원 요청을 하세요.
업데이트 배포
Q: 내 디바이스에 업데이트를 배포했지만 준수 상태에 최신 업데이트가 없다고 표시됩니다. 제가 뭘 해야 하나요?
디바이스 준수 상태를 새로 고치는 데 최대 5분이 걸릴 수 있습니다. 잠시 기다렸다가 다시 확인하세요.
Q: 디바이스의 배포 상태가 호환되지 않는 것으로 표시되면 어떻게 해야 하나요?
IoT Hub에 디바이스를 연결한 후 대상 디바이스의 제조업체 및 모델 속성이 변경되어 디바이스가 현재 배포의 업데이트 콘텐츠와 호환되지 않는 것으로 간주될 수 있습니다.
ADU Core 인터페이스 확인하여 디바이스가 디바이스 업데이트 서비스에 보고하는 제조업체 및 모델을 확인하고 배포되는 업데이트 콘텐츠의 가져오기 매니페스트 지정한 제조업체 및 모델과 일치하는지 확인합니다. 디바이스 업데이트 구성 파일사용하여 지정된 디바이스에 대해 이러한 속성을 변경할 수 있습니다.
Q: 내 배포가 "활성" 단계에 있지만 업데이트가 "진행 중"인 디바이스가 없습니다. 제가 뭘 해야 하나요?
배포 시작 날짜가 나중에 설정되지 않았는지 확인합니다. 새 배포를 만들 때 배포 시작 날짜는 명시적으로 변경하지 않는 한 기본값으로 다음 날로 설정됩니다. 배포 시작 날짜가 될 때까지 기다리거나 진행 중인 배포를 취소하고 원하는 시작 날짜로 새 배포를 만들 수 있습니다.
Q: 내 디바이스를 그룹화하려고 하지만 그룹을 만들 때 드롭다운에 태그가 표시되지 않습니다.
Device Update 리소스 설명서에 따라 IoT Hub에서 메시지 경로를 올바르게 구성했는지 확인합니다. 경로를 구성한 후 디바이스에 다시 태그를 지정해야 합니다.
또 다른 근본 원인은 디바이스를 IoT Hub용 디바이스 업데이트에 연결하기 전에 태그를 적용한 것일 수 있습니다. 디바이스가 이미 디바이스 업데이트에 연결되어 있는지 확인합니다. 디바이스가 준수 보기의 "그룹화되지 않은" 디바이스 아래에 표시되는지 확인하여 디바이스가 IoT Hub용 디바이스 업데이트에 연결되어 있는지 확인할 수 있습니다. 일시적으로 다른 값의 태그를 추가한 다음 디바이스가 연결되면 원하는 태그를 다시 추가합니다.
DPS(Device Provisioning Service)를 사용하는 경우 디바이스를 프로비전한 후 디바이스 생성 프로세스가 아닌 태그를 지정해야 합니다. 디바이스 만들기 단계에서 디바이스에 이미 태그를 지정한 경우 프로비전된 후 일시적으로 다른 값으로 디바이스에 태그를 지정한 다음 원하는 태그를 다시 추가해야 합니다.
Q: 배포가 성공적으로 완료되었지만 일부 디바이스를 업데이트하지 못했습니다.
이는 실패한 디바이스의 클라이언트 쪽 오류로 인해 발생했을 수 있습니다. 이 문제 해결 가이드의 디바이스 오류 섹션을 참조하세요.
Q: 배포를 시작할 때 UX에서 오류가 발생했습니다.
이는 서비스/UX 버그 또는 API 권한 문제로 인해 발생했을 수 있습니다. Microsoft 지원 문의 섹션의 지침에 따라 Microsoft에 지원 요청을 제출하세요.
Q: 배포를 시작했지만 최종 상태에 도달하지 않습니다.
서비스 성능 문제, 서비스 버그 또는 클라이언트 버그로 인해 발생할 수 있습니다. 10분 후에 배포를 다시 시도하세요. 동일한 문제가 발생하는 경우 디바이스 로그를 끌어오고 이 문제 해결 가이드의 디바이스 오류 섹션을 참조하세요. 동일한 문제가 지속되면 microsoft 지원 문의 섹션의 지침에 따라 Microsoft에 지원 요청을 제출하세요.
Q: 디바이스 수준 에이전트에서 디바이스에서 모듈 ID로 에이전트를 추가하도록 마이그레이션했으며, 디바이스에 적용된 경우에도 업데이트가 '진행 중'으로 표시됩니다.
이 문제는 디바이스 트윈을 통해 통신하는 이전 에이전트를 제거하지 않은 경우 발생할 수 있습니다. 디바이스 업데이트 에이전트를 모듈로 프로비전할 때(방법참조) 디바이스와 디바이스 업데이트 서비스 간의 모든 통신은 모듈 쌍을 통해 수행되므로 그룹을 만들 때 디바이스의 모듈 쌍에 태그를 지정해야 하며 모든 통신은 모듈 쌍을 통해 발생해야 합니다.
디바이스에 업데이트 다운로드
Q: 연결이 끊긴 후 디바이스가 다시 연결되면 다운로드를 다시 시작하려면 어떻게 해야 하나요?
24시간 내에 연결이 복원되면 다운로드가 자체 재개됩니다. 24시간 후에는 사용자가 다운로드를 다시 시작해야 합니다.
MCC(Microsoft Connected Cache) 사용
Q: IoT Edge 디바이스에 MCC 모듈을 배포하려고 할 때 문제가 발생합니다.
IoT Edge 디바이스에 Edge 모듈을 배포하는 IoT Edge 설명서를 참조하세요. http://localhost:5100/Summary. 이동하여 MCC 모듈이 IoT Edge 디바이스에서 성공적으로 실행되고 있는지 확인할 수 있습니다.
Q: 내 IoT 디바이스 중 하나가 MCC를 통해 업데이트를 다운로드하려고 하지만 실패합니다.
IoT 디바이스가 MCC에 연결하지 못할 수 있는 몇 가지 문제가 있습니다. 문제를 진단하려면 실패한 디바이스에서 DO 클라이언트 및 Nginx 로그를 수집하세요(클라이언트 로그 수집에 대한 지침은 Microsoft 지원 문의 섹션 참조).
사용하는 URL이 허용되지 않으므로 디바이스가 인터넷에서 콘텐츠를 끌어와 MCC 모듈로 전달하지 못할 수 있습니다. 확인하려면 Azure Portal에서 IoT Edge 환경 변수를 확인해야 합니다.
Microsoft 지원에 문의
위의 FAQ를 사용하여 해결할 수 없는 문제가 발생하는 경우 Azure Portal 인터페이스를 통해 Microsoft 지원에 지원 요청을 제출할 수 있습니다. 문제가 속한 범주에 따라 Microsoft 지원에서 문제를 조사할 수 있도록 추가 데이터를 수집하고 공유하라는 메시지가 표시될 수 있습니다.
각 데이터 형식을 수집하는 방법에 대한 지침은 아래를 참조하세요. getDevices 사용하여 API의 페이로드 응답에서 추가 정보를 확인할 수 있습니다.
또한 다음 정보는 문제의 근본 원인을 좁히는 데 유용할 수 있습니다.
- 업데이트하려는 디바이스 유형(Azure Percept, IoT Edge 게이트웨이, 기타)
- 사용 중인 디바이스 업데이트 클라이언트 유형(이미지 기반, 패키지 기반, 시뮬레이터)
- 디바이스가 실행 중인 OS
- 디바이스 아키텍처에 대한 세부 정보
- 디바이스 업데이트를 사용하여 이전에 디바이스를 업데이트했는지 여부
위의 정보를 사용할 수 있는 경우 문제에 대한 설명에 포함하세요.
클라이언트 로그 수집
Raspberry Pi 디바이스에는 다음과 같은 두 가지 로그 집합이 있습니다.
/adu/logs/var/cache/do-client-lite/log패키지된 클라이언트의 경우 로그는 다음과 같습니다.
/var/log/adu/var/cache/do-client-lite/log시뮬레이터의 경우 로그는 다음과 같습니다.
/tmp/aduc-logs
오류 코드
업데이트 가져오기, 디바이스 오류 또는 업데이트 배포와 관련된 문제를 보고할 때 오류 코드를 제공하라는 메시지가 표시될 수 있습니다.
오류 코드는 ADUCoreInterface 인터페이스를 확인하여 가져올 수 있습니다. 자체 진단 및 문제 해결을 위해 오류 코드를 구문 분석하는 방법에 대한 자세한 내용은 디바이스 업데이트 오류 코드 설명서를 참조하세요.
추적 ID
업데이트 가져오기 또는 배포와 관련된 문제를 보고할 때 추적 ID를 제공하라는 메시지가 표시될 수 있습니다.
지정된 사용자 작업에 대한 추적 ID는 API 응답 또는 Azure Portal 사용자 인터페이스의 가져오기 기록 섹션에서 찾을 수 있습니다.
현재 배포 작업에 대한 추적 ID는 API 응답을 통해서만 액세스할 수 있습니다.
배포 ID
업데이트 배포와 관련된 문제를 보고할 때 배포 ID를 제공하라는 메시지가 표시될 수 있습니다.
배포 ID는 배포를 시작하기 위해 API를 호출할 때 사용자가 만듭니다.
현재 Azure Portal 사용자 인터페이스에서 시작된 배포에 대한 배포 ID는 자동으로 생성되고 사용자에게 표시되지 않습니다.
IoT Hub 인스턴스 이름
디바이스 오류 또는 업데이트 배포와 관련된 문제를 보고할 때 IoT Hub 인스턴스의 이름을 입력하라는 메시지가 표시될 수 있습니다.
IoT Hub 이름은 처음 프로비전될 때 사용자가 선택합니다.
디바이스 업데이트 계정 이름
업데이트 가져오기, 디바이스 오류 또는 업데이트 배포와 관련된 문제를 보고할 때 디바이스 업데이트 계정의 이름을 입력하라는 메시지가 표시될 수 있습니다.
디바이스 업데이트 계정 이름은 서비스에 처음 등록할 때 사용자가 선택합니다. 자세한 내용은 디바이스 업데이트 리소스 설명서에서 찾을 수 있습니다.
디바이스 업데이트 인스턴스 이름
업데이트 가져오기, 디바이스 오류 또는 업데이트 배포와 관련된 문제를 보고할 때 디바이스 업데이트 인스턴스의 이름을 입력하라는 메시지가 표시될 수 있습니다.
디바이스 업데이트 인스턴스 이름은 처음 프로비전될 때 사용자가 선택합니다. 자세한 내용은 디바이스 업데이트 리소스 설명서에서 찾을 수 있습니다.
디바이스 ID
디바이스 오류와 관련된 문제를 보고하거나 업데이트를 배포할 때 디바이스 ID를 제공하라는 메시지가 표시될 수 있습니다.
디바이스 ID는 디바이스가 처음 프로비전될 때 고객이 정의합니다. 디바이스의 Device Twin에서 검색할 수 있습니다.
ID 업데이트
업데이트 배포와 관련된 문제를 보고할 때 업데이트 ID를 제공하라는 메시지가 표시될 수 있습니다.
업데이트 ID는 배포를 시작할 때 고객이 정의합니다.
Nginx 로그
Microsoft Connected Cache와 관련된 문제를 보고할 때 Nginx 로그를 제공하라는 메시지가 표시될 수 있습니다.
ADU-conf.txt
업데이트 배포와 관련된 문제를 보고할 때 디바이스 업데이트 구성 파일("adu-conf.txt")을 제공하라는 메시지가 표시될 수 있습니다.
구성 파일은 선택 사항이며 디바이스 업데이트 구성 설명서의 지침에 따라 사용자가 만듭니다.
매니페스트 가져오기
업데이트 가져오기 또는 배포와 관련된 문제를 보고할 때 가져오기 매니페스트 파일을 제공하라는 메시지가 표시될 수 있습니다.
가져오기 매니페스트는 업데이트 콘텐츠를 디바이스 업데이트 서비스로 가져올 때 고객이 만든 파일입니다.
다음 단계: 디바이스 업데이트 오류 코드 대한 자세한 정보