다음을 통해 공유

엔터프라이즈 및 교육용 Microsoft 연결된 캐시 문제 해결

이 문서에는 연결된 캐시를 사용하는 동안 발생할 수 있는 다양한 문제를 해결하는 방법에 대한 지침이 포함되어 있습니다. 이러한 문제는 발생할 수 있는 작업에 따라 분류됩니다.

알려진 문제

이 섹션에서는 엔터프라이즈 및 교육용 Microsoft Connected Cache의 최신 릴리스와 관련된 알려진 문제에 대해 설명합니다. 최신 릴리스에 포함된 수정 사항에 대한 자세한 내용은 릴리스 정보 페이지를 참조하세요.

일본어를 사용하도록 구성된 Windows 11 호스트 컴퓨터에서 실행될 때 스크립트 provisionmcconwsl.ps1 실패

provisionmcconwsl.ps1(연결된 캐시 설치 스크립트)에서 검사 처리는 다음 처리에서 설치 작업의 마지막 실행 코드(마지막 결과) 값이 0이 될 때까지 실행됩니다. 그러나 일본어 OS에서는 "마지막 결과"가 표시되고 예외가 발생하므로 반환 값이 null입니다.

임시 해결 방법으로 로컬 관리자 사용자의 언어 설정을 일본어에서 영어로 변경한 다음 스크립트를 실행하여 위의 오류가 발생하지 않습니다.

Azure 구독 ID를 가져오는 단계

  1. Azure Portal 로그인합니다.
  2. 구독을 선택합니다. 구독이 표시되지 않으면 검색 창에 구독을 입력합니다. 입력을 시작하면 입력에 따라 목록이 필터링됩니다.
  3. Azure 구독이 이미 있는 경우 5단계로 건너뜁니다. Azure 구독이 없는 경우 왼쪽 위에서 + 추가 를 선택합니다.
  4. 종량제 구독을 선택합니다. 신용 카드 정보를 입력하라는 메시지가 표시되지만 Microsoft Connected Cache 서비스 사용에 대해서는 요금이 청구되지 않습니다.
  5. 구독 페이지에서 현재 구독 에 대한 세부 정보를 찾을 수 있습니다. 구독 이름을 선택합니다.
  6. 구독 이름을 선택하면 개요 탭에서 구독 ID를 찾을 수 있습니다. 구독 ID 옆에 있는 클립보드로 복사 아이콘을 선택하여 값을 복사합니다.

Azure 리소스 만들기 문제 해결

연결된 캐시 Azure 리소스 만들기는 Azure Portal 사용자 인터페이스 또는 Azure CLI 명령 집합을 사용하여 시작할 수 있습니다.

리소스를 만드는 동안 오류가 발생하는 경우 구독에서 Azure 리소스를 만드는 데 필요한 권한이 있고 리소스 만들기 프로세스 중에 필요한 모든 필드를 입력했는지 검사.

캐시 노드 구성 문제 해결

연결된 캐시 노드의 구성은 Azure Portal 사용자 인터페이스 또는 Azure CLI 명령 집합을 사용하여 수행할 수 있습니다.

유효성 검사 오류가 발생하는 경우 필요한 모든 구성 필드를 입력했는지 검사.

구성이 적용되지 않는 경우 Azure Portal 사용자 인터페이스의 구성 페이지 맨 위에 있는 저장 옵션을 선택한 검사.

프록시 구성을 변경한 경우 프록시 구성이 적용되려면 호스트 컴퓨터에서 연결된 캐시 소프트웨어를 다시 프로비전해야 합니다.

초기 미리 보기 중에 만든 캐시 노드 문제 해결

엔터프라이즈 및 교육용 Microsoft 연결된 캐시 초기 미리 보기 중에 생성 및 배포된 캐시 노드는 계속 작동해야 하지만 연결된 캐시 Azure 서비스를 통해 더 이상 원격으로 관리하거나 모니터링할 수 없습니다.

따라서 Azure에서 기존 리소스를 다시 만들고 최신 OS 관련 설치 관리자를 사용하여 연결된 캐시 소프트웨어를 호스트 머신에 다시 배포하는 것이 좋습니다.

Windows 호스트 컴퓨터에 캐시 노드 배포 문제 해결

Windows 호스팅 설치 로그 수집

Windows 호스트 컴퓨터에 연결된 캐시 노드를 배포하려면 Windows 프로비저닝 패키지에 포함된 일련의 PowerShell 스크립트를 실행해야 합니다. 이러한 스크립트는 프로비저닝 명령(C:\mccwsl01\InstallLogs 기본적으로)에 지정된 설치 디렉터리에 로그 파일을 쓰려고 시도합니다.

다음과 같은 세 가지 유형의 설치 로그 파일이 있습니다.

  1. WSL_Mcc_Install_Transcript: 이 로그 파일은 설치 스크립트를 실행할 때 PowerShell 창에 인쇄된 줄을 기록합니다.
  2. WSL_Mcc_Install_FromRegisteredTask_Status: 이 로그 파일은 등록된 작업 설치 중에 작성된 상위 수준 상태 기록합니다.
  3. WSL_Mcc_Install_FromRegisteredTask_Transcript: 이 로그 파일은 등록된 작업 설치 중에 작성된 자세한 상태 기록합니다.

등록된 작업 성적 증명서는 일반적으로 설치 문제를 진단하는 데 가장 유용합니다.

다른 Windows 호스팅 로그 수집

캐시 노드가 Windows 호스트 컴퓨터에 성공적으로 설치되면 정기적으로 로그 파일을 설치 디렉터리(C:\mccwsl01\ 기본적으로)에 씁니다.

다음과 같은 유형의 로그 파일을 볼 수 있습니다.

  1. WSL_Mcc_Monitor_FromRegisteredTask_Transcript: 이 로그 파일은 연결된 캐시가 계속 실행되도록 하는 "MCC_Monitor_Task" 예약된 작업의 출력을 기록합니다.
  2. WSL_Mcc_UserUninstall_Transcript: 이 로그 파일은 사용자가 호스트 컴퓨터에서 MCC 소프트웨어를 제거하는 데 실행할 수 있는 "uninstallmcconwsl.ps1" 스크립트의 출력을 기록합니다.
  3. WSL_Mcc_Uninstall_FromRegisteredTask_Transcript: 이 로그 파일은 "uninstallmcconwsl.ps1" 스크립트에서 호출할 때 호스트 컴퓨터에서 MCC 소프트웨어를 제거하는 작업을 담당하는 "MCC_Uninstall_Task" 예약된 작업의 출력을 기록합니다.

그룹 정책 개체가 예약된 작업 등록과 충돌

그룹 정책 개체 사용: 네트워크 액세스: 네트워크 인증에 대한 암호 및 자격 증명의 스토리지를 허용하지 않으면 연결된 캐시 소프트웨어가 성공적인 캐시 노드 등록 및 작업에 필요한 예약된 작업을 등록하지 못하게 됩니다.

"지정된 로그온 세션이 없습니다"라는 메시지와 함께 WSL2를 설치하지 못했습니다.

Windows 호스트 컴퓨터에서 PowerShell 명령을 wsl.exe --install --no-distribution 실행하려고 할 때 이 오류 메시지가 발생하는 경우 로컬 관리자로 로그온하고 관리자 권한 PowerShell 창에서 명령을 실행했는지 확인합니다.

WSL2 커널 업데이트

WSL 관련 문제로 인해 연결된 캐시 설치가 실패하는 경우 를 실행 wsl.exe --update 하여 최신 버전의 WSL 커널을 가져옵니다.

연결된 캐시 컨테이너가 실행 중인지 확인

연결된 캐시 소프트웨어가 Windows 호스트 컴퓨터에 성공적으로 배포되면 Windows 호스트 컴퓨터에서 다음을 수행하여 캐시 노드가 제대로 실행되고 있는지 검사 수 있습니다.

  1. 연결된 캐시 설치 중에 런타임 계정으로 지정된 계정으로 PowerShell 프로세스를 시작합니다.
  2. 를 실행 wsl -d Ubuntu-22.04-Mcc-Base 하여 연결된 캐시 컨테이너를 호스트하는 Linux 배포판에 액세스
  3. 를 실행 sudo iotedge list 하여 IoT Edge 런타임 내에서 실행 중인 컨테이너를 표시합니다.

edgeAgent 및 edgeHub 컨테이너가 표시되지만 MCC가 표시되지 않는 경우 를 사용하여 sudo iotedge system logs -- -fIoT Edge 보안 관리자의 상태 볼 수 있습니다.

를 사용하여 sudo systemctl restart iotedgeIoT Edge 런타임을 다시 부팅할 수도 있습니다.

연결된 캐시 예약된 작업 확인

연결된 캐시 컨테이너가 실행되면 예약된 작업이 연결된 캐시 런타임 계정으로 주기적으로 실행되어 WSL이 연결된 캐시 컨테이너를 정리하지 못하도록 합니다.

호스트 컴퓨터에서 작업 스케줄러를 사용하여 이 예약된 작업의 상태 검사 수 있습니다.

  1. 호스트 컴퓨터에서 작업 스케줄러 열기
  2. 활성 작업 섹션으로 이동하고 MCC_Monitor_Task 두 번 클릭합니다.
  3. 예약된 작업 MCC_Monitor_Task 선택합니다.
  4. 트리거 탭을 선택하고 상태가 사용 상태인지 확인합니다.

참고

런타임 계정의 암호가 변경되면 연결된 캐시 노드가 계속 제대로 작동하려면 연결된 캐시 예약된 모든 작업에서 사용자를 업데이트해야 합니다.

캐시 노드가 성공적으로 배포되었지만 요청을 처리하지 않음

캐시 노드가 localhost 외부의 요청에 응답하지 않는 경우 연결된 캐시 설치 중에 호스트 컴퓨터의 포트 전달 규칙이 올바르게 설정되지 않았기 때문일 수 있습니다. WSL 2는 기본적으로 가상화된 이더넷 어댑터를 사용하므로 트래픽이 LAN에서 WSL 2 instance 도달할 수 있도록 포트 전달 규칙이 필요합니다. 자세한 내용은 WSL을 사용하여 네트워크 애플리케이션 액세스를 참조하세요.

호스트 컴퓨터의 포트 전달 규칙을 검사 하려면 다음 PowerShell 명령을 사용합니다.

netsh interface portproxy show v4tov4

포트 80에서 0.0.0.0에 대한 포트 전달 규칙이 표시되지 않으면 관리자 권한 PowerShell instance 다음 명령을 실행하여 적절한 전달을 WSL로 설정할 수 있습니다.

netsh interface portproxy add v4tov4 listenport=80 listenaddress=0.0.0.0 connectport=80 connectaddress=<WSL IP Address>

연결된 캐시 프로비저닝 명령(기본적으로 "c:\mccwsl01")에 지정한 설치 디렉터리에 있어야 하는 파일에서 wslip.txt WSL IP 주소를 검색할 수 있습니다.

Linux 호스트 컴퓨터에 캐시 노드 배포 문제 해결

Linux 호스트 컴퓨터에 연결된 캐시 노드를 배포하려면 Linux 프로비저닝 패키지에 포함된 일련의 Bash 스크립트를 실행해야 합니다.

연결된 캐시 소프트웨어가 Linux 호스트 컴퓨터에 성공적으로 배포되면 Linux 호스트 컴퓨터에서 다음을 수행하여 캐시 노드가 제대로 실행되는지 검사 수 있습니다.

  1. 를 실행 sudo iotedge list 하여 IoT Edge 런타임 내에서 실행 중인 컨테이너를 표시합니다.

edgeAgent 및 edgeHub 컨테이너가 표시되지만 MCC가 표시되지 않는 경우 를 사용하여 sudo iotedge system logs -- -fIoT Edge 보안 관리자의 상태 볼 수 있습니다.

를 사용하여 sudo systemctl restart iotedgeIoT Edge 런타임을 다시 부팅할 수도 있습니다.

캐시 노드 진단 지원 번들 생성

설치 패키지에 포함된 스크립트를 실행 collectMccDiagnostics.sh 하여 자세한 진단 정보가 포함된 지원 번들을 생성할 수 있습니다.

Windows 호스트 컴퓨터의 경우 다음을 수행해야 합니다.

  1. 연결된 캐시 설치 중에 런타임 계정으로 지정된 계정으로 PowerShell 프로세스를 시작합니다.

  2. 디렉터리를 추출된 연결된 캐시 프로비저닝 패키지 내의 "MccScripts" 디렉터리로 변경하고 의 존재를 확인합니다. collectmccdiagnostics.sh

  3. 를 실행 wsl bash collectmccdiagnostics.sh 하여 진단 지원 번들을 생성합니다.

  4. 스크립트가 완료되면 진단 지원 번들의 위치를 설명하는 콘솔 출력을 확인합니다.

    예를 들어 "패키지를 압축했습니다. /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz 만든 파일을 보내주세요."

  5. wsl cp 명령을 실행하여 Ubuntu 배포 내의 위치에서 Windows 호스트 OS로 지원 번들을 복사합니다.

    예를 들어 wsl cp /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz /mnt/c/mccwsl01/SupportBundles

Linux 호스트 컴퓨터의 경우 다음을 수행해야 합니다.

  1. 디렉터리를 추출된 연결된 캐시 프로비저닝 패키지 내의 "MccScripts" 디렉터리로 변경하고 의 존재를 확인합니다. collectmccdiagnostics.sh

  2. 를 실행 collectmccdiagnostics.sh 하여 진단 지원 번들을 생성합니다.

  3. 스크립트가 완료되면 진단 지원 번들의 위치를 설명하는 콘솔 출력을 확인합니다.

    예를 들어 "패키지를 압축했습니다. /etc/mccdiagnostics/support_bundle_2024_12_03__11_05_39__AM.tar.gz 만든 파일을 보내주세요."

캐시 노드 모니터링 문제 해결

연결된 캐시 노드 상태 및 성능은 Azure Portal 사용자 인터페이스를 사용하여 모니터링할 수 있습니다.

개요 탭의 기본 모니터링 시각적 개체에 예기치 않거나 잘못된 값이 표시되는 경우 브라우저 창을 새로 고칩니다.

문제가 지속되면 타임스팬 및 캐시 노드 필터를 원하는 대로 구성한 검사.

진단 및 해결

Azure Portal 인터페이스에서 제공하는 문제 진단 및 해결 기능을 사용할 수도 있습니다. Microsoft Connected Cache Azure 리소스 내의 이 탭은 문제에 대한 해결 방법을 좁히는 데 도움이 되는 몇 가지 프롬프트를 안내합니다.