🐧 Agent 수동 설치 (Linux)¶
학습 안내
보안이 강화된 Linux 환경에서 Agent 패키지를 직접 설치하고 서비스를 안정적으로 기동시키는 절차를 학습합니다.
1. Agent 설치 절차¶
대상 서버에 접속하여 다음 명령어를 순차적으로 실행합니다.
# 1. 설치 디렉토리 생성
mkdir -p /opt/gam_agent
# 2. 설치 경로로 이동 및 압축 해제
cd /opt/gam_agent
tar zxvf gam_agent.withJreX64.tar.gz
# 3. 설치 스크립트 실행
# 형식: ./install.sh [설치경로] [포트] [HTTPS사용여부(기본값 true)]
./install.sh /opt/gam_agent 20080
2. 설치 및 가동 확인¶
설치가 완료되면 Agent는 기본적으로 자동으로 가동됩니다. 다음 명령어로 프로세스 상태를 확인합니다.
정상 가동 시 출력 예시:
root 14995 /opt/gam_agent/jre/bin/java -jar /opt/gam_agent/gam_agent_watchdog.jar start
root 15010 /opt/gam_agent/jre/bin/java -jar /opt/gam_agent/gam_agent.jar start
2.1 주요 프로세스 설명¶
gam_agent.jar: Agent 서비스의 핵심 주체입니다.gam_agent_watchdog.jar: Agent 프로세스의 생존 여부를 감시하고 장애 시 자동으로 재기동합니다.
3. 안정적인 연동을 위한 재시작¶
주의 사항
수동 설치 직후에는 프로세스가 불안정할 수 있어 MDRM 서버에서의 '가져오기' 작업 시 일시적인 장애가 발생할 수 있습니다. 안전한 연동을 위해 다음 명령어로 Agent를 완전히 재시작할 것을 권장합니다.
# 1. 서비스 중지 및 잔류 프로세스 제거
systemctl stop gam_agent
pkill -ecf gam_agent
# 2. 서비스 시작
systemctl start gam_agent
# 3. 리스닝 포트 확인 (20080)
ss -antpl | grep 20080