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) 포트가 허용되어 있어야 합니다.

---

버전: 1.0 최종 업데이트: 2026-03-19 소스 파일:

giipv3/public/help/agent-setup-win.ko.md