Skip to content

docs(endpoint-agent): document setting env vars on an installed service#276

Merged
pllesperance-lc merged 1 commit into
masterfrom
docs/sensor-service-env-vars
Jun 17, 2026
Merged

docs(endpoint-agent): document setting env vars on an installed service#276
pllesperance-lc merged 1 commit into
masterfrom
docs/sensor-service-env-vars

Conversation

@pllesperance-lc

Copy link
Copy Markdown
Contributor

What

Adds a generic Setting Environment Variables for an Installed Service section to the Agent CLI & Environment Reference, with the per-platform procedure for applying any sensor environment variable to an already-installed service:

  • macOS (launchd)EnvironmentVariables dict in /Library/LaunchDaemons/com.refractionpoint.rphcp.plist, validate + reload (plutil -lint, bootout/bootstrap), verification, plus a no-edit launchctl debug test path and MDM/reinstall caveats.
  • Linux (systemd)systemctl edit limacharlie drop-in.
  • Windows (service) — machine-wide setx /M vs. scoped Environment REG_MULTI_SZ under rphcpsvc.

It also:

  • Links the env-var table intro (which already told users to "set them through your service manager") down to the new procedure.
  • Links the Hostname Resolution page to the new section, since LC_DISABLE_REVERSE_DNS_HOSTNAME is a common variable customers set on an installed sensor.

Why

The reference listed the variables and said to set them via the service manager, but never showed how. Customers trying to set e.g. LC_DISABLE_REVERSE_DNS_HOSTNAME on an installed macOS sensor had no documented procedure for editing the launchd plist. This is written generically so it covers every variable in the reference, not just one.

Notes

  • Service names used are grounded in existing docs (Linux unit limacharlie, Windows service rphcpsvc, macOS label com.refractionpoint.rphcp).
  • I could not run markdownlint-cli2 locally (offline); please rely on CI lint.

🤖 Generated with Claude Code

Add a generic "Setting Environment Variables for an Installed Service"
section to the CLI & Environment reference, covering the per-platform
procedure (macOS launchd plist, Linux systemd drop-in, Windows service
environment) for any sensor environment variable. The env-var section
intro already pointed users at their service manager but never showed
how; this fills that gap.

Also link the reverse-DNS hostname page to the new section, since
LC_DISABLE_REVERSE_DNS_HOSTNAME is a common variable customers need to
set on an already-installed sensor.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@pllesperance-lc pllesperance-lc requested a review from maximelb June 17, 2026 18:09
@pllesperance-lc pllesperance-lc merged commit fcae34f into master Jun 17, 2026
2 checks passed
@pllesperance-lc pllesperance-lc deleted the docs/sensor-service-env-vars branch June 17, 2026 18:13
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