제한된 가용성: macOS용 Horizon Agent 문제 해결

Horizon Agent 로그 파일

macOS용 Horizon Agent는 다음 위치에 로그 파일을 씁니다.

• /var/log/omnissa/*.log
• /Users/<username>/Library/Logs/Omnissa/*.log
• /var/root/Library/Logs/Omnissa/*.log

연결 문제, 세션 실패 또는 사용 권한 문제를 해결할 때 이러한 로그를 수집합니다. 가장 최근의 로그 항목을 스트리밍하려면 다음을 수행합니다.

tail -f /var/log/omnissa/viewagent-debug.log

Horizon Agent 서비스 확인

Horizon Agent 서비스가 실행 중인지 확인하려면 다음을 수행합니다.

sudo launchctl list | grep omnissa

모든 Horizon Agent 데몬 항목은 종료 코드 0과 함께 출력에 나타나야 합니다. 0이 아닌 종료 코드는 서비스 실패를 나타냅니다.

연결 서버 연결 확인

macOS 시스템이 Horizon Connection Server에 연결할 수 있는지 확인하려면 다음을 수행합니다.

nc -zv <connection-server-fqdn> 443

연결에 성공하면 TCP 포트 443에 연결할 수 있음을 나타냅니다. Blast 세션을 사용하려면 추가 포트를 열어야 합니다. macOS 시스템과 연결 서버 사이에 필수 Horizon 포트가 열려 있는지 확인합니다.

일반적인 문제 및 해결 방법

세션 연결 후 검은색 화면

원인: Horizon Agent에 화면 녹화 사용 권한이 없습니다.

해결 방법: 시스템 설정 > 개인 정보 및 보안 > 화면 녹화에서 화면 녹화 사용 권한을 수동으로 부여하거나 PPPC MDM 프로파일을 배포합니다.

키보드 및 마우스 입력이 작동하지 않음

원인: Horizon Agent에 액세스 지원 또는 입력 모니터링 사용 권한이 없습니다.

해결 방법:****시스템 설정 > 개인 정보 및 보안에서 다음 사용 권한을 검토하고 수동으로 부여합니다.

또는 PPPC MDM 프로파일을 배포하여 이러한 사용 권한을 자동으로 부여합니다.

Horizon Agent가 연결 서버에 등록되지 않음

다음을 확인하십시오.

• macOS 시스템 호스트 이름이 DNS를 통해 올바르게 확인되는지 확인합니다.
• macOS 시스템과 Horizon Connection Server 사이에 TCP 포트 443이 열려 있는지 확인합니다.
• /var/log/omnissa/viewagent-debug.log에서 Horizon Agent 로그 파일을 검토하여 특정 오류 메시지를 확인합니다.

Blast 연결 실패

원인: macOS 방화벽 또는 네트워크 방화벽이 필요한 Blast 포트를 차단합니다.

해결 방법: 필요한 Horizon Blast 포트를 허용하도록 방화벽을 구성합니다. 필요한 포트 목록은 Horizon 8 네트워크 포트 설명서를 참조하십시오.

MDM 프로파일 배포에도 불구하고 나타나는 사용 권한 프롬프트

• 입력 모니터링 및 화면 및 시스템 오디오 녹음 프롬프트가 예상됩니다. Apple은 PPPC 프로파일 구성과 상관없이 MDM이 이러한 사용 권한을 자동으로 부여하는 것을 허용하지 않습니다.
• 액세스 지원을 자동으로 부여할 수 있습니다. 액세스 지원 프롬프트가 나타나면 PPPC 프로파일이 잘못 구성된 것입니다.

액세스 지원 프롬프트가 계속 나타나거나 입력 모니터링 또는 화면 녹화 프롬프트가 전혀 나타나지 않는 경우(프로파일이 표준 사용자가 시스템 서비스를 설정할 수 있도록 허용 설정을 등록하지 못했음을 나타냄) 다음을 확인합니다.

1. UEM Console의 디바이스에서 PPPC 프로파일이 할당됨뿐만 아니라 설치됨으로 표시되는지 확인합니다. 디바이스 > [디바이스] > 프로파일로 이동하여 설치 상태가 설치됨인지 확인합니다. 프로파일이 할당된 후 디바이스가 UEM으로 체크인했는지 확인합니다.

2. PPPC 프로파일에 올바른 번들 식별자가 있는 3개의 개별 애플리케이션 항목이 포함되어 있는지 확인합니다.

   • com.omnissa.horizon.blastworker(액세스 지원 및 입력 모니터링)
   • com.omnissa.horizon.agent(화면 및 시스템 오디오 녹음)
   • com.omnissa.horizon.jre(입력 모니터링)

   참조 시스템의 각 바이너리를 확인하려면 다음 명령을 실행합니다.

   codesign --display -r - /path/to/BlastWorker
   codesign --display -r - /path/to/CaptureAgent
   codesign --display -r - /path/to/HorizonJRE
   

   참고: 최상위 /Applications/Omnissa\ Horizon\ Agent.app에 대해서는 이 명령을 실행하지 마십시오. 코드 요구 사항은 하위 바이너리마다 다릅니다.

3. 각 서비스에 대해 액세스 수준이 올바르게 설정되어 있는지 확인합니다.

   • 액세스 지원 → Allow
   • 화면 캡처 → Allow Standard User to Set System Service
   • 이벤트 수신 → Allow Standard User to Set System Service

   **참고:**화면 캡처 또는 이벤트 수신을 Allow으로 설정해도 사용 권한이 자동으로 부여되지는 않습니다. Apple은 이 두 서비스에 대해 이 설정을 무시합니다. 올바른 값은 사용자가 첫 번째 VDI 실행 시 승인 프롬프트를 수신하도록 하는 Allow Standard User to Set System Service입니다.

4. 위의 모든 설정이 올바르고 사용자에게 여전히 프롬프트가 표시되지 않는 경우 UEM Console에서 디바이스 체크인을 강제 적용합니다.

   • UEM Console에서 디바이스 > [디바이스] > 추가 작업 > 쿼리 > 디바이스 프로파일로 이동합니다.
   • 사용자가 로그아웃했다가 다시 로그인하여 새 세션을 트리거하도록 합니다.

진단 정보 수집

Omnissa 지원을 위한 전체 진단 번들을 수집하려면 Horizon Agent 진단 수집 도구를 실행합니다.

sudo /Library/Omnissa/horizonagent/support/dct-debug.sh

진단 번들이 /tmp/에 저장됩니다. Omnissa 지원에 문의할 때 이 번들을 제공하십시오.

알려진 제한 사항

2606 제한된 가용성 릴리스의 macOS용 Horizon Agent에는 다음과 같은 제한 사항이 적용됩니다.

• 물리적 시스템 전용: 가상 시스템 배포는 지원되지 않습니다.
• Apple Silicon 전용: Intel 기반 Mac 하드웨어는 지원되지 않습니다.
• 단일 세션 전용: 각 macOS 시스템은 하나의 동시 Horizon 세션을 지원합니다. 다중 세션(RDSH)은 지원되지 않습니다.
• 인스턴트 클론 지원 없음: 자동화된 클론 기반 데스크톱 프로비저닝을 사용할 수 없습니다.
• 게시된 애플리케이션 없음: 전체 데스크톱 세션만 지원되며 개별 애플리케이션 게시는 사용할 수 없습니다.
• USB 리디렉션 없음: 클라이언트에 연결된 USB 디바이스를 macOS 데스크톱으로 리디렉션할 수 없습니다.
• 스마트 카드 리디렉션 없음: 리디렉션된 디바이스를 통한 스마트 카드 인증은 지원되지 않습니다.
• 수동 데스크톱 풀에만 해당: 자동화된 및 부동 할당 풀은 지원되지 않습니다.
• 관리되지 않는 디바이스에 사용자 동의 필요: 컴퓨터가 MDM 솔루션에 등록되지 않은 경우 사용자가 macOS 개인 정보 보호 사용 권한을 수동으로 승인해야 합니다.
• 화면 녹화가 지원되지 않음: 화면 녹화는 지원되지 않습니다.
• 하드웨어 가속 인코딩 없음: 하드웨어 가속 비디오 인코딩은 지원되지 않습니다.