🏢 Agent 수동 설치 (유닉스/AIX)¶
학습 안내
AIX(IBM Unix) 환경에서 Agent 패키지를 수동으로 설치하고 전용 구동 스크립트를 사용하여 서비스를 기동하는 절차를 학습합니다. AIX는 OS 특성상 systemd를 사용하지 않으므로 전용 쉘 스크립트(watchdog_service.sh)를 활용합니다.
1. 사전 준비 (Java 확인)¶
MDRM Agent 구동을 위해서는 Java Runtime Environment(JRE) 1.8 이상이 반드시 필요합니다. AIX 환경은 패키지에 내장 JRE를 포함하지 않으므로, 시스템에 설치된 Java 경로를 JAVA_HOME으로 설정해야 합니다.
# 1. 설치된 Java 버전 확인
java -version
# 2. JAVA_HOME 환경변수 설정 (AIX 표준 경로 예시: /usr/java11_64)
export JAVA_HOME=/usr/java11_64
export PATH=$JAVA_HOME/bin:$PATH
2. Agent 설치 절차¶
대상 AIX 서버에 접속하여 다음 명령어를 순차적으로 실행합니다.
# 1. 설치 디렉토리 생성
mkdir -p /opt/gam_agent
# 2. 설치 경로로 이동 및 압축 해제
cd /opt/gam_agent
# AIX에서는 tar 명령어로 압축 해제 (파일명 확인 필수)
tar xvf gam_agent.tar
# 3. 설치 스크립트 실행
# 형식: ./install.sh [설치경로] [포트] [HTTPS사용여부(기본값 true)]
./install.sh /opt/gam_agent 20080
3. 서비스 기동 및 확인¶
AIX 환경에서는 systemctl 대신 패키지에 포함된 관리 스크립트를 직접 실행합니다.
# 1. Agent 서비스 기동 (Watchdog 포함)
/opt/gam_agent/bin/watchdog_service.sh start
# 2. 프로세스 실행 여부 확인
ps -ef | grep [g]am_agent
정상 가동 시 출력 예시:
root 4587622 1 0 10:22:15 pts/0 0:00 /usr/java11_64/bin/java -jar /opt/gam_agent/gam_agent_watchdog.jar start
root 4587630 4587622 1 10:22:16 pts/0 0:02 /usr/java11_64/bin/java -jar /opt/gam_agent/gam_agent.jar start
4. 안정적인 연동을 위한 재시작¶
주의 사항
수동 설치 직후에는 프로세스가 불안정할 수 있어 MDRM 서버에서의 '가져오기' 작업 시 일시적인 장애가 발생할 수 있습니다. 안전한 연동을 위해 다음 명령어로 Agent를 완전히 종료한 후 다시 기동할 것을 권장합니다.
# 1. 서비스 중지
/opt/gam_agent/bin/watchdog_service.sh stop
# 2. 잔류 프로세스 강제 종료 (Unix/AIX 표준)
# ps로 gam_agent 관련 프로세스를 찾아 강제로 kill 합니다.
ps -ef | grep gam_agent | grep -v grep | awk '{print $2}' | xargs kill -9
# 3. 서비스 다시 시작
/opt/gam_agent/bin/watchdog_service.sh start
5. 설치 확인 사항¶
- 포트 리스닝 확인: 설정한 20080 포트가 정상적으로 Listen 상태인지 확인합니다.
- 권한 확인: 설치 경로의 파일들이 실행 권한(
chmod +x)을 가지고 있는지 확인하십시오.