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 untuk GPO (tambahkan file ini di policy)
GeoNetAgent-GPO-Startup.ps1	Logika install / update / perbaiki task
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. OK → tutup editor GPO

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
Test-Path "$env:ProgramData\GeoNetAgent\UserAgent.ps1"

Harapan:

• VERSION = versi terbaru di server (mis. 0.1.8-phase0)
• Log berisi Selesai OK
• Task GeoNetAgent-Report — HOURLY, interval 3 jam, 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)
Jaringan belum siap saat boot	Tunggu hingga 120 detik
Error	Catat di log, exit 0 (boot tidak terganggu)

Laporan inventaris dikirim oleh Scheduled Task (UserAgent.ps1), bukan langsung dari skrip GPO.

Log

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

Contoh:

2026-06-18 08:15:02  === GPO startup begin ===
2026-06-18 08:15:08  Agent belum terpasang — install baru
2026-06-18 08:15:45  Selesai OK. VERSION=0.1.8-phase0
2026-06-18 08:15:45  === GPO startup 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
   

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.