# appdynamics/appd-virtual-appliance architecture

> Architecture diagram of the GitHub repository appdynamics/appd-virtual-appliance, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/appdynamics/appd-virtual-appliance
- Repository: https://github.com/appdynamics/appd-virtual-appliance

## Overview

This repository provides AppD Virtual Appliance deployment references for AWS, Azure, and KVM, plus source-appliance preparation bundles for upgrades. The documented workflows begin with an operator configuring resources or preparing an upgrade, then create or reuse images and infrastructure before deploying or replacing VMs. The graph follows the README’s stated ordering; bundle internals are opaque here, and no source excerpts were provided.

Main entry points: [`deploy/aws/01-aws-create-profile.sh`](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/01-aws-create-profile.sh) (AWS profile), [`deploy/aws/02-aws-add-vpc.sh`](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/02-aws-add-vpc.sh) (VPC setup), [`deploy/aws/03-aws-create-image-bucket.sh`](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/03-aws-create-image-bucket.sh) (Image bucket), [`deploy/aws/04-aws-import-iam-role.sh`](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/04-aws-import-iam-role.sh) (IAM role)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_prep["Upgrade preparation"]
  node_kafka["Kafka preparation<br/>[kafka-migrate.tar]"]
  node_credentials["Credential capture"]
end

subgraph group_aws["AWS deployment"]
  node_aws_profile["AWS profile"]
  node_aws_vpc["VPC setup<br/>[02-aws-add-vpc.sh]"]
  node_aws_bucket["Image bucket"]
  node_aws_role["IAM role"]
  node_aws_upload["Image upload"]
  node_aws_snapshot["Snapshot import"]
  node_aws_ami["AMI registration"]
  node_aws_vm["VM creation"]
  node_aws_capture["Capture VM details"]
  node_aws_terminate["Terminate VMs"]
  node_aws_status["Check VM status"]
  node_aws_replace["Replace VMs"]
end

subgraph group_azure["Azure deployment"]
  node_az_rg["Resource group"]
  node_az_nsg["Security group"]
  node_az_vnet["Virtual network<br/>[03-azure-vnet.sh]"]
  node_az_storage["Storage account"]
  node_az_disk["Disk image"]
  node_az_gallery["Image gallery"]
  node_az_definition["Image definition"]
  node_az_version["Image version"]
  node_az_vm["VM creation"]
  node_az_capture["Capture VM details"]
  node_az_power["Power off VMs"]
  node_az_dummy["Attach dummy NIC"]
  node_az_detach["Detach NIC and disk"]
  node_az_delete["Delete VMs"]
  node_az_replace["Replace VMs"]
end

subgraph group_kvm["KVM deployment"]
  node_kvm_prepare["Prepare hypervisor"]
  node_kvm_run["Run cluster"]
  node_kvm_upgrade["Upgrade cluster"]
end

node_operator(("Operator"))

node_operator -->|"runs on source VA"| node_kafka
node_operator -->|"runs on source VA"| node_credentials
node_operator -->|"configures and runs"| node_aws_profile
node_aws_profile -->|"then creates"| node_aws_vpc
node_aws_vpc -->|"then creates"| node_aws_bucket
node_aws_bucket -->|"then creates"| node_aws_role
node_aws_role -->|"then uploads"| node_aws_upload
node_aws_upload -->|"then imports"| node_aws_snapshot
node_aws_snapshot -->|"then registers"| node_aws_ami
node_aws_ami -->|"then creates"| node_aws_vm
node_operator -->|"starts upgrade"| node_aws_capture
node_aws_capture -->|"then terminates"| node_aws_terminate
node_aws_terminate -->|"then validates"| node_aws_status
node_aws_status -->|"then creates"| node_aws_replace
node_operator -->|"configures and runs"| node_az_rg
node_az_rg -->|"then creates"| node_az_nsg
node_az_nsg -->|"then creates"| node_az_vnet
node_az_vnet -->|"then creates"| node_az_storage
node_az_storage -->|"then creates"| node_az_disk
node_az_disk -->|"then creates"| node_az_gallery
node_az_gallery -->|"then defines"| node_az_definition
node_az_definition -->|"then versions"| node_az_version
node_az_version -->|"then creates"| node_az_vm
node_operator -->|"starts upgrade"| node_az_capture
node_az_capture -->|"then powers off"| node_az_power
node_az_power -->|"then associates"| node_az_dummy
node_az_dummy -->|"then detaches"| node_az_detach
node_az_detach -->|"then deletes"| node_az_delete
node_az_delete -->|"then creates"| node_az_replace
node_operator -->|"prepares nodes"| node_kvm_prepare
node_kvm_prepare -->|"then runs cluster"| node_kvm_run
node_operator -->|"runs upgrade"| node_kvm_upgrade

click node_kafka "https://github.com/appdynamics/appd-virtual-appliance/blob/main/kafka-migrate/kafka-migrate.tar"
click node_credentials "https://github.com/appdynamics/appd-virtual-appliance/blob/main/capture-upgrade-credentials/capture-upgrade-credentials.tar"
click node_aws_profile "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/01-aws-create-profile.sh"
click node_aws_vpc "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/02-aws-add-vpc.sh"
click node_aws_bucket "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/03-aws-create-image-bucket.sh"
click node_aws_role "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/04-aws-import-iam-role.sh"
click node_aws_upload "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/05-aws-upload-image.sh"
click node_aws_snapshot "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/06-aws-import-snapshot.sh"
click node_aws_ami "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/07-aws-register-snapshot.sh"
click node_aws_vm "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/08-aws-create-vms.sh"
click node_aws_capture "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/upgrade/01-aws-get-vm-details.sh"
click node_aws_terminate "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/upgrade/02-aws-terminate-vms.sh"
click node_aws_status "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/upgrade/03-aws-get-vm-status.sh"
click node_aws_replace "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/upgrade/04-aws-create-vms.sh"
click node_az_rg "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/01-azure-create-rg.sh"
click node_az_nsg "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/02-azure-create-nsg.sh"
click node_az_vnet "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/03-azure-vnet.sh"
click node_az_storage "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/04-azure-storage-account.sh"
click node_az_disk "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/05-azure-create-disk.sh"
click node_az_gallery "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/06-azure-image-gallery.sh"
click node_az_definition "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/07-azure-shared-image-def.sh"
click node_az_version "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/08-azure-shared-image-version.sh"
click node_az_vm "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/09-azure-vm-create.sh"
click node_az_capture "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/01-azure-get-vm-details.sh"
click node_az_power "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/02-azure-power-off-vm.sh"
click node_az_dummy "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/03-azure-associate-dummy-nic.sh"
click node_az_detach "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/04-azure-disassociate-nic-and-data-disk.sh"
click node_az_delete "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/05-azure-delete-vms.sh"
click node_az_replace "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/06-azure-create-vms.sh"
click node_kvm_prepare "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/kvm/01-prepare-hypervisor.sh"
click node_kvm_run "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/kvm/run-cluster"
click node_kvm_upgrade "https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/kvm/upgrade-cluster"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_kafka,node_credentials toneBlue
class node_aws_profile,node_aws_vpc,node_aws_bucket,node_aws_role,node_aws_upload,node_aws_snapshot,node_aws_ami,node_aws_vm,node_aws_capture,node_aws_terminate,node_aws_status,node_aws_replace toneAmber
class node_az_rg,node_az_nsg,node_az_vnet,node_az_storage,node_az_disk,node_az_gallery,node_az_definition,node_az_version,node_az_vm,node_az_capture,node_az_power,node_az_dummy,node_az_detach,node_az_delete,node_az_replace toneMint
class node_kvm_prepare,node_kvm_run,node_kvm_upgrade toneRose
class node_operator toneIndigo
```

## Components

### Upgrade preparation

- [Kafka preparation](https://github.com/appdynamics/appd-virtual-appliance/blob/main/kafka-migrate/kafka-migrate.tar): `kafka-migrate/kafka-migrate.tar`
- [Credential capture](https://github.com/appdynamics/appd-virtual-appliance/blob/main/capture-upgrade-credentials/capture-upgrade-credentials.tar): `capture-upgrade-credentials/capture-upgrade-credentials.tar`

### AWS deployment

- [AWS profile](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/01-aws-create-profile.sh): `deploy/aws/01-aws-create-profile.sh`
- [VPC setup](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/02-aws-add-vpc.sh): `deploy/aws/02-aws-add-vpc.sh`
- [Image bucket](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/03-aws-create-image-bucket.sh): `deploy/aws/03-aws-create-image-bucket.sh`
- [IAM role](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/04-aws-import-iam-role.sh): `deploy/aws/04-aws-import-iam-role.sh`
- [Image upload](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/05-aws-upload-image.sh): `deploy/aws/05-aws-upload-image.sh`
- [Snapshot import](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/06-aws-import-snapshot.sh): `deploy/aws/06-aws-import-snapshot.sh`
- [AMI registration](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/07-aws-register-snapshot.sh): `deploy/aws/07-aws-register-snapshot.sh`
- [VM creation](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/08-aws-create-vms.sh): `deploy/aws/08-aws-create-vms.sh`
- [Capture VM details](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/upgrade/01-aws-get-vm-details.sh): `deploy/aws/upgrade/01-aws-get-vm-details.sh`
- [Terminate VMs](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/upgrade/02-aws-terminate-vms.sh): `deploy/aws/upgrade/02-aws-terminate-vms.sh`
- [Check VM status](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/upgrade/03-aws-get-vm-status.sh): `deploy/aws/upgrade/03-aws-get-vm-status.sh`
- [Replace VMs](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/aws/upgrade/04-aws-create-vms.sh): `deploy/aws/upgrade/04-aws-create-vms.sh`

### Azure deployment

- [Resource group](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/01-azure-create-rg.sh): `deploy/vhd/01-azure-create-rg.sh`
- [Security group](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/02-azure-create-nsg.sh): `deploy/vhd/02-azure-create-nsg.sh`
- [Virtual network](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/03-azure-vnet.sh): `deploy/vhd/03-azure-vnet.sh`
- [Storage account](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/04-azure-storage-account.sh): `deploy/vhd/04-azure-storage-account.sh`
- [Disk image](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/05-azure-create-disk.sh): `deploy/vhd/05-azure-create-disk.sh`
- [Image gallery](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/06-azure-image-gallery.sh): `deploy/vhd/06-azure-image-gallery.sh`
- [Image definition](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/07-azure-shared-image-def.sh): `deploy/vhd/07-azure-shared-image-def.sh`
- [Image version](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/08-azure-shared-image-version.sh): `deploy/vhd/08-azure-shared-image-version.sh`
- [VM creation](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/09-azure-vm-create.sh): `deploy/vhd/09-azure-vm-create.sh`
- [Capture VM details](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/01-azure-get-vm-details.sh): `deploy/vhd/upgrade/01-azure-get-vm-details.sh`
- [Power off VMs](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/02-azure-power-off-vm.sh): `deploy/vhd/upgrade/02-azure-power-off-vm.sh`
- [Attach dummy NIC](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/03-azure-associate-dummy-nic.sh): `deploy/vhd/upgrade/03-azure-associate-dummy-nic.sh`
- [Detach NIC and disk](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/04-azure-disassociate-nic-and-data-disk.sh): `deploy/vhd/upgrade/04-azure-disassociate-nic-and-data-disk.sh`
- [Delete VMs](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/05-azure-delete-vms.sh): `deploy/vhd/upgrade/05-azure-delete-vms.sh`
- [Replace VMs](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/vhd/upgrade/06-azure-create-vms.sh): `deploy/vhd/upgrade/06-azure-create-vms.sh`

### KVM deployment

- [Prepare hypervisor](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/kvm/01-prepare-hypervisor.sh): `deploy/kvm/01-prepare-hypervisor.sh`
- [Run cluster](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/kvm/run-cluster): `deploy/kvm/run-cluster`
- [Upgrade cluster](https://github.com/appdynamics/appd-virtual-appliance/blob/main/deploy/kvm/upgrade-cluster): `deploy/kvm/upgrade-cluster`

### Other components

- **Operator**

## Connections

- Operator → Kafka preparation: runs on source VA (evidence: `README.md`)
- Operator → Credential capture: runs on source VA (evidence: `README.md`)
- Operator → AWS profile: configures and runs (evidence: `README.md`)
- AWS profile → VPC setup: then creates (evidence: `README.md`)
- VPC setup → Image bucket: then creates (evidence: `README.md`)
- Image bucket → IAM role: then creates (evidence: `README.md`)
- IAM role → Image upload: then uploads (evidence: `README.md`)
- Image upload → Snapshot import: then imports (evidence: `README.md`)
- Snapshot import → AMI registration: then registers (evidence: `README.md`)
- AMI registration → VM creation: then creates (evidence: `README.md`)
- Operator → Capture VM details: starts upgrade (evidence: `README.md`)
- Capture VM details → Terminate VMs: then terminates (evidence: `README.md`)
- Terminate VMs → Check VM status: then validates (evidence: `README.md`)
- Check VM status → Replace VMs: then creates (evidence: `README.md`)
- Operator → Resource group: configures and runs (evidence: `README.md`)
- Resource group → Security group: then creates (evidence: `README.md`)
- Security group → Virtual network: then creates (evidence: `README.md`)
- Virtual network → Storage account: then creates (evidence: `README.md`)
- Storage account → Disk image: then creates (evidence: `README.md`)
- Disk image → Image gallery: then creates (evidence: `README.md`)
- Image gallery → Image definition: then defines (evidence: `README.md`)
- Image definition → Image version: then versions (evidence: `README.md`)
- Image version → VM creation: then creates (evidence: `README.md`)
- Operator → Capture VM details: starts upgrade (evidence: `README.md`)
- Capture VM details → Power off VMs: then powers off (evidence: `README.md`)
- Power off VMs → Attach dummy NIC: then associates (evidence: `README.md`)
- Attach dummy NIC → Detach NIC and disk: then detaches (evidence: `README.md`)
- Detach NIC and disk → Delete VMs: then deletes (evidence: `README.md`)
- Delete VMs → Replace VMs: then creates (evidence: `README.md`)
- Operator → Prepare hypervisor: prepares nodes (evidence: `README.md`)
- Prepare hypervisor → Run cluster: then runs cluster (evidence: `README.md`)
- Operator → Upgrade cluster: runs upgrade (evidence: `README.md`)
