config_aws | Teradata DSA Commands - config_aws - BAR - Data Stream Architecture

Purpose

The config_aws command configures the Amazon S3 Server in the DSA repository based on parameter files.

Syntax

config_aws -f|-file filename

Example

config_aws -f file1.xml

Parameters

f|file filename

The full path and name of the file containing the necessary configuration parameters.

u|user_authentication User

Required when security management is enabled. Supplies the command with the Viewpoint user, and triggers a password prompt for authentication.

Permissions required: Administrator role

Usage Notes

role_name is required. This is the IAM role (see http://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html). When roles are used, all DSA components must be running in the AWS cloud and assigned to this role.

You must enter an AWS account ID (access ID) and IAM user access key for the Amazon S3 application. See http://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_access-keys.html#Using_CreateAccessKey.

Use aws_override_details to update non-AWS S3 vendor properties. These properties are specific to the AWS account configured in DSC.

dsc config_aws -f aws.xml

Data Stream Controller Command Line 17.00.00.00
Command parameters:
-file : aws.xml
Enter access id for account "acctName".

AKIAJYGWLNCJDDZ35AXQ

Enter access key for account "acctName".

*******

Connected to DSC version 17.00.00.00
Saving AWS Backup Application configuration...

XML File Example

<?xml version="1.0" encoding="UTF-8"?>

             <!--****This command must be on one line.****-->
<dscConfigAmzS3 dscVersion="" xmlns="http://schemas.teradata.com/v2012/DSC"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://schemas.teradata.com/v2012/DSC DSC.xsd">

<config_aws_list>
 <!-- character must be alphanumeric, - Required, max characters 32 -->
 <account_name>acctName</account_name>

 <!-- character must be alphanueric, - Required, max characters 64 -->
 <role_name>roleName</role_name>

 <!-- must be region enum -->
 <buckets_by_region>
    <!-- valid regions: us-east-1, us-west-1, us-west-2, eu-west-1,eu-central-1, 
      ap-southeast-1, ap-southeast-2,ap-northeast-1, ap-northeast-2, sa-east-1 -->
     <region>us-east-1</region>
   
       <buckets>
        <!-- character must be alphanumeric, - Required, max characters 512 -->
         <bucket_name>bucketName</bucket_name>

         <prefix_list>
            <!-- character must be alphanumeric, - Required, max characters 256 -->
             <prefix_name>prefix</prefix_name>

            <!-- Required, Integer, min value is 1, max value is 999 --> 
          <storage_devices>1</storage_devices>
         </prefix_list>
       </buckets>
    </buckets_by_region>
<aws_override_details>
             <s3_uri>testbucket1.s3.jp-tok.cloud-object-storage.appdomain.cloud</s3_uri>
			<s3_port>8080</s3_port>
			<s3_use_encryption>false</s3_use_encryption>
			<s3_uri_type>path</s3_uri_type>
			<s3_auth_version>V2</s3_auth_version>
		</aws_override_details>
    </config_aws_list>
</dscConfigAmzS3>