17.20 - config_target_groups - BAR - Data Stream Architecture

Teradata® DSA Guía del usuario

Product
BAR
Data Stream Architecture
Release Number
17.20
Published
Marzo de 2022
Content Type
Guía del usuario
Publication ID
B035-3150-101K-ESN
Language
Español (España)

Propósito

El comando config_target_groups configura los grupos de destino sobre la base del tipo de destino y la información del archivo de parámetros.

  • Nueva marca disable_gen_zero para NetBackup y DDBoost. Cuando el valor es true, se rechazan los trabajos de copia de seguridad si algún servidor de medios está sin conexión.
  • Nueva marca repository_replication. Cuando el valor es true, los datos de copia de seguridad se replican desde la zona de aterrizaje del sistema al almacenamiento de terceros.

Sintaxis

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

Ejemplo

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

Parámetros

t|type Type
El tipo de componente de BAR que se agregará al grupo de destino. Los tipos de grupo de destino son DUMMY, TARGET_NBU, REMOTE_FILE_SYSTEM, TARGET_DDBOOST, TARGET_S3, TARGET_AZURE y TARGET_GCP.
Ejemplo: target_nbu
f|file filename
El nombre y la ruta completa del archivo que contiene los parámetros de configuración necesarios.
Ejemplo: TargetGroupParameters.xml
r|repository_replication
[Opcional] Marca un grupo objetivo para la replicación. Válido para los tipos de grupo objetivo TARGET_NBU, REMOTE_FILE_SYSTEM, TARGET_DDBOOST, TARGET_S3, TARGET_AZURE y TARGET_GCP.
S|skip_prompt SkipPrompt
[Opcional] Omite la presentación de un mensaje de confirmación antes de realizar la acción del comando.
u|user_authentication User
Obligatorio cuando está habilitada la administración de seguridad. Proporciona el comando con el usuario de Viewpoint y desencadena una petición de contraseña para autenticación.

Permisos requeridos: rol de administrador

Notas sobre el uso

Cuando se agrega o se elimina una directiva, una unidad de almacenamiento o una ruta de archivo de un grupo de destino existente, se deben cumplir las siguientes condiciones:
  • No se puede eliminar una directiva, una unidad de almacenamiento ni una ruta de archivo de un grupo de destino existente si se ha utilizado para generar un conjunto de guardado válido.
  • Cuando se quita una directiva, una unidad de almacenamiento o una ruta de archivo de un grupo de destino existente, el DSC deshabilita automáticamente la asignación de grupos de destino si dicha directiva, unidad de almacenamiento o ruta de archivo se utiliza en la asignación del grupo de destino de origen o de destino.
  • Cuando se agrega una nueva directiva, una unidad de almacenamiento o una ruta de archivo a un grupo de destino existente, el DSC deshabilita la asignación del grupo de destino si el grupo de destino se define como grupo de destino de origen en la asignación del grupo de destino.
Cuando se utiliza un tipo de grupo de destino REMOTE_FILE_SYSTEM, se cumplen las siguientes afirmaciones:
  • Si la ruta definida en <mounted_file_system> es la misma entre varios servidores de medios, la ruta implica que el servidor de medios es un montaje NFS en el que todos los servidores de medios pueden acceder a los datos escritos en el mismo <mounted_file_system>.
  • Si uno de los servidores de medios está sin conexión durante un comando de restauración, análisis de lectura o consulta de ID de copia de seguridad, DSA reemplazará automáticamente el servidor de medios con uno que pueda acceder al mismo sistema de archivos montado.
Cuando se utiliza un tipo de grupo de destino TARGET_DDBOOST, se cumplen las siguientes afirmaciones:
  • Si los valores de <target_entity> y <storage_units> son los mismos entre varios servidores de medios, los valores implican que estos servidores de medios pueden acceder a los datos escritos en los mismos <target_entity> y <storage_units>.
  • Si uno de los servidores de medios está sin conexión durante un comando de restauración, análisis o consulta de ID de copia de seguridad, DSA reemplazará automáticamente el servidor de medios con uno que pueda acceder a las mismas unidades de almacenamiento y la misma entidad de destino.

Para poder configurar un tipo diferente de grupo de destino, el servidor de medios debe tener instalado el módulo de AXM correspondiente. Utilice list_access_module para comprobar qué módulos de AXM están instalados.

El nombre del componente solo puede utilizar los siguientes caracteres: 'A-Z', 'a-z', '0-9' y '_'.

Ejemplo de archivo XML: grupo de destino de medios remotos (NetBackup)

A continuación se ofrece un archivo XML de muestra que permite configurar un grupo de destino de medios remotos (TARGET_NBU).
<?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>

Ejemplo de archivo XML: grupo de destino del sistema de archivos remoto

A continuación se muestra un archivo XML de ejemplo para configurar un grupo de destino del sistema de archivo remoto (REMOTE_FILE_SYSTEM).
<?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>

Ejemplo de archivo XML: grupo de destino de DD Boost

A continuación se muestra un archivo XML de ejemplo para configurar un grupo de destino de DD Boost (TARGET_DDBOOST).
<?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>

Ejemplo de archivo XML: grupo de destino de Amazon S3

A continuación se muestra un archivo XML de ejemplo para configurar un grupo de destino de S3 (TARGET_S3).
<?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>

Ejemplo de archivo XML: grupo de destino de Azure Blob

A continuación se muestra un ejemplo de archivo XML para configurar un grupo de destino de Azure Blob (TARGET_AZURE).

<?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>

Ejemplo de archivo XML: grupo de destino almacenamiento de GCP

A continuación se muestra un ejemplo de archivo XML para configurar un grupo de destino de GCP Storage (TARGET_GCP).

<?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>