LDAPWeb/GeoNetAgent/agent/gpo

GeoNetAgent — Rollout massal via GPO

Skrip startup untuk Computer Configuration Active Directory. Jalan sebagai SYSTEM saat boot — tidak perlu user Admin login.

Isi folder

File	Fungsi
GeoNetAgent-GPO-Startup.cmd	Entry point GPO Startup (tambahkan di Startup Scripts)
GeoNetAgent-GPO-Startup.ps1	Logika install / update / perbaiki task saat boot
GeoNetAgent-GPO-Shutdown.cmd	Entry point GPO Shutdown (tambahkan di Shutdown Scripts)
GeoNetAgent-GPO-Shutdown.ps1	Kirim laporan sebelum PC mati / restart
README.md	Panduan ini

Prasyarat server

1. Agent v0.1.8+ sudah di-publish: bash infra/collector/publish_agent_install.sh
2. https://agent.gisportal.id/install/manifest.json bisa diakses dari jaringan user
3. Migration DB 002_disk_model.sql sudah dijalankan (jika pakai fitur model disk)

Langkah 1 — Salin ke SYSVOL

Salin seluruh folder agent/gpo/ ke share domain, contoh:

\\gisportal.id\SYSVOL\gisportal.id\scripts\GeoNetAgent\

Atau (klassik):

\\<DC>\NETLOGON\GeoNetAgent\

Pastikan Computer Account domain bisa Read folder tersebut.

Langkah 2 — Buat / edit GPO

1. Buka Group Policy Management di DC (AD 2012 R2 OK)

2. Buat GPO baru, mis. GeoNetAgent — Deploy Endpoint

3. Edit GPO → Computer Configuration → Policies → Windows Settings → Scripts (Startup/Shutdown)

4. Tab Startup → Add → pilih:

   \\gisportal.id\SYSVOL\gisportal.id\scripts\GeoNetAgent\GeoNetAgent-GPO-Startup.cmd
   

5. Tab Shutdown → Add → pilih:

   \\gisportal.id\SYSVOL\gisportal.id\scripts\GeoNetAgent\GeoNetAgent-GPO-Shutdown.cmd
   

6. OK → tutup editor GPO

Tip: Set Computer Configuration → Policies → Windows Settings → Scripts → Maximum wait time for Group Policy scripts ke 60 detik agar shutdown tidak terlalu lama menunggu agent.

Langkah 3 — Link ke OU

• Link GPO ke OU yang berisi laptop/PC Windows user
• Jangan link ke OU server jika server tidak perlu agent
• Urutan: taruh GPO di level OU yang tepat; hindari konflik dengan GPO lain yang memblokir script

Langkah 4 — Uji (1–2 mesin dulu)

Pada laptop uji (sudah join domain):

gpupdate /force
shutdown /r /t 0

Setelah boot, cek:

Get-Content "$env:ProgramData\GeoNetAgent\VERSION"
Get-Content "$env:ProgramData\GeoNetAgent\logs\gpo-startup.log" -Tail 20
schtasks /Query /TN GeoNetAgent-Report /V /FO LIST
schtasks /Query /TN GeoNetAgent-Report-Startup /V /FO LIST
schtasks /Query /TN GeoNetAgent-Report-Shutdown /V /FO LIST
Test-Path "$env:ProgramData\GeoNetAgent\UserAgent.ps1"

Harapan:

• VERSION = versi terbaru di server (mis. 0.1.11-phase0)
• Log berisi Selesai OK
• Task GeoNetAgent-Report — HOURLY, interval 3 jam, run as SYSTEM
• Task GeoNetAgent-Report-Startup — At Startup, run as SYSTEM
• Task GeoNetAgent-Report-Shutdown — Event trigger EventID 1074 (shutdown/restart), run as SYSTEM

Perilaku skrip

Kondisi	Aksi
Agent belum ada	Install penuh dari web (silent, -SkipInitialRun)
Agent lama tanpa modul auto-update	Reinstall
Agent ada	Cek manifest.json vs VERSION, update jika beda
Scheduled Task hilang	Daftar ulang (startup + 3 jam + shutdown event)
Jaringan belum siap saat boot	Tunggu hingga 120 detik
Error	Catat di log, exit 0 (boot tidak terganggu)

Kapan laporan dikirim

Trigger	Keterangan
Boot / Startup	GPO Startup + Task GeoNetAgent-Report-Startup (ONSTART)
Setiap 3 jam	Task GeoNetAgent-Report (HOURLY)
Shutdown / Restart	GPO Shutdown + Task GeoNetAgent-Report-Shutdown (Event 1074)

Task shutdown menggunakan -SkipAutoUpdate agar tidak delay proses mati PC.

Log

%ProgramData%\GeoNetAgent\logs\gpo-startup.log   ← startup
%ProgramData%\GeoNetAgent\logs\gpo-shutdown.log  ← shutdown

Contoh startup:

2026-06-29 08:15:02  === GPO startup begin ===
2026-06-29 08:15:08  Agent ada — cek update
2026-06-29 08:15:12  Updated: 0.1.10-phase0 -> 0.1.11-phase0
2026-06-29 08:15:13  Selesai OK. VERSION=0.1.11-phase0
2026-06-29 08:15:13  === GPO startup end ===

Contoh shutdown:

2026-06-29 17:30:01  === GPO shutdown begin ===
2026-06-29 17:30:01  Mengirim laporan sebelum shutdown...
2026-06-29 17:30:08  UserAgent selesai (exit 0)
2026-06-29 17:30:08  === GPO shutdown end ===

Firewall / proxy

Laptop harus bisa HTTPS outbound ke:

• https://agent.gisportal.id (install + POST laporan)

Split-DNS MikroTik sudah mengarahkan domain ini ke 10.100.1.24 di LAN.

Opsi parameter (advanced)

Edit baris di .cmd jika perlu:

powershell.exe -NoProfile -ExecutionPolicy Bypass -WindowStyle Hidden -File "%~dp0GeoNetAgent-GPO-Startup.ps1" -ScheduleHours 3 -MaxNetworkWaitSeconds 180

Rollback / uninstall

1. Unlink GPO dari OU

2. Hapus task:

   schtasks /Delete /TN GeoNetAgent-Report /F
   schtasks /Delete /TN GeoNetAgent-Report-Startup /F
   schtasks /Delete /TN GeoNetAgent-Report-Shutdown /F
   

3. Hapus folder: %ProgramData%\GeoNetAgent

Troubleshooting

Gejala	Cek
Log tidak ada	GPO belum jalan / path script salah / OU salah
Jaringan tidak reachable	DNS, firewall, proxy; boot terlalu cepat — naikkan MaxNetworkWaitSeconds
VERSION kosong	Install gagal — buka log, coba web install manual Admin
Task tidak ada	Jalankan manual: Repair via install Admin sekali
GPO tidak apply	gpresult /H report.html pada laptop

Alternatif tanpa GPO

Web install manual (2 baris PS Admin) — lihat agent/install/index.html atau agent/README.md.