.. _linux-agent:

Linux 에이전트 설치
========================

CWP 페이지를 통하여 설치스크립트를 다운로드하고 스크립트 수행하여 에이전트를 설치 할 수 있습니다. 
 - Linux OS를 사용하는 단말은 플랫폼 분류를 통하여 **서버** 노드타입으로 등록됩니다. 


Linux 에이전트 설치
---------------------------

#. 에이전트 다운로드

   -  \https://(*IP 또는 도메인*)/agent

#. 에이전트 선택 : 파일명 충돌을 피하기 위해 파일 이름을 변경하지 마십시오.
  
   -  Linux 버전 : gnlnxagent_(*IP 또는 FQDN*)

#. 에이전트 설치 토큰

   - **환경설정 > 에이전트** 의 **토큰 미사용 에이전트 차단** 옵션이 활성화 되어 있을 경우 사용자는 에이전트 설치 할 때 설치 토큰을 입력해야 합니다.
  
CWP를 통한 Linux 에이전트 설치
-------------------------------

Genian ZTNA에서 에이전트 설치방법은 여러가지가 존재합니다. 아래 다양한 방법중 가장 일반적인 CWP 페이지 접속하여 에이전트 설치방법 안내입니다. 
 - CWP 페이지 직접 접속하여 에이전트 설치파일 다운로드
 - 에이전트 미설치단말을 차단하여 CWP로 유도하여 설치

#. CWP 페이지에 접속합니다. \https://*정책서버IP*/agent
#. OS별 에이전트 아이콘에서 리눅스 아이콘을 선택하고 파일을 다운로드합니다. 
#. Linux 배포판에서 **터미널** 열어서 **Download** 폴더로 이동합니다. (우분투 기준)

   .. note:: 리눅스 배포판에 따라서 리눅스 에이전트 설치 스크립트의 다운로드 경로가 다를 수 있습니다.

#. 다운로드디렉토리에 설치 스크립트를 아래와 같이 실행합니다.

   -  cd ~/Download
   -  chmod 755 ./lnxagent_*서버주소*.sh
   -  sudo ./lnxagent_*서버주소*.sh

    .. note:: 사용자에게 파일 설치 권한이 없는 경우 설치 프로그램을 실행할 수 없으므로, 관리자 권한으로 실행해야합니다. 스크립트가 종료되면 자동으로 프로세스가 구동됩니다. 
    

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

#. WEB콘솔 접속을 합니다.
#. **관리 > 노드** 메뉴로 이동합니다.
#. 설치한 노드의 IP를 검색합니다. 
#. 노드 리스트화면에서 에이전트 아이콘이 표시되면 정상적으로 설치 및 정보등록이 완료된 상태입니다.

Linux 배포판에서 에이전트 로그를 찾는 위치
--------------------------------------------------

- Linux 배포판에서 **터미널** 열어서 아래의 위치의 로그파일을 확인합니다.

   - 설치경로: /usr/share/genians
   - 로그경로: /var/log/genians
   - 설정 파일 경로: /usr/share/genias/GenianDB
   - PID 파일 경로: /var/run/genians

.. _linux-agent-os-info:

Linux 에이전트 지원 OS 목록
-----------------------------
.. csv-table::   
   :header: "Linux OS", "버전", "v6.0.x 이상"
   :widths: 30 40 30

   "Ubuntu", "18 ~ 24", "6.0.5 ~"
   "Gooroom", "2 ~ 4", "6.0.5 ~"
   "HamoniKR", "3.0 ~ 4.0", "6.0.0 ~"
   "Hancom Gooroom", "2 ~ 3", "6.0.5 ~"
   "Tmax Gooroom", "2, 21", "6.0.5 ~"