Windows 에이전트 설치 가이드

Windows 서버 또는 워크스테이션에 GIIP 에이전트를 설치하여 관리를 시작하는 방법을 안내합니다.

📋 개요

GIIP Windows 에이전트는 PowerShell 기반으로 작동하며, 서버의 성능 수집, 로그 분석, 보안 관제 기능을 수행합니다. 설치 과정은 매우 간단하며 별도의 재부팅이 필요하지 않습니다.

🛠️ 설치 전 준비 사항

• 운영체제: Windows Server 2012 R2 이상 (Windows 10/11 지원)
• 권한: 관리자(Administrator) 권한 필요
• 인증 정보: GIIP 콘솔의 [내 정보] 메뉴에서 CSN, Access Key(AK), Secret Key(SK)를 미리 준비하세요.

🚀 설치 단계

1. 에이전트 파일 다운로드

GIIP 콘솔의 [에이전트 관리] 페이지에서 giipAgent_Windows.zip 파일을 다운로드하거나, 제공된 PowerShell 명령어를 복사하여 실행하세요.

2. 압축 해제 및 경로 설정

• C:\giipAgent 와 같은 접근이 용이한 경로에 압축을 해제합니다.
• 주의: 한글이나 공백이 포함된 경로보다는 영문 위주의 짧은 경로를 권장합니다.

3. 인증 정보 구성

giipAgent.cfg 파일을 메모장으로 열어 다음 항목을 입력하고 저장합니다.

• CSN: 고객사 번호
• AK: Access Key
• SK: Secret Key

4. 에이전트 실행

• PowerShell 또는 명령 프롬프트(CMD)를 관리자 권한으로 실행합니다.
• 에이전트 폴더로 이동하여 giipAgent3.bat 파일을 실행합니다.

cd C:\giipAgent
.\giipAgent3.bat

🔍 작동 확인

• 콘솔 확인: GIIP 웹 콘솔의 [서버 목록]에서 해당 서버가 Online 상태로 변하는지 확인합니다.
• 로그 확인: 에이전트 폴더 내의 logs 디렉토리에서 실행 로그에 에러가 없는지 체크합니다.

💡 유의 사항

• 방화벽에서 GIIP 서버 주소(API 엔드포인트)로의 아웃바운드 443(HTTPS) 포트가 허용되어 있어야 합니다.

🔧 문제 해결

증상	원인	해결
giipAgent3.bat 실행 시 PowerShell 스크립트가 차단됨	PowerShell 실행 정책(ExecutionPolicy)이 제한(Restricted)되어 있음	관리자 PowerShell에서 실행 정책을 완화하거나 CMD를 관리자 권한으로 실행
서버가 콘솔 [서버 목록]에서 Online으로 바뀌지 않음	giipAgent.cfg에 CSN/AK/SK가 예시값(placeholder) 그대로 남아 있음	giipAgent.cfg를 열어 실제 CSN/AK/SK 값을 입력한 뒤 재실행
실행 시 접근 거부(Access denied) 오류	PowerShell/CMD를 관리자 권한으로 실행하지 않음	PowerShell 또는 CMD를 관리자 권한으로 다시 실행
logs 디렉토리 로그에 통신 오류가 남음	방화벽에서 아웃바운드 443(HTTPS)이 차단됨	GIIP 서버 주소로의 아웃바운드 443 포트를 허용

---

버전: 1.0 최종 업데이트: 2026-03-19 소스 파일: giipv3/public/help/agent-setup-win.ko.md