Windows Agent Setup Guide

Learn how to install the GIIP agent on a Windows server or workstation to start management.

📋 Overview

The GIIP Windows agent operates based on PowerShell and performs server performance collection, log analysis, and security monitoring functions. The installation process is very simple and does not require a separate reboot.

🛠️ Prerequisites

• Operating System: Windows Server 2012 R2 or later (Windows 10/11 supported)
• Permissions: Administrator privileges required
• Authentication Info: Prepare your CSN, Access Key (AK), and Secret Key (SK) from the [My Profile] menu on the GIIP console in advance.

🚀 Installation Steps

1. Download Agent File

Download the giipAgent_Windows.zip file from the [Agent Management] page on the GIIP console, or copy and run the provided PowerShell command.

2. Unzip & Path Configuration

• Unzip the file in an easily accessible path like C:\giipAgent.
• Note: A short path primarily in English is recommended rather than paths containing spaces or special characters.

3. Configure Authentication Info

Open the giipAgent.cfg file with Notepad, enter the following items, and save:

• CSN: Customer Service Number
• AK: Access Key
• SK: Secret Key

4. Run Agent

• Run PowerShell or Command Prompt (CMD) as an Administrator.
• Navigate to the agent folder and run the giipAgent3.bat file.

cd C:\giipAgent
.\giipAgent3.bat

🔍 Verification

• Console Check: Verify if the corresponding server changes to an Online status in the [Server List] on the GIIP web console.
• Log Check: Check the logs directory within the agent folder to ensure there are no errors in the execution logs.

💡 Important Notes

• Outbound port 443 (HTTPS) to the GIIP server address (API endpoint) must be allowed in the firewall.

🔧 Troubleshooting

Symptom	Cause	Solution
The PowerShell script is blocked when running giipAgent3.bat	PowerShell ExecutionPolicy is set to Restricted	Relax the execution policy in an admin PowerShell, or run CMD as Administrator
The server does not change to Online in the console [Server List]	giipAgent.cfg still contains placeholder CSN/AK/SK values	Open giipAgent.cfg, enter the real CSN/AK/SK values, and re-run
Access denied error on run	PowerShell/CMD was not run with Administrator privileges	Re-run PowerShell or CMD as Administrator
Communication errors appear in the logs directory	Outbound port 443 (HTTPS) is blocked by the firewall	Allow outbound port 443 to the GIIP server address

---

Version: 1.0 Last Updated: 2026-03-19 Source: giipv3/public/help/agent-setup-win.en.md