config_target_groups - BAR - Data Stream Architecture

Teradata® DSA 用户指南
Product
BAR
Data Stream Architecture
Release Number
17.20
Published
2022 年 3 月
Language
中文 (简体)
Last Update
2022-04-14
dita:mapPath
zh-CH/bis1632417576364.ditamap
dita:ditavalPath
zh-CH/vwp1576617377804.ditaval
dita:id
B035-3150
Product Category
Software
Teradata Tools and Utilities

用途

config_target_groups 命令可根据目标类型和参数文件中的信息来配置目标组。

  • NetBackup 和 DDBoost 的新 disable_gen_zero 标志。如果为 true，则任何媒体服务器脱机，备份作业都将被拒绝。
  • 新的 repository_replication 标志。如果为 true，则备份数据会从系统登录区域复制到第三方存储。

语法

config_target_groups -t|-type Target Type -r|repository_replication -f|-file File -B|backup_repository -S|-skip_prompt

示例

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

dsc config_target_groups -t remote_file_system -f test.xml

dsc config_target_groups -t TARGET_S3 -r -f replication_tg_S3.xml

参数

t|type Type
要添加到目标组的 BAR 组件的类型。目标组类型是 DUMMY、TARGET_NBU、REMOTE_FILE_SYSTEM、TARGET_DDBOOST、TARGET_S3、TARGET_AZURE 和 TARGET_GCP。
示例: target_nbu
f|file filename
包含必要配置参数的文件的完整路径和文件名。
示例: TargetGroupParameters.xml
r|repository_replication
[可选] 标记要复制的目标组。适用于目标组类型 TARGET_NBU、REMOTE_FILE_SYSTEM、TARGET_DDBOOST、TARGET_S3、TARGET_AZURE 和 TARGET_GCP。
S|skip_prompt SkipPrompt
[可选] 执行命令操作前跳过确认消息显示。
u|user_authentication User
如果启用了安全管理，则需要使用此参数。为命令提供 Viewpoint 用户，并触发用于身份验证的密码提示。

所需权限：管理员角色

用法说明

在现有目标组中添加或移除策略、存储单元或文件路径时，需满足以下条件：
  • 如果使用现有目标组生成了有效的保存集，则无法在该目标组中删除策略、存储单元或文件路径。
  • 从现有目标组中删除策略、存储单元或文件路径时，如果在目标组映射的源或目标中使用了该策略、存储单元或文件路径，则 DSC 将自动禁用目标组映射。
  • 向现有目标组添加新策略、存储单元或文件路径时，如果将该目标组定义为目标组映射中的源目标组，则 DSC 将禁用目标组映射。
使用 REMOTE_FILE_SYSTEM 目标组类型时会出现以下情况︰
  • 如果在 <mounted_file_system> 中定义的路径在多个媒体服务器中相同，此路径意味着该媒体服务器是 NFS 装载，所有媒体服务器可以访问写入同一 <mounted_file_system> 下的数据。
  • 如果在运行 restore、analyze_read 或 query_backupids 命令期间，其中一个媒体服务器处于脱机状态，则 DSA 会自动将此媒体服务器替换为可以访问相同挂载文件系统的媒体服务器。
使用 TARGET_DDBOOST 目标组类型时会出现以下情况：
  • 如果 <target_entity> 和 <storage_units> 中的值在多个媒体服务器中相同，这些值意味着这些媒体服务器可以访问写入同一 <target_entity> 和 <storage_units> 的数据。
  • 如果在运行 restore、analyze 或 query_backupids 命令期间，其中一个媒体服务器处于脱机状态，则 DSA 会自动将此媒体服务器替换为可以访问相同目标实体和存储单元的媒体服务器。

在配置不同类型的目标组之前，媒体服务器必须安装相应的 AXM 模块。使用 list_access_module 验证安装了哪些 AXM 模块。

组件名称只能使用以下字符：“A-Z”、“a-z”、“0-9”和“_”。

XML 文件示例 - 远程媒体目标组 (NetBackup)

下面显示了一个用于配置远程媒体目标组 (TARGET_NBU) 的示例 XML 文件。
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

                 <!--****The command below must be on one line.****-->
<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 30 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 128 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>
	
<!-- 'disable_gen_zero' Optional, accepted values: true/false. Default: false -->
<disable_gen_zero>true</disable_gen_zero>

</dscConfigTargetGroupsRemoteMedia>

XML 文件示例 - 远程文件系统目标组

下面显示了一个用于配置远程文件系统目标组 (REMOTE_FILE_SYSTEM) 的示例 XML 文件。 
<?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>

XML 文件示例 - DDBoost 目标组

下面显示了一个用于配置 DDBoost 目标组 (TARGET_DDBOOST) 的示例 XML 文件。 
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

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

<!-- 'target_group_name' - Required,  max 30 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>
	    
   <!-- 'bar_media_server' - Required, max 32 characters -->
   <media_storage_units>
     <!--media_storage_units' - Required (at least one) -->
     <bar_media_server>barvm12</bar_media_server>
		
     <!-- 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>
	
<!-- 'disable_gen_zero' Optional, accepted values: true/false. Default : false -->
<disable_gen_zero>true</disable_gen_zero>
	
</dscConfigTargetGroupsDDBoost>

XML 文件示例 - Amazon S3 目标组

下面显示了一个用于配置 S3 目标组 (TARGET_S3) 的示例 XML 文件。
<?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>

XML 文件示例 - Azure Blob 目标组

下面显示了一个用于配置 Azure Blob 目标组 (TARGET_AZURE) 的示例 XML 文件。

<?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>
  <targets>
    
  <!-- 'Storage account' - Required, max length 24, lower case -->
    <storage_account>azure_storage_account1</storage_account>
        
  <!-- 'Storage account enumeration ' - Required, valid values: cool, hot -->
    <storage_type>cool</storage_type>
  <targetMediaBlob>
    <!-- 'bar_media_server' - Required, max 32 characters -->
      <bar_media_server>mediaserver1</bar_media_server>
      
      <blobs>
        <!-- 'Blob container name' - Required, max length 63, lower case, at least 
        one -->
          <blob_container>blob1</blob_container>
          <prefix_list>
          <!-- 'Prefix name' - Required, max length 256, at least one -->
            <prefix_name>prefix1/</prefix_name>
                    
            <!-- 'storage_devices' - Required -->
              <storage_devices>100</storage_devices>
          </prefix_list>
       </blobs>
  </targetMediaBlob>
        
  <targetMediaBlob>
    <!-- 'bar_media_server' - Required, max 32 characters -->
      <bar_media_server>mediaserver2</bar_media_server>
      <blobs>
      <!-- 'Blob container name' - Required, max length 63, lower case, at least 
      one -->
        <blob_container>blob1</blob_container>
        <prefix_list>
        <!-- 'Prefix name' - Required, max length 256, at least one -->
          <prefix_name>prefix1/</prefix_name>
                    
          <!-- 'storage_devices' - Required -->
            <storage_devices>100</storage_devices>
        </prefix_list>
      </blobs>
    </targetMediaBlob>
  </targets>
  <targets>
    <!-- 'Storage account' - Required, max length 24, lower case -->
      <storage_account>azure_storage_account2</storage_account>
      <!-- 'Storage account enumeration' - Required, valid values: cool, hot -->
        <storage_type>cool</storage_type>
        <targetMediaBlob>
          <!-- 'bar_media_server' - Required, max 32 characters -->
            <bar_media_server>mediaserver2</bar_media_server>
     <blobs>
        <blob_container>blob2</blob_container>
          <prefix_list>
            <prefix_name>prefix1/</prefix_name>
              <storage_devices>100</storage_devices>
          </prefix_list>
     </blobs>
   </targetMediaBlob>
 </targets>
</dscConfigTargetGroupsAzureBlobStorage>

XML 文件示例 - GCP 存储目标组

下面显示了一个用于配置 GCP 存储目标组 (TARGET_GCP) 的示例 XML 文件。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<dscConfigTargetGroupsGcpStorage xmlns="http://schemas.teradata.com/v2012/DSC">
   <!-- 'target_group_name' - Required, max 43 characters, can only consist of 
   "a-z, A-Z, 0-9, _, -" characters and first character must be alphanumeric
   only. -->
   <target_group_name>gcp_tg</target_group_name>
   <is_enabled>true</is_enabled>
   <targets>
       <!-- 'account_name' - Required, max length 1024, lower case -->
       <account_name>accountName</account_name>
       <targetMediaBuckets>
           <!-- 'bar_media_server' - Required, max 32 characters -->
           <bar_media_server>mediaserver1</bar_media_server>
           <buckets>
              <!-- 'bucket_name' - Required
                 - only lowercase letters, numbers, dashes (-), underscores (_), 
                 and dots (.). Spaces are not allowed
                 - start and end with a number or letter
                 - contain 3-63 characters. Names containing dots can contain up 
                 to 222 characters, but each dot-separated component can be no 
                 longer than 63 characters
                 - cannot be represented as an IP address in dotted-decimal 
                 notation (for example, 192.168.5.4)
                 - cannot begin with the "goog" prefix
                 - cannot contain "google" or close misspellings, such as "g00gle"
              -->
              <bucket_name>>bucketName1</bucket_name>
              <prefix_list>
                  <!-- 'prefix_name' - Required
	             - may contain letters, digits, spaces, hyphens and 
                  underscores
                     - start and end with a letter or digit
                     - 30 characters or less
                     - distinct from all other folders that share its parent  
                  -->
                  <prefix_name>folder1/</prefix_name>
                  <!-- 'storage_devices' - Required -->
                  <storage_devices>100</storage_devices>
              </prefix_list>
           </buckets>
       </targetMediaBuckets>
       <targetMediaBuckets>
           <!-- 'bar_media_server' - Required, max 32 characters -->
           <bar_media_server>mediaserver2</bar_media_server>
           <buckets>
               <!-- 'bucket_name' - Required
                  - only lowercase letters, numbers, dashes (-), underscores (_), 
                  and dots (.). Spaces are not allowed
                  - start and end with a number or letter
                  - contain 3-63 characters. Names containing dots can contain up 
                  to 222 characters, but each dot-separated component can 
                  be no longer than 63 characters
                  - cannot be represented as an IP address in dotted-decimal 
                  notation (for example, 192.168.5.4)
                  - cannot begin with the "goog" prefix
                  - cannot contain "google" or close misspellings, such as "g00gle"
               -->
               <bucket_name>>bucketName2</bucket_name>
               <prefix_list>
                   <!-- 'prefix_name' - Required
	              - may contain letters, digits, spaces, hyphens and 
                   underscores
                      - start and end with a letter or digit
                      - 30 characters or less
                      - distinct from all other folders that share its parent  
                   -->
                   <prefix_name>folder2/</prefix_name>
                   <!-- 'storage_devices' - Required -->
                   <storage_devices>100</storage_devices>
               </prefix_list>
           </buckets>
       </targetMediaBuckets>
   </targets>
</dscConfigTargetGroupsGcpStorage>