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 KeySK: 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