Skip to main content
이 가이드는 Mac 컴퓨터 및 Windows 컴퓨터에 적용됩니다

​
에이전트 체크인 문제 정보

Iru Endpoint에 등록된 macOS 및 Windows 컴퓨터는 다양한 관리 작업에 Iru Agent를 사용합니다. 에이전트는 15분마다 체크인을 시도합니다. 디바이스가 예상대로 체크인하지 않는 경우 다음 단계를 통해 통신을 복원할 수 있습니다.
2026년 4월 8일부로 앱의 브랜딩이 Kandji 에서 Iru 로 업데이트되었습니다. 앱 이름이 Kandji Self Service에서 Iru Self Service로, Kandji Agent에서 Iru Agent로 변경되었습니다. 수동 등록 포털도 이제 Iru 브랜딩을 사용합니다. 이전 앱 이름을 여전히 참조하는 스크립트, 자동화 및 유틸리티를 업데이트하십시오.

​
작동 방식

Iru Agent는 Iru Endpoint 서버와 통신하여 구성 업데이트, 정책 변경 및 애플리케이션 배포를 받습니다. 체크인이 실패하면 디바이스가 중요한 업데이트를 받지 못해 규정 준수 문제나 오래된 구성이 발생할 수 있습니다.

​
인터넷 연결 확인

디바이스가 엔터프라이즈 네트워크에서 Iru 사용에 설명된 도메인 및 포트에 액세스할 수 있는 활성 인터넷 연결을 갖추고 있는지 확인하십시오. 빠른 문제 해결 단계는 다음과 같습니다.
  • 모바일 핫스팟과 같은 다른 네트워크에 디바이스를 연결해 봅니다
  • 체크인이 재개되면 원래 네트워크의 필터링 또는 방화벽 구성에 문제가 있을 수 있습니다

​
플랫폼별 문제 해결

​
체크인 강제 실행(macOS)

​
Self Service

  • 최종 사용자는 Iru Self Service를 열고 Device Info로 이동하여 동기화를 선택할 수 있습니다

​
명령줄

  • Terminal에서 다음 명령을 실행하여 체크인을 강제로 실행합니다.
출력에 추가 세부 정보가 표시될 수 있습니다.

​
Iru Agent 재설치

macOS에서는 Iru 웹 앱에서 Iru Agent를 재설치할 수 있습니다.
1

디바이스 레코드에 액세스

Iru 웹 앱에서 디바이스 레코드로 이동합니다
2

에이전트 재설치

디바이스 작업 메뉴에서 Reinstall Agent를 선택합니다
3

설치 상태 모니터링

활동 탭에서 상태를 모니터링합니다. InstallEnterpriseApplication MDM 명령을 찾습니다
명령이 NotNow(디바이스가 사용 중)를 반환하는 경우:
  • Mac에 사용자가 로그인되어 있고 전원에 연결되어 있는지 확인한 후 다시 시도하십시오. Apple 개발자 문서를 참조하십시오

​
재시동 고려 사항

  • 재시동 후 Iru는 macOS가 업데이트 및 백그라운드 작업을 완료할 수 있도록 체크인하기까지 최대 30분 동안 기다릴 수 있습니다

​
에이전트 상태 확인

에이전트 상태 확인:

​
재시동

디바이스를 재시동하면 멈춘 프로세스가 해결되어 Iru Agent가 정상적인 체크인을 재개할 수 있습니다.

​
다시 등록

위 단계로 문제가 해결되지 않으면 디바이스를 수동으로 다시 등록하십시오.
1

기존 등록 제거

기존 MDM 등록을 제거합니다
2

디바이스 다시 등록

올바른 등록 코드를 사용하여 다시 등록합니다
디바이스를 등록할 때 올바른 Blueprint가 선택되었는지 확인하십시오. 다른 Blueprint를 선택하면 디바이스는 해당 Blueprint에 할당된 Library Items 및 Parameters를 적용합니다. 다시 등록한 후에도 디바이스 레코드는 중복되지 않습니다. Iru Endpoint는 새 등록을 기존 디바이스 레코드에 연결합니다.

​
고급 문제 해결

다음 항목에 대한 로그를 검토합니다.
  • 설치 오류
  • 정책 실패
  • 통신 문제
  • 네트워크 연결 문제

​
네트워크 진단

1

연결 테스트

네트워크 진단 도구를 사용하여 Iru 서비스에 대한 연결을 테스트합니다
2

방화벽 확인

방화벽 규칙이 Iru 도메인과의 통신을 허용하는지 확인합니다
3

DNS 테스트

Iru 도메인에 대한 DNS 확인이 작동하는지 확인합니다
4

프록시 확인

해당하는 경우 프록시 설정을 확인합니다

​
일반적인 문제 및 해결 방법

증상:
  • Iru에서 디바이스가 오프라인으로 표시됨
  • 디바이스 레코드에 최근 체크인이 없음
  • 정책이 적용되지 않음
해결 방법:
  • 인터넷 연결 확인
  • 디바이스 재시동
  • 수동 체크인 강제 실행
  • 필요한 경우 에이전트 재설치
증상:
  • 에이전트 로그의 오류 메시지
  • 네트워크 연결 문제
  • 방화벽이 통신을 차단함
해결 방법:
  • 네트워크 연결 확인
  • 방화벽 규칙 확인
  • 다른 네트워크로 테스트
  • 에이전트 로그에서 특정 오류 검토
증상:
  • 등록 후 에이전트가 설치되지 않음
  • 로그의 설치 오류
  • 디바이스가 Iru에 표시되지 않음
해결 방법:
  • 디바이스가 요구 사항을 충족하는지 확인
  • 등록 중 네트워크 연결 확인
  • 설치 로그 검토

​
모범 사례

정기적으로 모니터링

디바이스 체크인 상태를 정기적으로 모니터링하여 문제를 조기에 식별하십시오

연결 테스트

관리되는 디바이스에서 Iru 서비스에 대한 네트워크 연결을 테스트하십시오

로그 검토

잠재적인 문제가 있는지 에이전트 로그를 정기적으로 검토하십시오

문제 문서화

향후 참조를 위해 반복되는 문제와 해결 방법을 문서화하십시오