Launching virtual appliances using the AWS CLI - BlueCat Integrity

Advanced users can also launch BlueCat AWS Virtual Appliances instances using the AWS command line interface.

In order to launch instances using the AWS CLI, you must install the AWS CLI and configure it using the AWS Access Key ID and AWS Secret Access Key. For detailed information about installing and configuring the AWS CLI, refer to the following Amazon documentation: https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html

Before you launch the virtual appliance:

Create the YAML license. See the #cloud-config example below for the format of the license file.
Locate the ID of the AMI. AMI IDs can be found by searching for BlueCat in the AWS Marketplace (AWS UI Console). In the Community AMIs tab, find the AMI that matches the purchased SKU and AWS Virtual Appliance version, and verify that the Owner ID is Amazon (679593333241). The ID for the AMI will be listed under the title (i.e. ami-02611a628fa59b375).

Note: Due to limitations with the cloud provider, you cannot change the IP address of BlueCat AWS Virtual Appliances network interfaces after installation. To change the IP address for BlueCat AWS Virtual Appliances, you must re-install BlueCat AWS Virtual Appliances on a new instance with the desired IP address changes and migrate your configuration to the new instance.

To launch BlueCat AWS Virtual Appliances using the AWS CLI, run the following command:

aws ec2 run-instances --image-id <ami-id> --count 1 --instance-type
<type.size> --key-name <aws key-pair> --security-group-ids <secure group
id> --subnet-id <subnet id> --private-ip-address <ip address> --user-data
file://path_to_your_license_file/license.txt

For example:

aws ec2 run-instances --image-id ami-02611a628fa59b375 --count 1 --instance-type
c5.4xlarge --key-name exampleName --security-group-ids sg-9bd625fd --subnetid
subnet-d2ca49b6 --private-ip-address 192.0.2.55 --user-data file://
path_to_your_license_file/license.txt

where license.txt has the following content:

#cloud-config
bluecat_license:
    key: "XXXXX-XXXXX-XXXXX-XXXXX-XXXXX"
    id: "XXXXXXXXXXXX"

Enter the license key you acquired from https://care.bluecatnetworks.com in the key parameter and your AWS account ID in the id parameter.

Note: #cloud-config must be in a valid YAML format. Spaces are required before line 3 and 4 (Activation key and AWS account ID).

Attention: Based on the Address Manager or DNS/DHCP model that you would like to deploy, the --instance-type must be one of the following:

BlueCat Address Manager for AWS

Product SKU	Instance type	vCPUs	Memory (GB)
cBAM-1000	c5.xlarge	4	8
cBAM-5000	c5.4xlarge	16	32
cBAM-7000	c5.9xlarge	36	72

BlueCat DNS and DHCP for AWS

Product SKU	Instance type	vCPUs	Memory (GB)
cBDDS-25	c5.xlarge	4	8
cBDDS-50	c5.2xlarge	8	16
cBDDS-75	c5.4xlarge	16	32
cBDDS-125	c5.9xlarge	36	72

Note: C4.* instance types are no longer recommended due to KI-025622.

For detailed information about AWS instance sizes, refer to https://aws.amazon.com/ec2/instance-types/.