mirror of
https://github.com/yuezk/GlobalProtect-openconnect.git
synced 2026-11-19 06:26:14 -05:00
63 lines
3.8 KiB
Markdown
63 lines
3.8 KiB
Markdown
# Windows installer
|
|
|
|
`installer.nsi` embeds a complete Windows payload and the canonical
|
|
`machine-install.ps1` installation implementation. Build it with NSIS 3 Unicode:
|
|
|
|
```powershell
|
|
& makensis /DPAYLOAD_DIR=C:\build\payload /DOUTPUT_FILE=C:\build\GPConnect-Setup.exe /DPRODUCT_VERSION=3.4.0 /DBUILD_VERSION=3.4.0.0 /DDISPLAY_VERSION=3.4.0-snapshot.2026.1114.2 .\packaging\windows\installer.nsi
|
|
```
|
|
|
|
`BUILD_VERSION` must contain four numeric components. `PRODUCT_VERSION` must
|
|
match the payload's `build-info.json`. `DISPLAY_VERSION` is the full release
|
|
identity, including the snapshot build when applicable. The payload must contain matching
|
|
`gpgui.exe`, `gpauth.exe`, `gpservice.exe`, their DLL dependency closure, the
|
|
vendor-signed `wintun.dll`, `licenses`, and `build-info.json`. The NSIS compiler
|
|
adds the generated uninstaller; it is not a separately built executable.
|
|
|
|
The installer, extraction progress and uninstaller use the shared Windows icon
|
|
from `apps/gpauth/icons/windows/icon.ico`. The Finish page uses `sidebar.bmp`,
|
|
derived from that same icon. After regenerating application icons, run
|
|
`powershell -NoProfile -File scripts/generate-windows-installer-artwork.ps1`
|
|
on Windows and retain the updated bitmap before building installers.
|
|
|
|
The development ZIP includes the same machine implementation as
|
|
`installer/machine-install.ps1`. Its install/uninstall entrypoints call that
|
|
implementation rather than maintaining a second file replacement algorithm.
|
|
Use the EXE installer to upgrade an installation that already has an NSIS
|
|
uninstaller; the development ZIP does not contain that generated executable.
|
|
|
|
Installation waits for the installed GUI/auth paths in all Windows sessions;
|
|
it does not stop arbitrary same-name processes. Service shutdown uses SCM,
|
|
checks the existing network-recovery criteria, and waits for file release.
|
|
Application files are staged under Program Files with protected ACLs. The old
|
|
directory is renamed to `GP Connect.previous` until the new service is Running.
|
|
Handled replacement/start failures restore old files and metadata and restart
|
|
the previous service. An interrupted installer with a retained backup requires
|
|
explicit repair; it is not automatically recovered.
|
|
|
|
Disk use includes the downloaded installer and one expanded new payload. NSIS
|
|
extracts into its temporary directory, then the machine implementation consumes
|
|
those disposable files into protected staging instead of copying the whole bundle.
|
|
When temp and Program Files use different volumes, file moves may temporarily
|
|
duplicate the file currently being moved. The old installation is renamed, not
|
|
copied. The machine implementation checks the installation volume before staging;
|
|
NSIS extraction errors must complete before service shutdown.
|
|
Successful installation removes the old copy and staging. Installer logs keep
|
|
the current and previous attempt in ProgramData. No updater cache is added.
|
|
|
|
The installer never launches the GUI as administrator. Users open GP Connect
|
|
from the Start menu after completion. User configuration and licensing state
|
|
are retained during upgrades and uninstall. Authenticode setup is separate;
|
|
WinSparkle must still verify the installer payload signature before handoff.
|
|
|
|
The service log rotates after 5 MiB and retains three numbered archives, keeping
|
|
each entry whole. The bundle includes `licenses/file-rotate.txt` for the Windows
|
|
service's rotation library.
|
|
|
|
On a disposable Windows installation, verify a normal A-to-B upgrade and a B
|
|
payload whose `gpservice.exe` is replaced with another valid PE executable that
|
|
cannot host a Windows service. The latter must fail service startup, restore A's
|
|
files and uninstall metadata, and leave A's service running. Also check held
|
|
runtime files, active GUI/auth windows, Wintun-signature failure, and concurrent
|
|
installer attempts. Do not run failure fixtures against a live company VPN.
|