Skip to content

docs: fix windows install paths, exit codes and the allowlist - #33

Merged
meysam-licenseware merged 4 commits into
mainfrom
docs/windows-msi-intune
Aug 27, 2026
Merged

docs: fix windows install paths, exit codes and the allowlist#33
meysam-licenseware merged 4 commits into
mainfrom
docs/windows-msi-intune

Conversation

@meysam-licenseware

@meysam-licenseware meysam-licenseware commented Aug 26, 2026

Copy link
Copy Markdown
Contributor

Raised by a customer ticket. Every item here is a documentation defect the customer hit in production.

  • Install paths read as a contradiction. Both are real and different: %ProgramFiles%\Licenseware\LicensewareCollector.exe is the installer-owned seed, C:\ProgramData\Licenseware\bin\LicensewareCollector.exe is the runtime binary the service runs and self-update replaces. They are now labelled as such, with a note that the runtime path only appears after a successful enrolment.
  • Exit codes were undocumented. Added the standard-codes table, stated there are no vendor-specific values, and pointed at %ProgramData%\Licenseware\setup.log for the reason behind any 1603.
  • msiexec returning 0 is not proof of enrolment. New MDM section says so explicitly and gives a PowerShell detection script keyed on the service plus the device TOKEN= in collector.env. Also warns off file-version rules, which cannot match on agents built before the version resource was added (licenseware/collector#140).
  • The allowlist was wrong in both directions. Added pushlogs.licenseware.io (log shipping, on by default), api.github.com and release-assets.githubusercontent.com / objects.githubusercontent.com (auto-update, every 24h), and the regional API hosts. Relabelled github.com as the osquery fallback rather than "installation only".
  • Standalone .exe marked deprecated on the Downloads card.

Both en and es translation blocks updated, plus a nav entry for the new section. bun run build passes and every data-i18n key resolves in both languages.

pushlogs and the GitHub self-update hosts were missing entirely, and
github.com was labelled installation-only although auto-update polls it
every 24h.
Both paths are real and different; the page showed one as "Binary", so a
detection rule pointed at whichever the reader saw first.
Exit codes were undocumented and msiexec returning 0 does not mean the
device enrolled, so a product-code rule reports success on a host that
never reports in.
@github-actions

Copy link
Copy Markdown

Live preview

Last updated: 2026-08-26T12:18:52
Last commit: 2e7686c
The live preview of the changes are available at the following URL:
https://6a8ed9aa32347c1be0bcc80d--licenseware-collector.netlify.app

@meysam-licenseware
meysam-licenseware merged commit 10fe9c4 into main Aug 27, 2026
6 checks passed
@meysam-licenseware
meysam-licenseware deleted the docs/windows-msi-intune branch August 27, 2026 07:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant