15.11 - config_target_groups - Data Stream Architecture

Teradata Data Stream Architecture (DSA) User Guide

prodname
Data Stream Architecture
vrm_release
15.11
created_date
December 2016
category
User Guide
featnum
B035-3150-026K

Purpose

The config_target_groups command configures the target groups based on the target type and the information from the parameters file.

Syntax

config_target_groups -t|-type Target Type -f|-file File -B|-repository_backup -S|-skip_prompt

Example

dsc config_target_groups -t target_nbu -f TargetGroupParameters.xml -B -S

dsc config_target_groups -t remote_file_system -f test.xml

Parameters

t|type Type
The type of the BAR component to add to the target group. Target group types are DUMMY, TARGET_NBU, REMOTE_FILE_SYSTEM, TARGET_DDBOOST, TARGET_S3 and TARGET_AZURE.
target_nbu
f|file filename
The full path and name of the file containing the necessary configuration parameters.
TargetGroupParameters.xml
B|repository_backup Repository Backup
[Optional] Marks a target group for repository backup. Only valid for the TARGET_NBU, REMOTE_FILE_SYSTEM, or TARGET_DDBOOST types.
S|Skip_prompt SkipPrompt
[Optional] Skips displaying a confirmation message before performing the command action.
u|user_authentication User
Required when security management is enabled. Supplies the command with the Viewpoint user, and triggers a password prompt for authentication.

Usage Notes

When using a REMOTE_FILE_SYSTEM target group type, the following is true:
  • If the path defined in <mounted_file_system> is the same among multiple media servers, the path implies that the media server is a NFS mount that all the media servers can access the data written under the same <mounted_file_system>.
  • If one of the media servers is offline during a restore, analyze_read or query_backupids command, DSA will automatically replace the media server with a media server that can access the same mounted file system.
When using a TARGET_DDBOOST target group type, the following is true:
  • If the values in <target_entity> and <storage_units> are the same among multiple media servers, the values imply that these media servers can access the data written on the same <target_entity> and <storage_units>.
  • If one of the media servers is offline during a restore, analyze or query_backupids command, DSA will automatically replace the media server with a media server that can access the same target entity and storage units.

Before configuring a different type of target group, the media server must have the corresponding AXM module installed. Use list_access_module to verify which AXM modules are installed.

The component name can only use the following characters: 'A-Z', 'a-z', '0-9' and '_'.

XML File Examples

A sample XML file to configure a remote media target group (target_nbu) is shown below.

  <?xml version="1.0" encoding="UTF-8" standalone="yes" ?> 
- <!-- 
   --> 
- <dscConfigTargetGroupsRemoteMedia dscVersion="dscVersion1" xmlns="http://schemas.teradata.com/v2012/DSC">
- <!--  'target_group_name' - Required,  max 32 characters, first character must be alphanumeric only. 
  --> 
  <target_group_name>SampleTargetGroup</target_group_name> 
- <!--  'is_enabled' Optional, accepted values: true/false. Default : false 
  --> 
  <is_enabled>true</is_enabled> 
- <!--  'target_entity' - Required, max 32 characters 
  --> 
  <target_entity>nbu52</target_entity> 
- <!--  'targets' - Required (at least one) 
  --> 
- <targets>
- <!--  'bar_media_server' - Required, max 32 characters 
  --> 
  <bar_media_server>SampleMediaServer1</bar_media_server> 
- <!--  'policy_class' - Required (at least one) 
  --> 
- <policy_class>
- <!--  'policy_class_name' - Required, max 32 characters. Policy must exist on target_entity. 
  --> 
  <policy_class_name>policy75</policy_class_name> 
- <!--  'devices' - Required 
  --> 
  <devices>1</devices> 
  </policy_class>
- <policy_class>
  <policy_class_name>policy76</policy_class_name> 
  <devices>1</devices> 
  </policy_class>
  </targets>
- <targets>
  <bar_media_server>SampleMediaServer2</bar_media_server> 
- <policy_class>
  <policy_class_name>policy75</policy_class_name> 
  <devices>1</devices> 
  </policy_class>
- <policy_class>
  <policy_class_name>policy76</policy_class_name> 
  <devices>1</devices> 
  </policy_class>
  </targets>
  </dscConfigTargetGroupsRemoteMedia>
A sample XML file to configure a remote file system target group is shown below.
 <?xml version="1.0" encoding="UTF-8" standalone="yes" ?> 
- <dscConfigTargetGroupsRemoteFile xmlns="http://schemas.teradata.com/v2012/DSC">
  <target_group_name>t_remote_fs</target_group_name> 
  <is_enabled>true</is_enabled> 
- <mounted_file_system_remote>
  <bar_media_server>barms2</bar_media_server> 
- <file_system>
  <mounted_file_system>/tmp/jing_test</mounted_file_system> 
  <files>3</files> 
  </file_system>
  </mounted_file_system_remote>
  </dscConfigTargetGroupsRemoteFile>
A sample XML file to configure a DD Boost target group is shown below.
 <?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<dscConfigTargetGroupsDDBoost dscVersion="dscVersion1" xmlns="http://schemas.teradata.com/v2012/DSC">

<!-- 'target_group_name' - Required, max 32 characters, first character must be alphanumeric only. -->
<target_group_name>dd_boost_tg1</target_group_name>

<!-- 'is_enabled' Optional, accepted values: true/false. Default : false -->
<is_enabled>true</is_enabled>

<!-- 'targets' - Required (at least one) -->
<targets>
<!-- 'target_entity' - Required, max 32 characters -->
<target_entity>dddomain1</target_entity>

<media_storage_units>
<!--media_storage_units' - Required (at least one) -->
<bar_media_server>barvm12</bar_media_server>
<!-- 'bar_media_server' - Required, max 32 characters -->

<!-- storage_units' - Required (at least one) -->
<storage_units>

<!-- 'storage_unit_name' - Required, max characters 50, alphanumeric and "-","_" -->
<storage_unit_name>storage_unit1</storage_unit_name>

<!-- 'max_files' - Required, Integer, min value is 1-->
<files>40</files>

</storage_units>
</media_storage_units>
</targets>

<targets>
<!-- 'target_entity' - Required, max 32 characters -->
<target_entity>dddomain2</target_entity>

<media_storage_units>
<!--media_storage_units' - Required (at least one) -->
<bar_media_server>barvm13</bar_media_server>
<!-- 'bar_media_server' - Required, max 32 characters -->

<!-- storage_units' - Required (at least one) -->
<storage_units>

<!-- 'storage_unit_name' - Required, max characters 50, alphanumeric and "-","_" -->
<storage_unit_name>storage_unit2</storage_unit_name>

<!-- 'max_files' - Required, Integer, min value is 1-->
<files>45</files>

</storage_units>
</media_storage_units>
</targets>

</dscConfigTargetGroupsDDBoost>
A sample XML file to configure an S3 target group is shown below:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<dscConfigTargetGroupsAmzS3 dscVersion="dscVersion1" xmlns="http://schemas.teradata.com/v2012/DSC">

	<!-- 'target_group_name' - Required,  max 32 characters, first character must be alphanumeric only. -->
	<target_group_name>SampleTargetGroup</target_group_name>
	
	<!-- 'is_enabled' Optional, accepted values: true/false. Default : false -->
	<is_enabled>true</is_enabled>
	
	<!-- 'aws_account_name'- Required, max 32 characters -->
	<account_name>accountName</account_name>
	
	<!-- 'region' - Required, max 30 characters -->
	<region>us-east-1</region>
	
	<!-- 'targets' - Required (at least one) -->
	<targetMediaBuckets>
		<!-- 'bar_media_server' - Required, max 32 characters -->
		<bar_media_server>SampleMediaServer1</bar_media_server>
		
		<!-- 'buckets' - Required (at least one) -->
		<buckets>
			<!-- 'bucket_name' - Required, max 512 characters. Bucket must exist on the region -->
			<bucket_name>bucket1</bucket_name>
			
			<!-- 'prefix_list' - Required (at least one) -->
			<prefix_list>
				<!-- 'prefix_name' - Required, max 256 characters -->
				<prefix_name>prefix1/prefix2/</prefix_name>
				<!-- 'storage_devices' - Required -->
				<storage_devices>1</storage_devices>
			</prefix_list>
		</buckets>
	</targetMediaBuckets>
	<targetMediaBuckets>
		<!-- 'bar_media_server' - Required, max 32 characters -->
		<bar_media_server>SampleMediaServer2</bar_media_server>
		
		<!-- 'buckets' - Required (at least one) -->
		<buckets>
			<!-- 'bucket_name' - Required, max 512 characters. Bucket must exist on the region -->
			<bucket_name>bucket2</bucket_name>
			
			<!-- 'prefix_list' - Required (at least one) -->
			<prefix_list>
				<!-- 'prefix_name' - Required, max 256 characters -->
				<prefix_name>prefix1/prefix2/</prefix_name>
				<!-- 'storage_devices' - Required -->
				<storage_devices>1</storage_devices>
			</prefix_list>				
		</buckets>
	</targetMediaBuckets>
</dscConfigTargetGroupsAmzS3>
A sample XML file to configure an Azure Blob storage target group is shown below:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dscConfigTargetGroupsAzureBlobStorage xmlns="http://schemas.teradata.com/v2012/DSC">
    <target_group_name>azure_tg</target_group_name>
    <is_enabled>true</is_enabled>
    <storage_account>azure_storage_account</storage_account>
    <storage_type>cool</storage_type>
    <targetMediaBlob>
        <bar_media_server>mediaserver1</bar_media_server>
        <blobs>
           <blob_container>blob1</blob_container>
            <prefix_list>
                <prefix_name>prefix1</prefix_name>
                <storage_devices>100</storage_devices>
            </prefix_list>
             <prefix_list>
            <prefix_name>prefix2</prefix_name>
            <storage_devices>50</storage_devices>
            </prefix_list>
        </blobs>
    </targetMediaBlob>  
     <targetMediaBlob>
            <bar_media_server>mediaserver2</bar_media_server>
            <blobs>
               <blob_container>blob2</blob_container>
                <prefix_list>
                    <prefix_name>prefix3</prefix_name>
                    <storage_devices>60</storage_devices>
                </prefix_list>                 
            </blobs>
    </targetMediaBlob>
</dscConfigTargetGroupsAzureBlobStorage>