Splunk AppDynamics Platform 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 On-Premises, Virtual Appliance, Enterprise Console, Controller host setup, Events
Service, EUM Server, Synthetic Server, HA, upgrade, or secure platform runbooks.
- Preview and review the splunk appdynamics platform 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-platform-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-platform-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 |
Render-first owner for AppDynamics self-managed platform workflows. Platform
mutations are high-blast-radius and require reviewed runbooks; Enterprise
Console changes are additionally gated by --accept-enterprise-console-mutation.
The skill tracks the current AppDynamics On-Premises 26.8.0 Enterprise Console
and Controller deployment documentation for CLI-capable platform work. The
Virtual Appliance manual runs on its own release cadence and currently
publishes 26.1.0, so appliance workflows stay on that version rather than
being relabeled to 26.8.0.
bash skills/splunk-appdynamics-platform-setup/scripts/setup.sh --render
bash skills/splunk-appdynamics-platform-setup/scripts/validate.sh
bash skills/splunk-appdynamics-platform-setup/scripts/setup.sh \
--apply enterprise-console --accept-enterprise-console-mutation \
--spec path/to/platform.yaml
Live apply requires one explicit section: enterprise-console,
vmware-ovftool, or vmware-govc. Bare --apply is rejected so a platform
bootstrap and an appliance deployment cannot be conflated. Rendered executors
also default to dry-run unless invoked through the gated wrapper (or their
documented action environment variable is set explicitly).
The renderer emits:
platform-topology-inventory.yaml with the reviewed component and host map.
deployment-method-selector.yaml and deployment-method-matrix.md to route
users across classic On-Premises, Virtual Appliance, GUI, CLI, and
discover/upgrade paths without making them know the product taxonomy first.
enterprise-console-command-plan.sh with session-safe Enterprise Console CLI
commands for platform, credential, host, version, diagnosis, and job discovery.
classic-onprem-deployment-runbook.md,
controller-install-upgrade-runbook.md, component-deployment-runbook.md,
virtual-appliance-deployment-runbook.md, platform-ha-backup-runbook.md,
and platform-security-checklist.md for support-gated or outage-prone work.
virtual-appliance-vmware-inventory.yaml,
virtual-appliance-ovftool-plan.sh, virtual-appliance-govc-plan.sh, and
virtual-appliance-vmware-validation.sh for vSphere or standalone ESXi OVA
deployment handoff without passing VMware passwords on shell command lines.
platform-validation-probes.sh for local static checks and optional live
reachability probes.
VMware live validation requires APPD_SSH_KNOWN_HOSTS_FILE whenever SSH
appdctl checks are enabled. Host-key enrollment is an operator prerequisite;
the generated script does not accept new keys implicitly or suppress failed
boot/cluster checks.
First-class deployment coverage:
- Classic On-Premises Enterprise Console Express GUI, Custom GUI, CLI, and
Discover/Upgrade GUI/CLI flows.
- Classic component installers for Linux Events Service, Windows Events Service
manual deployment, EUM Server GUI/console/silent installer modes, and
Synthetic Server dependency sequencing.
- Virtual Appliance infrastructure targets for VMware vSphere, VMware ESXi,
Microsoft Azure, AWS, KVM, and ROSA. The VMware path includes OVF Tool and
govc dry-run plans, OVA placement guidance, OVF property inspection, three
node network inventory, and
appdctl show boot validation.
- Virtual Appliance Standard and Hybrid service deployment with
appdcli
validation handoffs.
1---2name: splunk-appdynamics-platform-setup3description: Use when the user asks for AppDynamics On-Premises, Virtual Appliance, Enterprise Console, Controller host setup, Events Service, EUM Server, Synthetic Server, HA, upgrade, or secure platform runbooks. Render, validate, and gate Splunk AppDynamics On-Premises and Virtual Appliance platform workflows, including Enterprise Console, Controller, Events Service, EUM Server, Synthetic Server, planning, platform quickstart, release notes, compatibility, HA, backup, restore, upgrades, and secure platform hardening.4---56# Splunk AppDynamics Platform 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 On-Premises, Virtual Appliance, Enterprise Console, Controller host setup, Events27 Service, EUM Server, Synthetic Server, HA, upgrade, or secure platform runbooks.28- Preview and review the splunk appdynamics platform setup workflow before any live apply phase.29- Diagnose failed prerequisites, generated assets, configuration, or validation evidence.3031## Scope3233Follow the documented read-only or render-first path whenever it is available.34This skill does not imply permission to mutate live systems. Require explicit35apply flags, protected credentials, and operator review for state changes.3637## Examples3839Inspect the supported setup modes before selecting one:4041```bash42bash skills/splunk-appdynamics-platform-setup/scripts/setup.sh --help43```4445Expected output: usage, supported modes, and required arguments are displayed46without changing the target environment.4748Inspect validation modes before running completion checks:4950```bash51bash skills/splunk-appdynamics-platform-setup/scripts/validate.sh --help52```5354Expected output: offline, live, and completion options are displayed when the55skill supports them; help exits without mutation.5657## Troubleshooting5859| Issue | Cause | Resolution |60|---|---|---|61| Preflight fails | A required tool or access path is missing | Resolve it before rendering or applying |62| Rendered assets are incomplete | Required non-secret inputs are absent | Complete intake and render again |63| Apply is blocked | Review, credentials, or explicit acceptance is missing | Use the documented handoff |64| Validation is incomplete | Live evidence is unavailable | Record the gap and keep completion open |6566Render-first owner for AppDynamics self-managed platform workflows. Platform67mutations are high-blast-radius and require reviewed runbooks; Enterprise68Console changes are additionally gated by `--accept-enterprise-console-mutation`.69The skill tracks the current AppDynamics On-Premises 26.8.0 Enterprise Console70and Controller deployment documentation for CLI-capable platform work. The71Virtual Appliance manual runs on its own release cadence and currently72publishes 26.1.0, so appliance workflows stay on that version rather than73being relabeled to 26.8.0.7475```bash76bash skills/splunk-appdynamics-platform-setup/scripts/setup.sh --render77bash skills/splunk-appdynamics-platform-setup/scripts/validate.sh78bash skills/splunk-appdynamics-platform-setup/scripts/setup.sh \79 --apply enterprise-console --accept-enterprise-console-mutation \80 --spec path/to/platform.yaml81```8283Live apply requires one explicit section: `enterprise-console`,84`vmware-ovftool`, or `vmware-govc`. Bare `--apply` is rejected so a platform85bootstrap and an appliance deployment cannot be conflated. Rendered executors86also default to dry-run unless invoked through the gated wrapper (or their87documented action environment variable is set explicitly).8889The renderer emits:9091- `platform-topology-inventory.yaml` with the reviewed component and host map.92- `deployment-method-selector.yaml` and `deployment-method-matrix.md` to route93 users across classic On-Premises, Virtual Appliance, GUI, CLI, and94 discover/upgrade paths without making them know the product taxonomy first.95- `enterprise-console-command-plan.sh` with session-safe Enterprise Console CLI96 commands for platform, credential, host, version, diagnosis, and job discovery.97- `classic-onprem-deployment-runbook.md`,98 `controller-install-upgrade-runbook.md`, `component-deployment-runbook.md`,99 `virtual-appliance-deployment-runbook.md`, `platform-ha-backup-runbook.md`,100 and `platform-security-checklist.md` for support-gated or outage-prone work.101- `virtual-appliance-vmware-inventory.yaml`,102 `virtual-appliance-ovftool-plan.sh`, `virtual-appliance-govc-plan.sh`, and103 `virtual-appliance-vmware-validation.sh` for vSphere or standalone ESXi OVA104 deployment handoff without passing VMware passwords on shell command lines.105- `platform-validation-probes.sh` for local static checks and optional live106 reachability probes.107108VMware live validation requires `APPD_SSH_KNOWN_HOSTS_FILE` whenever SSH109`appdctl` checks are enabled. Host-key enrollment is an operator prerequisite;110the generated script does not accept new keys implicitly or suppress failed111boot/cluster checks.112113First-class deployment coverage:114115- Classic On-Premises Enterprise Console Express GUI, Custom GUI, CLI, and116 Discover/Upgrade GUI/CLI flows.117- Classic component installers for Linux Events Service, Windows Events Service118 manual deployment, EUM Server GUI/console/silent installer modes, and119 Synthetic Server dependency sequencing.120- Virtual Appliance infrastructure targets for VMware vSphere, VMware ESXi,121 Microsoft Azure, AWS, KVM, and ROSA. The VMware path includes OVF Tool and122 govc dry-run plans, OVA placement guidance, OVF property inspection, three123 node network inventory, and `appdctl show boot` validation.124- Virtual Appliance Standard and Hybrid service deployment with `appdcli`125 validation handoffs.