---
sourceDocument: 호주 IT Operations Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/it-operations-management

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 IT Operations Management

ft:clusterId :

    - itom

bundleId :

    - itom

workflow :

    - Technology


---

# macOS에 ACC 수동 설치

# 에 수동 설치 에이전트 클라이언트 수집기macOS {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

에이전트가 인스턴스에 연결되지 않았거나 고급 커스터마이제이션 옵션을 원할 때 사용하는 macOS 머신에 수동으로 설치 에이전트 클라이언트 수집기 합니다.

## 시작하기 전에

* 웹 서버가 구성되어 에이전트 클라이언트 수집기 있는지 확인합니다.
* [에이전트 클라이언트 수집기 설치](https://servicenow-prod.fluidtopics.net/Z~if0HsczKu3oKrvNdjbYg "지원되는 호스트 머신에 설치할 에이전트 클라이언트 수집기 수 있습니다. 에이전트 클라이언트 수집기 HTTP/S 프로토콜을 사용하여 연결되며 MID 서버 설정된 후에도 연결이 활성 상태로 유지됩니다. 하나는 MID 서버 여러 에이전트를 동시에 처리할 수 있지만 단일 에이전트는 한 번에 하나 MID 서버 씩 작동하며 페일오버 보호를 제공하기 위해 필요한 경우 다른 MID 서버 에이전트로 전환합니다.")에 설명된 대로 서버의 OS와 버전이 지원되는 OS 버전의 목록과 일치하는지 확인합니다.
* /Library/Preferences/acc.rc.plist에 있는 골든 이미지 마커를 설정하여 추가 에이전트를 복제하기 위한 골든 이미지 모드를 활성화합니다.
* 다음으로 이동 에이전트 클라이언트 수집기배포에이전트 다운로드 OS와 관련된 서명된 .pkg 다운로드합니다.
* 설치된 에이전트 중 하나에 .pkg 설치 패키지를 저장합니다.

{#acc-install-macOS-manual__ul_m15_ygq_nqb}

필요한 역할: agent_client_collector_admin

## 프로시저

1. 설치 파일을 모두 로컬 머신에 다운로드합니다.  

       curl -L <download link from the Agent Downloads page on the instance>

2. 설치 파일의 서명을 확인합니다.  

       pkgutil --check-signature agent-client-collector-<version number>-macos-catalina_x64.pkg

   주:  
   패키지 인증서 체인에 개발자 ID 설치 관리자 인증서가 ServiceNow 있는지 확인합니다.
3. 패키지를 설치합니다 에이전트 클라이언트 수집기 .  

       sudo installer -pkg agent-client-collector-<version number>-macos-catalina_x64.pkg -target /

4. 설치 파일을 복사합니다.
   1. 샘플 구성 파일:  
      sudo cp -p /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml.example /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml
   2. 샘플 허용 목록 파일:  
      sudo cp -p /Library/Application\\ Support/servicenow/agent-client-collector/check-allow-list.json.default /Library/Application\\ Support/servicenow/agent-client-collector/check-allow-list.json
   {#acc-install-macOS-manual__substeps_lgw_fhq_nqb}
5. **옵션:** 허용 목록에 포함될 새 검사 정의를 생성하려면 먼저 acc.yml 파일의 매개변수를 allow-list 주석으로 처리하여 허용 목록을 비활성화합니다.  
   sudo -H -u _servicenow vi /Library/Application\\ Support/servicenow/agent-client-collector/acc.yml  
   주:  
   이 작업은 시스템의 보안을 손상할 수 있으며 허용 목록 업데이트를 완료할 때까지 임시 조치로만 수행하는 것이 좋습니다. 업데이트를 완료한 후에는 구성 파일에서 허용 목록 매개변수에 대한 주석을 제거하여 허용 목록을 다시 활성화합니다.

   허용 목록에 사용자 지정 검사를 추가하는 방법에 대한 자세한 내용은 [허용 목록 생성 에이전트 클라이언트 수집기](https://servicenow-prod.fluidtopics.net/TlklIBKSVJTbpzZ9IlmSFQ "에이전트에서 실행할 수 있는 검사 목록에 포함할 검사를 지정합니다.") 문서를 참조하십시오.
6. 구성 파일을 저장합니다.
7. 구성 파일에서 에이전트 MID 서버를 .
   1. 연결을 설정합니다 MID 서버 .  

          "wss://<MID Server IP>:<Web Socket Port>/ws/events"

      웹소켓 포트는 수신기로 에이전트 클라이언트 수집기 설정될 때 구성 MID 서버 되었습니다.
   2. 매개변수를 api-key 찾아 다음과 같이 큰따옴표 안에 API 키 값을 지정합니다.  
      api-key:"111111111"  
      지정된 API 키는 에이전트가 처음 실행될 때 암호화됩니다.
   {#acc-install-macOS-manual__substeps_sth_nhq_nqb}
8. 구성 파일이 유효한 엔드포인트를 가리키도록 하려면 다음 명령을 실행하여 에이전트 클라이언트 수집기를 다시 시작합니다.  

       sudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist
       sudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist

   주:  
   기본적으로 설치 프로그램을 종료하면 프로그램이 즉시 다시 시작됩니다. 종료 후에도 프로그램이 중지된 상태로 유지되도록 하려면 /Library/LaunchDaemons/com.sn.acc.plist 파일에서 KeepAlive 속성을 false로 설정합니다.