config_target_group_map | Teradata DSA Commands - 17.20 - config_target_group_map - BAR - Data Stream Architecture

Teradata® DSA User Guide

Product
BAR
Data Stream Architecture
Release Number
17.20
Release Date
October 2021
Content Type
User Guide
Publication ID
B035-3150-101K
Language
English (United States)

Purpose

The config_target_group_map command configures the map between target groups when restoring to a different client configuration.

Syntax

config_target_group_map -f|-file Name

Example

dsc config_target_group_map -f target_group_mapping.xml

Parameter

f|file filename
The full file path and file name of the file containing the target group mapping parameters
target_group_mapping.xml
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

V|virtual
[Optional] Indicates this is a mapping from a virtual target group to a physical target group.

Usage Notes

All backup (source) sub-targets must have a mapping in the XML file in order to succeed. Each backup (source) sub-target must be mapped to only one restore (destination).

Any changes to either target group using the config_target_groups command could disable the mappings attached to the specific target. If the new target group configuration adds or removes sub-targets, it will disable all mappings associated with the target group. To re-enable the mappings, reconfigure that mapping reflecting the target group changes using the config_target_group_map command.

XML File Examples

Representative XML files containing target group mapping are shown below. Note the following:
  • master_source_target_name is required.
  • master_dest_target_name is required.
  • In the list of target_group_maps, at least one is needed.
  • master_source_dsc_id is optional if mapping between two physical target groups, but required if mapping between a virtual target and a physical target.

XML File Example - Remote Media Target Group Map (NetBackup)

<?xml version="1.0" encoding="UTF-8" standalone="yes" ?> 
<dscConfigTargetGroupMap xmlns="http://schemas.teradata.com/v2012/DSC">
      <master_source_target_name>hawaii2_tg</master_source_target_name>
      <master_source_dsc_id>hawaii2</master_source_dsc_id>
      <master_dest_target_name>remote_nbu</master_dest_target_name>
      <target_group_maps>
            <source_mediaserver_name>hawaii2</source_mediaserver_name>
            <source_policy_class_name>policy_h2</source_policy_class_name>
            <dest_mediaserver_name>barms1.teradata.com</dest_mediaserver_name>
            <dest_policy_class_name>policy1</dest_policy_class_name>
      </target_group_maps>
      <target_group_maps>
            <source_mediaserver_name>hawaii2</source_mediaserver_name>
            <source_policy_class_name>policy_h2</source_policy_class_name>
            <dest_mediaserver_name>barms3</dest_mediaserver_name>
            <dest_policy_class_name>policy3</dest_policy_class_name>
	</target_group_maps>
</dscConfigTargetGroupMap>

XML File Example - Remote File System Target Group Map

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dscConfigTargetGroupMap xmlns="http://schemas.teradata.com/v2012/DSC">
     <!--  This map to be used only for Remote File System target groups. -->
	<master_source_target_name>MasterSampSource</master_source_target_name>
	<master_source_dsc_id>MasterSrcDscIdSample</master_source_dsc_id>
	<master_dest_target_name>MasterSampDest</master_dest_target_name>
	<target_group_fs_maps>
		<source_mediaserver_name>SampSrcMS1</source_mediaserver_name>
		<source_path>/var/opt/teradata/datafiles/path1</source_path>
		<dest_mediaserver_name>SampDestMS1</dest_mediaserver_name>
		<dest_path>/var/opt/teradata/datafiles/path4</dest_path>
	</target_group_fs_maps>
	<target_group_fs_maps>
		<source_mediaserver_name>SampSrcMS1</source_mediaserver_name>
		<source_path>/var/opt/teradata/datafiles/path2</source_path>
		<dest_mediaserver_name>SampDestMS2</dest_mediaserver_name>
		<dest_path>/var/opt/teradata/datafiles/path3</dest_path>
	</target_group_fs_maps>
	<target_group_fs_maps>
		<source_mediaserver_name>SampSrcMS2</source_mediaserver_name>
		<source_path>/var/opt/teradata/datafiles/path3</source_path>
		<dest_mediaserver_name>SampDestMS2</dest_mediaserver_name>
		<dest_path>/var/opt/teradata/datafiles/path2</dest_path>
	</target_group_fs_maps>
	<target_group_fs_maps>
		<source_mediaserver_name>SampSrcMS3</source_mediaserver_name>
		<source_path>/var/opt/teradata/datafiles/path4</source_path>
		<dest_mediaserver_name>SampDestMS1</dest_mediaserver_name>
		<dest_path>/var/opt/teradata/datafiles/path1</dest_path>
	</target_group_fs_maps>
</dscConfigTargetGroupMap>

XML File Example - DDBoost Target Group Map

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dscConfigTargetGroupMap xmlns="http://schemas.teradata.com/v2012/DSC">
     <!--  This map to be used only for DDBoost target groups. -->
	<master_source_target_name>MasterSampSource</master_source_target_name>
	<master_source_dsc_id>MasterSrcDscIdSample</master_source_dsc_id>
	<master_dest_target_name>MasterSampDest</master_dest_target_name>
	<target_group_ddboost_maps>
	     <source_target_entity>SrcTE</source_target_entity>
		<source_mediaserver_name>SampSrcMS1</source_mediaserver_name>
		<source_storage_unit>src_storage_unit1</source_storage_unit>
		<dest_target_entity>DestTE</dest_target_entity>
		<dest_mediaserver_name>SampDestMS</dest_mediaserver_name>
		<dest_storage_unit>dest_storage_unit</dest_storage_unit>
	</target_group_ddboost_maps>
	<target_group_ddboost_maps>
          <source_target_entity>SrcTE</source_target_entity>
          <source_mediaserver_name>SampSrcMS1</source_mediaserver_name>
          <source_storage_unit>src_storage_unit2</source_storage_unit>
          <dest_target_entity>DestTE</dest_target_entity>
          <dest_mediaserver_name>SampDestMS</dest_mediaserver_name>
          <dest_storage_unit>dest_storage_unit</dest_storage_unit>
    </target_group_ddboost_maps>
	<target_group_ddboost_maps>
	     <source_target_entity>SrcTE</source_target_entity>
		<source_mediaserver_name>SampSrcMS2</source_mediaserver_name>
		<source_storage_unit>src_storage_unit3</source_storage_unit>
		<dest_target_entity>DestTE</dest_target_entity>
		<dest_mediaserver_name>SampDestMS</dest_mediaserver_name>
		<dest_storage_unit>dest_storage_unit</dest_storage_unit>
	</target_group_ddboost_maps>
</dscConfigTargetGroupMap>

XML File Example - Amazon S3 Target Group Map

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dscConfigTargetGroupMap xmlns="http://schemas.teradata.com/v2012/DSC">
    <!--  This map to be used only for AWS target groups. -->
	<master_source_target_name>tgaws1</master_source_target_name>
	<master_source_dsc_id>local-dsc-john</master_source_dsc_id>
	<master_dest_target_name>tgaws2</master_dest_target_name>
	<target_group_amzs3_maps>
		<source_mediaserver_name>sdld0280</source_mediaserver_name>
		<source_bucket_name>bucket01</source_bucket_name>
		<source_prefix_name>prefix01/</source_prefix_name>
		<dest_mediaserver_name>sdld0281</dest_mediaserver_name>
		<dest_bucket_name>bucket02</dest_bucket_name>
		<dest_prefix_name>prefix02/</dest_prefix_name>
	</target_group_amzs3_maps>	
</dscConfigTargetGroupMap>

XML File Example - Azure Blob Target Group Map

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dscConfigTargetGroupMap xmlns="http://schemas.teradata.com/v2012/DSC">
    <!--  This map to be used only for Azure target groups. -->
	<master_source_target_name>azure1_tg</master_source_target_name>
	<master_source_dsc_id>local-dsc-john</master_source_dsc_id>
	<master_dest_target_name>azure2_tg</master_dest_target_name>
	<target_group_azure_maps>
		<source_storage_account>storageacct1</source_storage_account>
		<source_blob_container>udaesblob01</source_blob_container>
		<source_prefix_name>prefix-1</source_prefix_name>
		<dest_storage_account>storageacct2</dest_storage_account>
		<dest_blob_container>udaesblob03</dest_blob_container>
		<dest_prefix_name>prefix-3/</dest_prefix_name>
	</target_group_azure_maps>
</dscConfigTargetGroupMap>

XML File Example - GCP Storage Target Group Map

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dscConfigTargetGroupMap xmlns="http://schemas.teradata.com/v2012/DSC">
	<!--  This map to be used only for GCP target groups. -->
    <master_source_target_name>gcp_tg1</master_source_target_name>
    <master_source_dsc_id>local-dsc</master_source_dsc_id>
    <master_dest_target_name>gcp_tg2</master_dest_target_name>
    <target_group_gcp_maps>
        <source_account_name>storageaccount1</source_account_name>
        <source_bucket_name>bucket1</source_bucket_name>
        <source_prefix_name>prefix1/</source_prefix_name>
        <dest_account_name>storageaccount2</dest_account_name>
        <dest_bucket_name>bucket2</dest_bucket_name>
        <dest_prefix_name>prefix2/</dest_prefix_name>
    </target_group_gcp_maps>
</dscConfigTargetGroupMap>