You can deploy Virtual Appliance in Amazon EC2 by using an Amazon Machine Image (AMI).

This document contains links to AWS documentation. Splunk AppDynamics makes no representation as to the accuracy of AWS documentation because Amazon controls its own documentation.

Prepare the AWS Environment

To deploy virtual machines in AWS, you require the following AWS resources. You can create or configure the AWS resources through the AWS portal or AWS CLI.

To use AWS CLI, you require reference scripts. Download these script from the Splunk AppDynamics GitHub repository. We recommend that you run the scripts in the given order. Before you run these scripts, in config.cfg, ensure to update or verify the configuration details such as tags, deployment configuration, and IP addresses.
For more information about AWS CLI, see AWS CLI Documentation.

To create virtual machines in AWS, you must use the m5a.4xlarge instance type. See M5a instances.


AWS ResourcesDescriptionReference Scripts
1AWS ProfileAn AWS profile helps you identify the business resources in the AWS environment. You can create or use the existing profile. See Profiles.01-aws-create-profile.sh
2Virtual Private Network (VPC)

Amazon VPC provides an isolated virtual network for the Virtual Appliance where you can install the Splunk AppDynamics services. You can create or use the existing VPC. See What is Amazon VPC?

02-aws-add-vpc.sh
3S3 BucketAn S3 bucket is required to store an AMI and create an image. See Creating a Bucket.03-aws-create-image-bucket.sh
4IAM RoleYou can manage permissions for your AWS resources by using an IAM role. See IAM roles.04-aws-import-iam-role.sh
5Image

Upload the Splunk AppDynamics image in the S3 bucket that generates the AMI for Virtual Appliance. See Uploading objects.

05-aws-upload-image.sh
6Snapshot

Snapshots help in using the AMI that you have uploaded to S3 bucket. Complete the following steps to obtain an AMI ID:

  1. Import the snapshot.
  2. Register the snapshot.

The AMI ID is used to create virtual machines.


06-aws-import-snapshot.sh

07-aws-register-

snapshot.sh

Create Virtual Machines

Splunk AppDynamics On-Premises Virtual Appliance requires three virtual machines. Create three virtual machines in the AWS portal by using the AMI ID.

Ensure that the virtual machines follow the supported sizing requirements. See Sizing Requirements.

For more information about creating virtual machines, see run-instances.

Alternatively, you can run the 08-aws-create-vms.sh file by using AWS CLI to create three virtual machines.

Bootstrap the AWS Instance

After you deploy the virtual machines, you must bootstrap the AWS instance so virtual machines can use the instance details.

  1. Log in to console of the node using the appduser credentials.

    By default, the node password is set to changeme.

  2. Run the following command to bootstrap the AWS instance.
    sudo appdctl host init
    CODE
  3. Specify the following AWS instance details:
    • Hostname
    • Host IP address (CIDR format)
    • Default gateway IP address
    • DNS server IP address

Verify the Configuration of the Virtual Machines

After you create three virtual machines, verify the configuration is correct and the server is ready to install the Splunk AppDynamics services.

  1. Log in to one of the node consoles using the appduser credentials.
  2. Run the appdctl show boot command on each node of the cluster.

    Sample Output

    NAME              | STATUS    | ERROR 
    -------------------+-----------+-------
     firewall-setup    | Succeeded | --    
     hostname          | Succeeded | --    
     netplan           | Succeeded | --    
     ssh-setup         | Succeeded | --    
     storage-setup     | Succeeded | --    
     cert-setup        | Succeeded | --    
     enable-time-sync  | Succeeded | --    
     microk8s-setup    | Succeeded | --    
     cloud-init-config | Succeeded | --  
    CODE

    An error might appear for the appdctl show boot command. Run the command again after few minutes to resolve this error. See Troubleshoot Virtual Appliance Issues.

Next Steps

  1. You can review and update the parameters in the helm file. For more information about the helm file parameters, see Customize the Helm File.
  2. Install Cisco AppDynamics Services.