macOS Agent 설치
========================

에이전트 다운로드 및 설치
---------------------------

#. **관리 > 시스템 > 에이전트 패키지** 에서 에이전트 패키지를 업로드 합니다.
#. macOS 아키텍처 상관 없이 설치 파일을 다운로드 합니다. 이 때, **다운로드 받은 실행 파일의 이름은 변경하지 않도록 합니다.**
#. 다운로드한 실행 파일을 직접 더블클릭하여 설치하거나, PMS 등을 통해 설치합니다.

   설치 과정 중 다음과 같은 사용자 권한 요청 창이 표시될 수 있으며, 아래 절차에 따라 진행합니다:

   - **“프로그램 설치 허용”** 버튼 클릭
   - **macOS 사용자 암호 입력**
   - **“소프트웨어 설치”** 버튼 선택하여 설치 완료

에이전트 패키지 관리
~~~~~~~~~~~~~~~~~~~~

1. 패키지(.gpf) 파일 업로드 시, 버전 정보 및 업로드 시간 등 에이전트 패키지를 관리 할 수 있는 기능을 제공합니다.
2. 업로드된 패키지들은 에이전트 배포 관리에서 배포 버전을 선택하여 사용할 수 있습니다.

에이전트 업데이트
-----------------

.. warning::

   **관리 > 설정 > 시스템** 의 에이전트 자체 업데이트 설정이 ``ON`` 으로 설정돼 있어야 합니다.

에이전트 배포 관리
~~~~~~~~~~~~~~~~~~

Genian EDR은 스크립트를 통한 에이전트 초기 설치 후, 자체 배포관리 시스템을 통해 지속적인 배포 관리 기능을 제공하고 있습니다.  
**관리 > 시스템 > 에이전트 배포 관리** 에서 배포 관리를 설정을 할 수 있습니다.

1. 에이전트 배포할 그룹을 선택합니다.
2. **작업선택 > {선택 | 전체} 에이전트 업데이트 즉시 수행** 버튼을 통해 즉시 배포가 가능합니다.
3. **배포 설정** 에서 자동 업데이트가 가능합니다.
4. **배포 설정** 에서 에이전트 버전 설정이 가능합니다.

에이전트 업데이트 확인
~~~~~~~~~~~~~~~~~~

1. 에이전트 배포 완료 시, 완료된 단말의 상태에 ``✔`` 표시가 나타납니다.
2. 감사 로그를 통해 배포된 Agent의 설치 및 업데이트 로그를 확인 할 수 있습니다.

macOS 에이전트 설치 확인
----------------------------

1. **분석 > 엔드포인트 목록** 를 선택합니다.
2. 엔드포인트 목록에서 에이전트가 설치된 단말을 확인 할 수 있습니다.

macOS 단말 에이전트 로그 위치
--------------------------------------------------

- macOS에서 **터미널** 열어서 아래의 위치의 로그파일을 확인합니다.
     - 설치경로: ~/Library/Application Support/GenianInsights 
     - 로그경로: ~/Library/Application Support/GenianInsights/agent.log

macOS 지원 목록
-----------------------------

.. csv-table:: 
   :header: "macOS", "버전"
   :widths: 30 40

   "macOS Big Sur", "11.0 이상"