한 인스턴스에서 다른 인스턴스로 ACC 전환

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2026년 01월 09일
  • 읽기3분

    • 다른 에이전트 클라이언트 수집기 (ACC) 인스턴스로 전환합니다.

    시작하기 전에

    (ACC)를 에이전트 클라이언트 수집기 설치하고 ACC 등록 키를 설정했는지 확인합니다. 설정 및 설치 방법에 대한 자세한 내용은 다음을 참조하십시오.

    필요한 역할: agent_admin 및 agent_client_collector_admin

    역할에 대한 자세한 내용은 Agent Client Collector user roles 문서를 참조하십시오.

    이 태스크 정보

    ACC가 이미 한 인스턴스에 연결되어 있는 경우 acc.yml에서 구성을 변경하여 에이전트를 다른 인스턴스로 전환할 수 있습니다.

    프로시저

    1. 운영 체제에 적합한 단계를 수행하여 ACC를 중지합니다.
      • 의 경우 Windows관리자 권한으로 서비스에 액세스하고 서비스를 중지합니다 에이전트 클라이언트 수집기 .
      • 의 경우 macOSsudo launchctl unload -w /Library/LaunchDaemons/com.sn.acc.plist; 명령을 실행합니다.
    2. acc.yml 파일을 엽니다.
      • Windows: C:\ProgramData\ServiceNow\agent-client-collector\config
      • macOS: /Library/Application\ Support/servicenow/agent-client-collector/
    3. backend-url 매개변수를 편집하여 <ITOM 클라우드 서비스 게이트웨이>를 지정합니다.
      인스턴스 위치를 기준으로 다음 게이트웨이를 사용합니다.
      • AMER: itomcnc-prod-gateway-amer.sncapps.service-now.com:443
      • EMEA: itomcnc-prod-gateway-emea.sncapps.service-now.com:443
      • APAC: itomcnc-prod-gateway-apac.sncapps.service-now.com:443

      에이전트가 ITOM 클라우드 서비스 게이트웨이를 사용하는 방법에 대한 자세한 내용은 DEX 아키텍처 문서를 참조하십시오.

    4. 다음 매개변수를 업데이트합니다.
      • connect-without-mid: true
      • instance-url: <full_instance_url>, 예: https://dex.servicenow.com
      • registration-key: <등록 키 값>

        등록 키를 생성하는 방법에 대한 자세한 내용은 ACC 등록 키 생성 문서를 참조하십시오.

    5. 파일을 저장합니다.
    6. 운영 체제에 따라 파일을 삭제합니다.
      • 에서 Windows/agent-client-collector/config/cert/cnc 로 이동하여 cnc_chain.crt 및 priv_key.pem.go 파일을 제거합니다.
      • 에서 macOS/Library/Application Support/servicenow/agent-client-collector/cert/cnc 에 액세스하여 cnc_chain.crt 및 priv_key.pem 파일을 삭제합니다.
    7. 운영 체제에 따라 다음 폴더를 삭제합니다.
      • 에서 Windows/agent-client-collector/cache 폴더를 삭제합니다.
      • 에 macOS:
        • 에이전트 3.4.1 이상에서는 /Library/Application Support/servicenow/agent-client-collector/cache 폴더를 삭제합니다.
        • 에이전트 3.4.0 이하에서는 /Library/Caches/servicenow/agent-client-collector 폴더를 삭제합니다.
    8. 옵션: 이전에 이 ACC를 다른 인스턴스에 연결한 경우 다음을 수행합니다.
      1. 장치 일련 번호를 복사합니다.
      2. Agent Client Collector 테이블(sn_agent_cmdb_ci_agent)에서 장치 일련 번호를 사용하여 검색합니다.
        주:
        사용할 수 없는 경우 목록 뷰에 에이전트 ID 열을 추가합니다.
      3. 기록을 찾으면 해당 기록을 에이전트 ID로 복사합니다.
      4. 에이전트 등록 테이블(sn_agent_agent_registration)에서 에이전트 ID 기록을 사용하여 검색합니다.
      5. 검색 결과로 생성된 모든 기록을 삭제합니다.
    9. 운영 체제별 단계에 따라 ACC 서비스를 시작합니다.
      • 에서 Windows관리자 권한으로 서비스를 연 다음, 를 시작합니다 에이전트 클라이언트 수집기.
      • 에서 macOSsudo launchctl load -w /Library/LaunchDaemons/com.sn.acc.plist 명령을 사용합니다.