Splunk AppDynamics Agent Management Setup
Prerequisites
| Tool or access |
Purpose |
Verify |
| Bash and Python 3 |
Run bundled setup and validation helpers |
bash --version && python3 --version |
| Required product/platform access |
Inspect or configure the selected target |
Complete the documented preflight |
| Credential files for live modes |
Keep secrets out of chat |
Verify paths only |
Workflow Overview
┌───────────┐ ┌───────────────┐ ┌───────────────┐ ┌─────────────────┐
│ Preflight │ → │ Render/review │ → │ Apply/handoff │ → │ Validate evidence │
└───────────┘ └───────────────┘ └───────────────┘ └─────────────────┘
When to Activate
- The user asks for AppDynamics Smart Agent, Agent Management, remote agent installation, deployment groups, managed
agent upgrade, rollback, auto-attach, auto-discovery, managed Apache, .NET, Database, Java, Machine, Node.js, PHP,
or Python.
- Preview and review the splunk appdynamics agent management setup workflow before any live apply phase.
- Diagnose failed prerequisites, generated assets, configuration, or validation evidence.
Scope
Follow the documented read-only or render-first path whenever it is available.
This skill does not imply permission to mutate live systems. Require explicit
apply flags, protected credentials, and operator review for state changes.
Examples
Inspect the supported setup modes before selecting one:
bash skills/splunk-appdynamics-agent-management-setup/scripts/setup.sh --help
Expected output: usage, supported modes, and required arguments are displayed
without changing the target environment.
Inspect validation modes before running completion checks:
bash skills/splunk-appdynamics-agent-management-setup/scripts/validate.sh --help
Expected output: offline, live, and completion options are displayed when the
skill supports them; help exits without mutation.
Troubleshooting
| Issue |
Cause |
Resolution |
| Preflight fails |
A required tool or access path is missing |
Resolve it before rendering or applying |
| Rendered assets are incomplete |
Required non-secret inputs are absent |
Complete intake and render again |
| Apply is blocked |
Review, credentials, or explicit acceptance is missing |
Use the documented handoff |
| Validation is incomplete |
Live evidence is unavailable |
Record the gap and keep completion open |
Owns the Smart Agent and Agent Management lifecycle. The safe path is render
first: it creates reviewed plans, templates, and runbooks without touching
hosts. The wrapper does not execute local or remote Smart Agent commands;
--apply fails closed instead of claiming a deployment occurred.
bash skills/splunk-appdynamics-agent-management-setup/scripts/setup.sh --render
bash skills/splunk-appdynamics-agent-management-setup/scripts/validate.sh
What This Skill Covers
- Smart Agent readiness: Controller version, licenses, permissions, supported
platforms, memory, disk, service user/group, and service-vs-process decision.
- Smart Agent setup:
config.ini, file-backed access-key handling, proxy/TLS
settings, environment overrides, local install, remote install, validate,
upgrade, uninstall, and primary-host to remote-host synchronization.
- Agent Management UI: inventory, Smart Agents tab, app-server and Machine
Agent install/upgrade/rollback, Database Agent install/upgrade/rollback, CSV
host import, custom package locations, local directory, and custom HTTP source
review.
smartagentctl: local and remote install, upgrade, uninstall, rollback,
remote.yaml, Linux SSH, Windows WinRM, SSH password environment variables,
HTTP/SOCKS5 SSH proxies, local-directory downloads, and source-specific flags.- Large-scale operations: deployment groups, per-host assignment, Java and
Node.js auto-attach, application process auto-discovery, and generated
ld_preload.json planning.
- Standalone Smart Agent CLI: past End of Support since February 2, 2026, so it
is retained only as a migration runbook off the CLI and onto
smartagentctl.
The 26.8.0 page still states the date in the future tense; that is unrevised
vendor wording, not continuing support.
- Software supply chain: download portal/cURL plan, binary transfer warning,
checksums, PGP or code-signing validation where published, release-note link,
package inventory, and rollback package confirmation.
Consume It
Start with smart-agent-readiness.yaml and agent-management-decision-guide.md.
They keep the intake small: deployment mode, host OS, target agents, local vs
remote, UI vs smartagentctl, package source, and whether deployment groups or
auto-attach are in scope.
Only after that should an operator review and explicitly execute the applicable
commands from smart-agent-remote-command-plan.sh,
smartagentctl-lifecycle-plan.sh, remote.yaml.template, and the UI runbooks.
The generated shell files print command plans; they do not execute them. No
generated file contains secret values.
1---2name: splunk-appdynamics-agent-management-setup3description: Use when the user asks for AppDynamics Smart Agent, Agent Management, remote agent installation, deployment groups, managed agent upgrade, rollback, auto-attach, auto-discovery, managed Apache, .NET, Database, Java, Machine, Node.js, PHP, or Python agents, package download automation, checksum validation, signature validation, or release compatibility. Render, validate, and gate Splunk AppDynamics Smart Agent and Agent Management workflows, including prerequisites, platform and permission checks, Smart Agent config, local and remote install, upgrade, uninstall, synchronization, deployment groups, auto-attach, auto-discovery, UI paths, smartagentctl lifecycle commands, deprecated Smart Agent CLI guidance, and supported managed agent types for Apache, .NET MSI, Database, Java, Machine, Node.js, PHP, and Python agents, plus software downloads, checksum validation, digital signatures, and release posture.4---56# Splunk AppDynamics Agent Management Setup78## Prerequisites910| Tool or access | Purpose | Verify |11|---|---|---|12| Bash and Python 3 | Run bundled setup and validation helpers | `bash --version && python3 --version` |13| Required product/platform access | Inspect or configure the selected target | Complete the documented preflight |14| Credential files for live modes | Keep secrets out of chat | Verify paths only |1516## Workflow Overview1718```text19┌───────────┐ ┌───────────────┐ ┌───────────────┐ ┌─────────────────┐20│ Preflight │ → │ Render/review │ → │ Apply/handoff │ → │ Validate evidence │21└───────────┘ └───────────────┘ └───────────────┘ └─────────────────┘22```2324## When to Activate2526- The user asks for AppDynamics Smart Agent, Agent Management, remote agent installation, deployment groups, managed27 agent upgrade, rollback, auto-attach, auto-discovery, managed Apache, .NET, Database, Java, Machine, Node.js, PHP,28 or Python.29- Preview and review the splunk appdynamics agent management setup workflow before any live apply phase.30- Diagnose failed prerequisites, generated assets, configuration, or validation evidence.3132## Scope3334Follow the documented read-only or render-first path whenever it is available.35This skill does not imply permission to mutate live systems. Require explicit36apply flags, protected credentials, and operator review for state changes.3738## Examples3940Inspect the supported setup modes before selecting one:4142```bash43bash skills/splunk-appdynamics-agent-management-setup/scripts/setup.sh --help44```4546Expected output: usage, supported modes, and required arguments are displayed47without changing the target environment.4849Inspect validation modes before running completion checks:5051```bash52bash skills/splunk-appdynamics-agent-management-setup/scripts/validate.sh --help53```5455Expected output: offline, live, and completion options are displayed when the56skill supports them; help exits without mutation.5758## Troubleshooting5960| Issue | Cause | Resolution |61|---|---|---|62| Preflight fails | A required tool or access path is missing | Resolve it before rendering or applying |63| Rendered assets are incomplete | Required non-secret inputs are absent | Complete intake and render again |64| Apply is blocked | Review, credentials, or explicit acceptance is missing | Use the documented handoff |65| Validation is incomplete | Live evidence is unavailable | Record the gap and keep completion open |6667Owns the Smart Agent and Agent Management lifecycle. The safe path is render68first: it creates reviewed plans, templates, and runbooks without touching69hosts. The wrapper does not execute local or remote Smart Agent commands;70`--apply` fails closed instead of claiming a deployment occurred.7172```bash73bash skills/splunk-appdynamics-agent-management-setup/scripts/setup.sh --render74bash skills/splunk-appdynamics-agent-management-setup/scripts/validate.sh75```7677## What This Skill Covers7879- Smart Agent readiness: Controller version, licenses, permissions, supported80 platforms, memory, disk, service user/group, and service-vs-process decision.81- Smart Agent setup: `config.ini`, file-backed access-key handling, proxy/TLS82 settings, environment overrides, local install, remote install, validate,83 upgrade, uninstall, and primary-host to remote-host synchronization.84- Agent Management UI: inventory, Smart Agents tab, app-server and Machine85 Agent install/upgrade/rollback, Database Agent install/upgrade/rollback, CSV86 host import, custom package locations, local directory, and custom HTTP source87 review.88- `smartagentctl`: local and remote install, upgrade, uninstall, rollback,89 `remote.yaml`, Linux SSH, Windows WinRM, SSH password environment variables,90 HTTP/SOCKS5 SSH proxies, local-directory downloads, and source-specific flags.91- Large-scale operations: deployment groups, per-host assignment, Java and92 Node.js auto-attach, application process auto-discovery, and generated93 `ld_preload.json` planning.94- Standalone Smart Agent CLI: past End of Support since February 2, 2026, so it95 is retained only as a migration runbook off the CLI and onto `smartagentctl`.96 The 26.8.0 page still states the date in the future tense; that is unrevised97 vendor wording, not continuing support.98- Software supply chain: download portal/cURL plan, binary transfer warning,99 checksums, PGP or code-signing validation where published, release-note link,100 package inventory, and rollback package confirmation.101102## Consume It103104Start with `smart-agent-readiness.yaml` and `agent-management-decision-guide.md`.105They keep the intake small: deployment mode, host OS, target agents, local vs106remote, UI vs `smartagentctl`, package source, and whether deployment groups or107auto-attach are in scope.108109Only after that should an operator review and explicitly execute the applicable110commands from `smart-agent-remote-command-plan.sh`,111`smartagentctl-lifecycle-plan.sh`, `remote.yaml.template`, and the UI runbooks.112The generated shell files print command plans; they do not execute them. No113generated file contains secret values.
chambear2809