Upgrade Process
This section explains how to upgrade an existing HuLoop IPD deployment—both for the server and agents—without disrupting user data or operations.
HuLoop recommends performing upgrades after business hours and only after validating that all prerequisites are in place.
Upgrade Overview
| Component | Upgrade Method | Downtime Required |
|---|---|---|
| IPD Server | upgrade.sh script (CLI) | Yes – brief downtime |
| Agent | Reinstall MSI (same parameters) | No – agent auto-restarts |
Always backup server volumes and export settings before running any upgrade script.
Upgrading the IPD Server (Linux)
✅ Step-by-Step Instructions
- Stop the Current Containers
cd /home/huloop/IPD
docker-compose down - Download and Unpack the New Bundle
scp IPD_Upgrade_Bundle.zip user@your-ipd-server:/home/user/
unzip IPD_Upgrade_Bundle.zip
cd IPD_Upgrade_Bundle - Run the Upgrade Script
chmod +x upgrade.sh
./upgrade.sh - Follow the Prompts
You’ll be asked to:- Confirm existing instance name
- Re-enter certificate path/password (if changed)
- Choose optional modules to update (e.g., monitoring, anonymizer)
⚠️ Important: Do not interrupt the script once started. The upgrade process may take 5–10 minutes.
- Restart Services
docker-compose up -d - Verify Upgrade
- Run docker ps to check container status
- Open the admin dashboard in your browser to confirm version number and health checks
Upgrading the Agent (Windows)
You can upgrade the HuLoop Agent by simply running the new .msi file with the same server parameters. The installer will automatically handle version replacement.
✅ Upgrade Command (Silent Mode)
msiexec /i “KypMsi_Discovery_vNext.msi” /quiet
SERVERURL=”https://ipd.customer.com/engine”
✅ Manual Upgrade
- Double-click the .msi file
- Follow the prompts
- Confirm agent restarts automatically
Note: There’s no need to uninstall the old version—the upgrade is seamless.
Post-Upgrade Validation
- Server: Check Docker services and dashboard access
- Agent: Look for updated agent version in tray tooltip or logs
- Logs: Review /home/huloop/logs/ and Windows Event Viewer for upgrade confirmation
