AWS Configuration Options - Adaptive Applications - BlueCat Gateway

The Configuration Options section of the Amazon Web Services (AWS) Setup page lets you specify how Cloud Discovery & Visibility (CDV) creates BlueCat Configurations in Address Manager when importing discovered AWS infrastructure resources.

Attention: If you update the name of a BlueCat Configuration or View in Address Manager after you enable Discovery and Visibility, CDV will no longer import AWS infrastructure changes into Address Manager.

You can select from three Configuration modes for Configuration creation conventions:

Default: CDV creates separate Address Manager configurations for each region.

General configurations will be named:
```
<AWS account name>/<Region name>
```
Overlap configurations will be named:
```
<AWS account name>/<Region name>/<VPC ID overlap>
```
or
```
<AWS account name>/<Region name>/<VPC ID overlap>/<VPC name overlap>
```
If you enable discovery of internal Kubernetes resources in EKS Clusters, CDV creates a Configuration for each cluster with the following name:
```
<AWS account name>/<Region name>/<VPC ID>/<Cluster name>
```
Custom: CDV creates separate Address Manager configurations for each region. Configuration names will incorporate a custom name that you enter in the BlueCat Configuration field.

General configurations will be named:
```
<Custom BlueCat Configuration name>/<AWS account name>/<Region name>
```
Overlap configurations will be named:
```
<Custom BlueCat Configuration name>/<AWS account name>/<Region name>/<VPC ID overlap>
```
or
```
<Custom BlueCat Configuration name>/<AWS account name>/<Region name>/<VPC ID overlap>/<VPC name overlap>
```
If you enable discovery of internal Kubernetes resources in EKS Clusters, CDV creates a Configuration for each cluster with the following name:
```
<Custom BlueCat Configuration name>/<AWS account name>/<Region name>/<VPC ID>/<Cluster name>
```
Combined: CDV combines resource information from all resource groups into a single Address Manager configuration, with the custom name that you enter in the BlueCat Configuration field:

General configurations will be named:
```
<BlueCat Configuration name>
```
Overlap configurations will be named:
```
<Custom BlueCat Configuration name>/<AWS account name>/<Region name>/<VPC ID overlap>
```
or
```
<Custom BlueCat Configuration name>/<AWS account name>/<Region name>/<VPC ID overlap>/<VPC name overlap>
```
If you enable discovery of internal Kubernetes resources in EKS Clusters, CDV creates a Configuration for each cluster with the same name as when using the Custom option:
```
<Custom BlueCat Configuration name>/<AWS account name>/<Region name>/<VPC ID>/<Cluster name>
```

Tip: If you instead want BAM Configuration names to put the Region before the AWS Account Name (as in

<Region name>/<AWS account
                name>

), check the Region Name Before Account Configuration Format option under BlueCat Configuration Mode settings.

AWS Configuration Options settings

To access these options, in the CDV banner, click AWS, then click the Setup tab and scroll down to Configuration Options.

The Configuration Options section of the AWS Setup page has the following settings.

AWS region settings

Field/Option Description

Field/Option	Description
AWS Region	The AWS regions from which you want to import the AWS infrastructure information, such as `us-east-1`. By default, you can select checkboxes for multiple regions. CDV will create a separate Discovery job for each selected region. If the AWS Monitoring Options mode is set to Visibility, CDV also creates a visibility job for each region and a Visibility Manager to hold them. You cannot select multiple regions if you configured multiple AWS credentials (for different regions or the same region) in the Advanced tab of the AWS Credentials settings. Note: Discovery will not run on regions that are disabled or inactive within the AWS infrastructure, even if you select it in this list. Currently, only AWS regions for US AWS GovCloud and China Cloud regions are supported. Other cloud regions are either not supported at all, or require additional permissions for Discovery to work.

AWS Region

The AWS regions from which you want to import the AWS infrastructure information, such as us-east-1.

By default, you can select checkboxes for multiple regions. CDV will create a separate Discovery job for each selected region. If the AWS Monitoring Options mode is set to Visibility, CDV also creates a visibility job for each region and a Visibility Manager to hold them.

You cannot select multiple regions if you configured multiple AWS credentials (for different regions or the same region) in the Advanced tab of the AWS Credentials settings.

Note:

Discovery will not run on regions that are disabled or inactive within the AWS infrastructure, even if you select it in this list.
Currently, only AWS regions for US AWS GovCloud and China Cloud regions are supported. Other cloud regions are either not supported at all, or require additional permissions for Discovery to work.

BlueCat Configuration Mode settings

Field/Option Description

Field/Option	Description
Region Name Before Account Configuration Format	If checked, whenever CDV would create a BAM Configuration that includes `/<AWS account name>/<Region name>` (that is, the AWS Account Name followed by the Region), CDV will use `<Region name>/<AWS account name>` instead. This applies to BAM Configurations created for all Configuration Modes (Default, Custom, and Combined).
BlueCat Configuration Mode	Select the Configuration mode for the Configuration creation convention that you want to use: Default: CDV creates separate Address Manager configurations for each region. Custom: CDV creates separate Address Manager configurations for each region. Configuration names will incorporate a custom name that you enter in the BlueCat Configuration field. Combined: CDV combines resource information from all resource groups into a single Address Manager configuration, with the custom name that you enter in the BlueCat Configuration field:
BlueCat Configuration	(Disabled if using the Default Configuration mode for Configuration names.) A customized name to use for BAM Configurations that will be created in BAM to hold information about the AWS infrastructure and its resources. When the Configuration mode is Custom or Combined, this field cannot be empty. Attention: Configuration names cannot contain forward slash characters (`/`). Doing so can cause issues and errors with Discovery and Visibility of cloud resources. Note: If you configure Cloud Discovery & Visibility to retrieve data from a Resource group that has overlapping IP addresses in the Virtual Network, CDV creates multiple Configurations in Address Manager depending on the number of VPCs with overlapping IP addresses.

Region Name Before Account Configuration Format

If checked, whenever CDV would create a BAM Configuration that includes /<AWS account name>/<Region name> (that is, the AWS Account Name followed by the Region), CDV will use <Region name>/<AWS account name> instead.

This applies to BAM Configurations created for all Configuration Modes (Default, Custom, and Combined).

BlueCat Configuration Mode

Select the Configuration mode for the Configuration creation convention that you want to use:

Default: CDV creates separate Address Manager configurations for each region.
Custom: CDV creates separate Address Manager configurations for each region. Configuration names will incorporate a custom name that you enter in the BlueCat Configuration field.
Combined: CDV combines resource information from all resource groups into a single Address Manager configuration, with the custom name that you enter in the BlueCat Configuration field:

BlueCat Configuration

(Disabled if using the Default Configuration mode for Configuration names.)

A customized name to use for BAM Configurations that will be created in BAM to hold information about the AWS infrastructure and its resources. When the Configuration mode is Custom or Combined, this field cannot be empty.

Attention: Configuration names cannot contain forward slash characters (/). Doing so can cause issues and errors with Discovery and Visibility of cloud resources.

Note: If you configure Cloud Discovery & Visibility to retrieve data from a Resource group that has overlapping IP addresses in the Virtual Network, CDV creates multiple Configurations in Address Manager depending on the number of VPCs with overlapping IP addresses.

Create overlapping configuration settings

Field/Option	Description
Create Overlapping Configuration	Select this checkbox to automatically create additional BAM Configurations for networks that overlap with those from different Discovery jobs within the same region. By default, this option is selected. If cleared, CDV will mark all overlapping Configurations and their resources as DROPPED, and they will not be imported into BAM. If a conflicting network is resolved in the cloud, resources in overlapping configurations will be imported back into the general BAM Configuration. Note: When performing discovery on Elastic Kubernetes Services (EKSs), resource information about EKSs (and internal Kubernetes resources within an EKS) are always dropped if they are associated with an overlapping network. CAUTION: Regardless of the whether or not this checkbox is selected, overlapping networks will still be dropped under the following circumstances: When two discovery jobs are executed in consecutive order with the same Address Manager Configuration name, and they are discovering VPCs in those two different regions. When this occurs, in the Discovery Management table (on the Management tab), CDV displays an exclamation icon appears next to the "Completed" status of the discovery job, indicating that VPCs have been dropped.
Override Configuration	Select this checkbox to automatically override existing Configurations in Address Manager that have the same name. Note: If Scheduled Discovery is selected in the AWS Monitoring Options, this checkbox is automatically selected and cannot be changed.

Field/Option

Description

Create Overlapping Configuration

Select this checkbox to automatically create additional BAM Configurations for networks that overlap with those from different Discovery jobs within the same region. By default, this option is selected.

If cleared, CDV will mark all overlapping Configurations and their resources as DROPPED, and they will not be imported into BAM. If a conflicting network is resolved in the cloud, resources in overlapping configurations will be imported back into the general BAM Configuration.

Note: When performing discovery on Elastic Kubernetes Services (EKSs), resource information about EKSs (and internal Kubernetes resources within an EKS) are always dropped if they are associated with an overlapping network.

CAUTION:

Regardless of the whether or not this checkbox is selected, overlapping networks will still be dropped under the following circumstances: When two discovery jobs are executed in consecutive order with the same Address Manager Configuration name, and they are discovering VPCs in those two different regions. When this occurs, in the Discovery Management table (on the Management tab), CDV displays an exclamation icon appears next to the "Completed" status of the discovery job, indicating that VPCs have been dropped.

Override Configuration

Select this checkbox to automatically override existing Configurations in Address Manager that have the same name.

Note: If Scheduled Discovery is selected in the AWS Monitoring Options, this checkbox is automatically selected and cannot be changed.

AWS Configuration Options - Adaptive Applications - BlueCat Gateway - 24.1.1

Cloud Discovery & Visibility Administration Guide

AWS Configuration Options settings